跳到正文

Simple Credit

简单的点数系统,适用于服务器商店、经济和交易。

收藏

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

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 的其他作品

查看全部 →