[经济]BeanPoints —— 豆点经济,游戏内虚拟货币[2.1]

英文名称: BeanPoints

中文名称: 豆点经济

来源: 原创

API类型: TerrariaServerAPI

插件类型

经济
API

语言支持

简体中文

适用版本

前置Mod/插件: TShockAPI

原帖地址: https://www.bbstr.net/t/beanpoints-2-1.592/

开源地址: https://gitee.com/Crafty/bean-points

API版本: 2.1

BeanPointsV2.0
豆点经济

1.简介

这款插件的诞生，是因为我当初想写一个RPG系统而诞生的，现在我想把它写成更像API，以后有开发者想要开发经济类的插件都可以使用这个插件作为前置，这将给你省下很多时间，提高生产力。最新更新的2.0版本也添加了许多实用性功能，方便腐竹对服务器进行功能性的制作

2.新版本特性[Features]
可自定义的货币名称游戏内货币与虚拟货币转换配置文件高度自定义支持怪物自定义给予钱币可关闭怪物掉落物品货币怪物掉落钱币按伤害比进行分配使用数据库进行存储数据.支持跨服添加钱币变动侧边栏

3.权限与指令[Commands&Permissions]

玩家指令[对应权限:eco.user]	简介
/eco help	查看使用帮助
/eco me	查看个人余额
/eco pay [玩家ID] [数额]	向指定玩家支付钱币
/eco ex	将物品货币转存为虚拟货币
/eco aq [数额]	将虚拟货币转存为物品货币

管理员指令[对应权限:eco.admin]	简介
/ecoadmin help	查看使用帮助
/ecoadmin take [玩家ID] [数额]	扣除玩家指定数额钱币
/ecoadmin give [玩家ID] [数额]	给予玩家指定数额钱币
/ecoadmin addvalue [怪物ID] [数额]	指定击杀此怪物后获得多少钱币
/ecoadmin reload	重载配置文件

4.配置文件介绍[Config]
JSON： { "CurrencyName": "游戏币", //货币名称 "DropRate": 2, //掉落值,越高每个怪物掉落得越少,反之(只有AutoMobValue项为true可用) "AutoMobValue": true, //怪物掉落随机数额钱币，设置为false即使用mobvalues.json里的值 "EnableMonstersDrop": false, //允许怪物掉落物品货币,默认不开启,不然玩家刷钱后果自负 "AllowCoinsExchange": true, //允许物品货币和虚拟货币互转 "DisableChangeBoard": false, //是否显示钱币变动侧面板,设置为true为关闭 "ShowAboveHead": true, //是否在玩家头上显示获得的钱币 "CoinValue": { //以下是物品货币对应的虚拟货币值分别为铜币银币金币铂金币（只允许该数字,钱币的名称不能随便修改） "Copper": 100, "Silver": 200, "Gold": 300, "Platinum": 400 } } 另外在生成的配置文件中，还有个叫mobvalus.json的文件，那个是你在游戏中使用addvalue命令时存放的怪物钱币值，可自行去里边修改，并reload 注意:根据游戏里的机制，1个银币可以换100个铜币，所以配置物品货币的价值时记得考虑到这一点，防止玩家恶意刷钱。插件里默认设置的值仅供参考，千万不要一装上插件就开放给玩家。记得修改好配置文件

4.配置文件介绍[Config]

JSON：

{
"CurrencyName": "游戏币", //货币名称
"DropRate": 2, //掉落值,越高每个怪物掉落得越少,反之(只有AutoMobValue项为true可用)
"AutoMobValue": true, //怪物掉落随机数额钱币，设置为false即使用mobvalues.json里的值
"EnableMonstersDrop": false, //允许怪物掉落物品货币,默认不开启,不然玩家刷钱后果自负
"AllowCoinsExchange": true, //允许物品货币和虚拟货币互转
"DisableChangeBoard": false, //是否显示钱币变动侧面板,设置为true为关闭
"ShowAboveHead": true, //是否在玩家头上显示获得的钱币
"CoinValue": { //以下是物品货币对应的虚拟货币值 分别为铜币 银币 金币 铂金币（只允许该数字,钱币的名称不能随便修改）
"Copper": 100,
"Silver": 200,
"Gold": 300,
"Platinum": 400
}
}

另外在生成的配置文件中，还有个叫mobvalus.json的文件，那个是你在游戏中使用addvalue命令时存放的怪物钱币值，可自行去里边修改，并reload

注意:根据游戏里的机制，1个银币可以换100个铜币，所以配置物品货币的价值时记得考虑到这一点，防止玩家恶意刷钱。插件里默认设置的值仅供参考，千万不要一装上插件就开放给玩家。记得修改好配置文件

5.开发者相关[Develop]

开发者可以使用本插件作为前置插件，下面给你们介绍下封装的一些方法

BeanPlayer类	简介
AddPoints(int count)	给该对象添加指定数额的货币
DecreasePoints(int count)	给该对象扣除指定数额的货币
ResetPoints()	重置该对象的Points属性为0
ResetPoints(int count)	重置该对象的Points属性为count
GetBeanPlayer(string name)	从数据库中拉取BeanPlayer对象
SendInfoMessage(string msg)	给该对象发送信息
SendMessage(string msg,Color color)	给该对象发送信息(带颜色)
SendSuccessMessage(string msg)	给该对象发送成功信息
SendErrorMessage(string msg)	给该对象发送错误信息
PriceIntoCoins(int aimcount)	将aimcount虚拟货币转换为物品货币
ShowChangeInfo(ChangeType type,int count)	展示钱币变动信息

6.图片时间
击杀史莱姆王效果开启头部显示后虚拟货币转换物品货币物品货币转换虚拟货币咋感觉猪猪存钱罐和钱币槽瞬间就没价值惹QAQ 顺带一提，打boss默认掉落boss袋(开袋可获得物品货币)，所以打完的boss掉落的虚拟钱币为0，去文件设特值也没效果，后期想个好点的解决方案吧

7.尾言
非常感谢各位使用此插件，开发不易，欢迎投币。有什么BUG大家尽管说另外，这个怪物随机掉落钱币算法可能会有点菜，如果有这方面的大佬。欢迎来指导指导