RTN的经济学库

RTN的经济学库

服务端经济库，包含击杀生物奖励、击杀连击、排行榜和开发者API。适用于Minecraft模组的Vault风格经济系统。

RTN的经济学库预览查看大图

💰 RTN EcoLib — 通过击杀生物赚钱的经济模组

RTN EcoLib 是一个为 NeoForge 1.21.1 设计的"一体化"经济模组与库——它是 Bukkit/Spigot 插件（如 Vault 和 XConomy）的精神续作，内置了"击杀生物获得金钱"（Money From Mobs）系统。请在客户端和服务器端都安装它；所有数据仅存储在服务器端。

⚔️ 从生物身上赚钱

击杀生物——即可获得报酬！开箱即用，支持任何模组添加的生物和 Boss，无需实体列表：

🐄 被动生物（牛、羊、鸡...）— 1 ®
💀 敌对生物（苦力怕、骷髅、僵尸...）— 5 ®
🐉 Boss（末影龙、凋灵、模组Boss）— 100 ®

Boss 检测是自动的：任何具有高生命值的生物都被视为 Boss，因此来自其他模组的 Boss 也能获得正确的报酬。你还可以在配置文件中微调所有内容：

entityOverrides — 为任何实体设定精确价格: "minecraft:ender_dragon=500", "cataclysm:ignis=300"
bossEntities — 强制将任何模组实体视为 Boss

🔥 连击系统

快速击杀生物以成倍增加你的收入！

第一次击杀后，5秒计时器启动
在时间内击杀下一个生物——你的连击增长：x1 → x2 → x3
收入乘以当前连击数
超时未击杀——连击重置
所有信息都会实时在行动栏中精美显示：+10 ® | 连击 x2 | 本次累计: 35 ®

📊 统计与排行

命令 描述
/mfm info 个人统计：击杀生物数量，总赚取金额
/mfm top 前10名猎人（缓存每小时重建）
/baltop 最富有的前10名玩家

统计信息在服务器重启后依然保留。

🎮 命令

命令 描述
/balance, /bal, /money 你的余额
/baltop, /moneytop, /balancetop 最富有的前10名玩家
/pay <玩家> <金额> 向玩家发送金钱

管理员命令（权限等级3）：

命令 描述
/balance <玩家> 查看某人的余额
/balset <玩家> <金额> 设置余额
/balgive <玩家> <金额> 给予金钱（负数为扣除）
/balreload 重载配置 + 强制保存 + 重建排行
/mfm multiplier add <倍率> <秒数> 临时全局收入倍率，例如 add 2.0 60 使所有收入翻倍1分钟（会向所有玩家公告！）
/mfm multiplier remove 将倍率重置为 x1.0
/баланс, /бал, /балтоп, /баланстоп 俄语命令别名

🔐 安全的服务器端存储

余额以加密形式（AES-256-GCM）存储在服务器的 rtnecolib/ 文件夹中
加密密钥在首次启动时自动生成
定期异步保存（默认：每5分钟）— 无服务器卡顿
原子写入 + 自动 .bak 备份

⚙️ 配置

所有内容都可以在 config/rtnecolib-common.toml 中配置：货币符号（默认 ®）、起始余额、奖励、Boss生命值阈值、连击窗口与最大值、保存间隔、排行重建间隔等。

🧩 面向开发者的公共 API

RTN EcoLib 被设计为一个库：将其添加为 compileOnly 依赖，并使用简洁的、Vault 风格的 API：

Java

RTNEconomyAPI eco = RTNEconomyProvider.get();
eco.deposit(playerUuid, 100.0, "quest reward");
eco.withdraw(playerUuid, 50.0, "shop purchase");
eco.transfer(from, to, 25.0, "trade");
eco.setGlobalMultiplier(2.0, 300); // x2 活动持续 5 分钟

为其他模组提供 API 总线上的事件：

BalanceChangeEvent — 审计、修改或取消任何交易
MobRewardEvent — 为你自己的生物设置自定义奖励 / Boss标记

是商店、任务、职业、拍卖行以及任何金钱驱动模组的完美基础。

  • 依赖项：无（完全独立的模组）
  • 运行端：客户端 + 服务器端（数据保存于服务器和客户端）
  • RTN 项目网站：点击。

我的生态系统中的模组：