铸币 - 核心经济模组

铸币 - 核心经济模组

Hytale服务器的经济插件。余额、/pay、纸币、银行和贷款、商店、拍卖行、交易、赌场和每日奖励整合在同一账本上,包含游戏内页面和VaultUnlocked提供程序。服务端。

图书馆

遇到问题或有想法,请加入我的 Discord https://discord.gg/mKgxyk6qvb

Coinage 将你服务器上的每一笔余额都记录在同一个账本中,并让其他模块建立在这个账本之上。玩家拥有一个钱包中心、每个模块的全屏页面、余额 HUD 以及 /pay。你则拥有商店、拍卖行、银行、赌场和奖励系统,它们都使用同一份资金,而且每一个都是可以单独关闭的模块。玩家无需安装客户端模组。

账本

账户涵盖玩家、金库、城镇或商店收银台。支持任意数量的货币,金额以整数单位保存,因此不会出现漂移,并记录谁转移了什么、为什么转移、通过哪个插件转移。每一笔转移都会先写入磁盘日志,因此即使崩溃也不会丢失数据。管理员可以查询并撤销任何交易,/coinage report 会按天显示货币供应量、金库以及资金流向。

包含的内容

  • 带大额支付确认的 /pay,可选税费、每日限额和冷却时间。
  • 纸币和硬币作为物品,供玩家携带和交易。每张纸币都有编号,因此重复的纸币只能支付一次。
  • 带等级和利息的服务器银行、玩家自主经营的银行、以储蓄为担保的贷款、信用评分和联名账户。
  • 带库存和可选需求定价的管理员商店、玩家商店目录、NPC 商人、/sell all。
  • 带挂牌、一口价拍卖、求购订单和邮箱的拍卖行。
  • 物品和硬币的面对面交易,任何变更都会重置“就绪”状态。
  • 掷硬币、骰子、老虎机、21 点、轮盘赌和彩票,赔率由你设定,并支持损失限额和自我排除。
  • 每日登录连续奖励、在线时长奖励,以及击杀、方块和投票奖励。

页面

每个页面都以相同的框架填满屏幕:金色标题、右上角的余额、左侧的标签页和右侧的详情栏。商店和拍卖行以磁贴形式展示物品,磁贴带有稀有度背景,并显示价格、数量、剩余时间,以及标记你自有挂牌、你持有的最高出价、物品最优价格或一小时内挂牌的标签。点击磁贴后,详情栏会显示库存、你携带的数量、带预设的数量或出价输入框,以及购买、出售、出价、一口价或下架按钮。排序和分类是搜索框旁边的下拉菜单,点击“列表”按钮可切回普通行视图。钱包是一个中心,包含余额和排名、净资产以及今日收支的磁贴,每个页面一张卡片,以及你最新交易的动态。每次点击都会在页面上的通知栏中给出反馈。

每个时间、限制和内置物品都是 Coinage.json 中的一个键,玩家看到的每句话都在 messages.json 中。/coinage config 可在游戏内更改设置,大多数在 /coinage reload 后生效。

命令

命令 作用
/wallet 钱包页面,每个模块都有一个按钮
/pay player amount 向某人付款,无论其是否在线
/baltop 最富有的玩家
/bank、/shop、/ah、/trade player、/casino、/daily 各模块的页面
/coinage give player amount 创建货币并支付给玩家
/coinage status 账户、流通中的货币、模块和链接

管理员命令需要 coinage.admin 权限。在你设置 permissions.required 之前,玩家命令对所有人开放。如果从 EconomyAPI 迁移,请运行一次 /coinage import economyapi,然后将其移除,因为两者都会注册 /balance 和 /pay。

与我的其他模组配合

全部为可选,Coinage 无需任何这些模组即可完整运行。Chronicle Stats 会为每位玩家增加一个金钱页面和金钱卡片。Dominion Factions 将钱包保存在 Coinage 中,并将阵营银行变为共享账户。Feats 可以将硬币作为成就奖励支付,并添加一个包含 24 个成就的 Coinage 标签页,Atlas 可以向玩家显示他们自己的钱包。配合 TrackerAPI,击杀和方块会支付奖励,赚取和花费的钱会成为带排行榜的统计数据。SocialBridge 通过同一账本将 /balance、/richlist、/pay 和 /daily 添加到 Discord,因此税费和限制仍然适用。RestAPI 在 /api/coinage 下提供余额、账户、账本和报告,通过 API 密钥进行的交易会在历史记录中显示该密钥的名称。Lullaby 不涉及金钱,两者互不影响。

Coinage 还注册为 VaultUnlocked 经济系统,因此任何基于 VaultUnlocked 构建的插件都使用同一账本,PlaceholderAPI 可以获取余额、排名、顶级玩家和银行储蓄作为占位符。/coinage status 会列出所有链接到 Coinage 的插件及其版本。执行 /plugin reload Ryvrook:Coinage 后,它们会自行恢复,每个只恢复一次。

Coinage、Dominion Factions、SocialBridge 和 RestAPI 尚未上架 CurseForge,那些链接是它们将来会有的页面。

插件作者可针对 Coinage-api-1.3.0.jar 编译,该文件会随 GitHub 发布版提供(在仓库公开之前,请在 Discord 上询问),并可获得每个模块的服务、可取消事件、每日报告和净资产。

限制

需要服务器 0.7.0 或更新版本以及 Java 25。Coinage 有大型测试套件,已在 VaultUnlocked、PlaceholderAPI 和 TrackerAPI 旁边以无头模式运行,页面也已在一个世界的客户端中打开过,但尚未在繁忙的服务器上运行。NPC 商人和加入时的邮箱投递是我最不确定的部分。如果有任何异常,请在 Discord 上告诉我。

链接