介绍
Simple Credits
一款适用于 NeoForge 1.21.1 的简易服务端货币系统:每位玩家都有积分余额,服务器商店的回购价格会随供需变化,玩家之间也可以互相转账。所有功能都集中在一个窗口中,按 B 即可打开。
AI 使用说明:本模组由 AI 制作。所有代码、语言文件和游戏内窗口绘制均由 Anthropic 的 AI 模型 Claude 编写。人类设计师规划了功能、做出了所有设计决策,并会在游戏中测试每个版本。
功能
余额
- 每位玩家都有一个以积分计的余额。只使用整数,不含小数。
- 积分不是物品。你无法将积分取出,因此它们不会被复制、丢弃或偷走。
- 余额储存在世界存档中,因此离线玩家也能保留自己的余额。
服务器商店:出售 / 回购
- 服务器所有者可以列出商店收购的物品(钻石、金锭、微风棒等)。每种物品都有一个基础价格。
- 商店初始没有库存。库存只来自玩家出售的物品,因此只能回购其他玩家实际卖出的物品。
- 价格 = 基础价格 × 2^(1 − 库存 / 基础库存),价格始终保持在×0.5 到 ×2之间。基础库存仅用于定价:它会根据玩家每天出售该物品数量的移动平均值变化,因此价格会根据物品在你服务器上的实际常见程度进行调整。
- 出售物品会增加库存、降低价格。任何人都可以按当前价格加上10% 手续费,从库存中回购物品;这会让价格回升。
- 库存会随时间逐渐消耗(默认情况下,服务器每运行一个游戏日,库存就会减半)。库存不会自动补充。
- 物品可以标记为仅可出售(例如没人需要回购的鱼)。
- 只接受普通物品:不能是改过名、附魔或受损的物品。
- 取整规则始终不会让玩家占便宜:出售时向下取整,购买时向上取整,因此拆分交易或先卖出再回购都无法凭空赚钱。
服务器商店:购买
- 固定价格、库存无限的物品,例如经验修补附魔书。可使用与
/give相同的物品格式,上架附魔或自定义物品。
转账
- 可以向任何曾加入过服务器的玩家发送积分,即使对方处于离线状态也可以。
- 玩家名称自动补全(在线玩家优先),提供 100 / 1,000 / 全部快捷按钮,并在发送前设置确认步骤。
- 在线收款者会立即收到聊天消息。离线收款者下次登录时会收到汇总信息(总额以及每位发送者的转账次数)。
- 可查看近期收到和发出的转账记录(屏幕上显示 10 条;默认每位玩家保存 20 条)。
- 可以在配置中设置可选转账手续费(按百分比计算并向上取整)。默认值为 0%。
界面
- 一个窗口,三个标签页:出售 / 回购、购买、转账。余额始终可见。
- 可以按名称搜索物品列表。附魔书会显示其附魔名称(“经验修补”“锋利 V,耐久 III”),而不只是显示“附魔书”。
- 点击列标题即可排序:名称、出售价格或持有数量(购买标签页可按名称或价格排序)。再次点击即可反向排序。交易时行的位置不会变,因此连续点击也不会误卖错误的物品。
- 可以拖动滚动条。
- 窗口打开时,价格和库存会实时更新。如果你查看之后价格发生了变化,服务器会拒绝交易并显示新价格,而不会按你没看到的价格扣款。
- 高于或低于基础价格的价格,以及发出或收到的转账,都会用符号和颜色标示。
- 包含英语和韩语。
服务器所有者指南
安装
- 需要在服务器和客户端两端都安装。
- Minecraft 1.21.1,NeoForge 21.1.264 或更高版本。没有其他依赖项。
- 文件:
simplecredits-0.2.0.jar。内部模组 ID 为credits,因此配置文件、存档文件和命令都会使用该名称。
商店清单:config/credits/shop.json
首次启动时会创建一份包含占位内容的清单。编辑该文件以设置自己的物品和价格:
{
"sell": [ {"item": "minecraft:diamond", "basePrice": 100, "baseStock": 64},
{"item": "minecraft:cod", "basePrice": 6, "baseStock": 16, "buyable": false} ],
"buy": [ {"key": "mending", "item": {"id": "minecraft:enchanted_book", "count": 1,
"components": {"minecraft:stored_enchantments": {"levels": {"minecraft:mending": 1}}}}, "price": 500} ]
}
baseStock仅用于设定初始基础库存;之后基础库存会根据每日销量调整。"buyable": false用于将物品设为仅售出。未列入清单的物品无法交易。无效行会被跳过,并在日志中显示警告。编辑后使用 /credits reload。
设置:config/credits-server.toml
初始余额(0)、回购手续费(10%)、价格下限和上限(×0.5 / ×2)、库存减半周期(1 天)、每笔交易的最大物品数量(2,304)、基础库存设置(天数长度、平均速度、销量与基础库存的换算系数、下限和上限)、/credits stats中显示的热门物品数量(5)、转账手续费(0%)、历史记录数量(20)。文件中对每个选项都有说明。所有时间只在服务器运行时计数。
命令
所有玩家:
/credits balance:显示自己的余额
管理员(权限等级 2):
/credits balance <player>/credits give | take | set <player> <amount>/credits stock <item> <amount>/credits basestock <item> <value>:设置某种物品的基础库存/credits stats:查看今日经济数据(商店发放和回收的信用点、回购手续费收入、货币总量、转账和热门物品)/credits price <item>、/credits sell <count>、/credits buyback <item> <count>、/credits buy <key> <count>:通过命令行进行商店交易,用于测试/credits reload:重新加载shop.json
玩家无需使用其他命令;所有操作都可以在窗口中完成。
日志记录
每次余额变动都会向服务器日志写入一条 [credits] 记录:包括玩家、金额、原因和变动后的余额。
经济记录
- 总账:每笔出售、回购、购买、转账和管理员调整都会作为一行 JSON 追加到
<world>/credits/ledger/<date>.jsonl。 - 每日汇总:每天会在
<world>/credits/daily/<date>.jsonl中写入一行 JSON,记录每种物品的出售量、回购量、库存消耗量、期末库存、基础库存和平均价格,以及服务器汇总数据:商店发放和回收的信用点、回购手续费收入、货币总量、转账和管理员调整(与商店数据分开统计)。 - 文件不会自动删除。
注意事项
- 窗口中的韩文使用游戏默认字体绘制。想要像素风格的韩文字形,可以搭配韩文字体位图模组使用。
- 默认商店清单仅供示例;请根据你的服务器进行平衡调整。
- 从 0.1.0 升级:首次启动 0.2.0 时,所有可出售物品的库存会重置为 0(现在库存初始为空,只能通过玩家出售物品增加)。余额会保留。库存减半周期设置已更名为
burnHalfLifeMinutes,现在默认值为一天。
常见问题
Simple Credit 支持哪些 Minecraft 版本?
Simple Credit 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。
Simple Credit 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
user_ulh6ktxq1aylo76n 的其他作品
查看全部 →Sundae Combat
原汁原味的 Minecraft 战斗,只是额外加了点料。
Galmuri Hangul
修改 Minecraft 的韩文字体,并改善韩语输入和操作
Spellstats
用于个人服务器。为 ISS 等内容提供 RPG 系统。(仍在开发中)
Spellstats enchanting (WIP)
为武器、弓、护甲和法杖添加最高 +10 的青金石强化。Spellstats 的附属模组。
评论
登录后评论和评分