BagOfGold - 金币袋经济系统

BagOfGold 为 Minecraft 服务器带来了一种全新的、基于物品的经济维度。金钱以实物形式存在于玩家物品栏中，你可以亲眼看到、拾取或丢弃你的货币。它兼容 Essentials、CraftConomy 或 iConomy 等主流经济系统，并能与商店、传送、金钱奖励等需要经济插件的其他插件完美协作。

💡重要须知

• 依赖插件：BagOfGold 4.5.0+ 版本必须依赖 CustomItemsLib。
• 风险警告：由于金钱是物品，你可能会像丢失装备一样，在死亡时丢失所有金钱。建议将钱存入受保护的箱子或 BagOfGold 银行中。
• 版本选择：
• Minecraft 1.17 及以上版本：请使用最新版 (需要 Java 17)。
• Minecraft 1.16.5 及更旧版本：请使用 BagOfGold 3.0.7 (需要 Java 8)。

🎮核心功能

银行系统

你可以将 BagOfGold 存入银行以保护你的财产。

银行告示牌

创建方法如下（牌子上文字可于 config.yml 中自定义）：

• 第一行：[bagofgold bank]
• 第二行：Deposit（存款）/ Withdraw（取款）/ Balance（查询余额）
• 第三行：Everything（全部）/ 具体数字 / 留空

相关权限

• bagofgold.banksign.create - 创建银行告示牌
• bagofgold.banksign.destroy - 销毁银行告示牌
• bagofgold.banksign.use - 使用银行告示牌

银行经理 NPC

你可以创建或移除一个银行经理（需 Citizens2 NPC 插件）。

命令

• /bagofgold banker create - 创建银行经理
• /bagofgold banker remove - 移除银行经理

NPC 的皮肤和名称可在 config.yml 文件的 Banker 部分进行配置。

Shopkeepers 集成

从 4.5.2 版本开始支持 Shopkeepers 插件，允许使用 BagOfGold 货币买卖物品。此功能目前处于 BETA 测试阶段。

注意

• 可能也兼容其他使用商人界面的 GUI 商店插件。
• 安装 4.5.2+ 版本后，需在 config.yml 中手动启用此集成功能（默认关闭）。
• 如发现漏洞，请在 GitHub 提交工单并详细描述复现步骤。

✨依赖与推荐插件

必需依赖

• CustomItemsLib

经济接口依赖（二选一）

• Vault
• Reserve

强烈推荐

• ProtocolLib - 强烈建议安装。

可选（按需安装）

• PerWorldInventory - 当玩家切换世界或游戏模式时需要。
• Citizens2 - 如需使用银行经理 NPC 功能。

🔧命令列表

基础管理命令

• /bagofgold reload - 重载配置文件
• /bagofgold update - 检查并更新插件
• /bagofgold version - 显示插件版本
• /bagofgold debug - 启用/禁用调试模式

货币操作命令

你可以使用 /bagofgold、/money 或 /bag 作为命令前缀。

玩家命令

• /bagofgold bag pay <playername> <amount> - 向玩家付款
• /bagofgold bag balance - 查看自己余额
• /bagofgold bag balance <playername> - 查看他人余额
• /bagofgold bag bankbalance - 查看自己银行存款
• /bagofgold bag bankbalance <playername> - 查看他人银行存款
• /bagofgold bag top - 显示财富榜前 54 名玩家

管理员命令

• /bagofgold bag give <playername> <amount> - 给予玩家金钱
• /bagofgold bag give * <amount> - 给予所有在线玩家金钱
• /bagofgold bag take <playername> <amount> - 收取玩家金钱
• /bagofgold bag drop <amount> - 掉落金钱
• /bagofgold bank balance - 查看银行总余额
• /bagofgold bank take - 从银行收取
• /bagofgold bank give - 向银行存入

与 Essentials 协同

若已安装 Essentials，你还可以使用其经济命令：

• /eco <give|take|set|reset> <player> <amount>

⭐PlaceholderAPI 支持

BagOfGold 提供以下占位符

• %bagofgold_balance% - 玩家现金余额
• %bagofgold_bank_balance% - 玩家银行存款余额
• %bagofgold_ping% - 玩家延迟

❓更新与权限

自动更新

插件每 2 小时检查一次更新。拥有 bagofgold.update 权限的玩家和管理员会在游戏内和后台收到通知。你可以在 config.yml 中设置自动更新或完全禁用更新。

权限列表

• bagofgold.reload
• bagofgold.update
• bagofgold.version
• bagofgold.debug
• bagofgold.money.pay
• bagofgold.money.drop
• bagofgold.money.take
• bagofgold.money.give
• bagofgold.money.give.*
• bagofgold.money.balance
• bagofgold.money.balance.others
• bagofgold.money.bankbalance
• bagofgold.money.bankbalance.others
• bagofgold.bank.take
• bagofgold.bank.give
• bagofgold.bank.balance

🔧其他信息

bStats 统计

本插件使用 bStats 收集匿名数据并发送至 mcstats.org，包括：

• 唯一标识符
• Java 版本、服务器在线/离线模式
• 插件版本、服务器核心版本
• 操作系统信息、CPU 核心数
• 在线玩家数、Metrics 版本

注意：你可以在配置中禁用 bStats，但这将导致插件启动延迟 20 秒。

问题与开发

• 提交漏洞：如发现漏洞，请创建 工单。
• 源代码：可在 GitHub 查看。
• 开发版本：如需测试最新开发版，可在此处获取 开发构建。