XfeaturesRPGMoney

# 💰 XfeaturesRPGMoney        ## 📝 描述 **XfeaturesRPGMoney** 是一个用于 Minecraft 服务器的创新型经济插件，它为服务器经济增加了 RPG 元素。该插件为玩家提供了多种赚取游戏内货币的方式： - 💀 **狩猎怪物**: 通过杀死各种生物赚取金钱 - 🎣 **钓鱼**: 通过钓到不同类型的鱼赚取金钱 - ⛏️ **挖方块**: 挖到某些方块时有机会赚取金钱 - 🔍 **考古**: 通过挖掘考古宝藏获得奖励 该插件与 Vault API 完全集成，确保与大多数经济系统兼容。 ## ✨ 主要特性 - **灵活的奖励系统**: 可以自定义每个收入来源的最小和最大金额 - **幸运和战利品倍数**: 财富 (Fortune) 和掠夺 (Looting) 附魔会增加获得的奖励 - **玩家统计**: 追踪赚取的金钱并创建最佳玩家的排名 - **视觉效果**: 游戏世界中金币的动画呈现 - **完整的消息自定义**: 所有通知都可以在配置文件中更改 - **易于管理**: 为玩家和管理员提供直观的命令 ## 📋 要求 - Spigot/Paper 1.13+ - Vault - 与 Vault 兼容的任何经济插件 (例如，EssentialsX, CMI) ## 🔧 安装 1. 从 [Releases](https://github.com/XfeaturesGroup/XfeaturesRPGMoney/releases) 部分下载插件的最新版本 2. 将 JAR 文件放在服务器的 `plugins` 文件夹中 3. 重启服务器 4. 按照您的需要配置配置文件 5. 使用命令 `/rpgmoney reload` 重新加载插件

## 🌍 支持的语言

XfeaturesRPGMoney 支持多种语言，方便来自世界各地的用户。您可以使用命令 `/rpgmoney language <语言>` 更改插件语言。 ### 可用的语言： - 英语 (en) - 俄语 (ru) - 德语 (de) - 波兰语 (pl) - 意大利语 (it) - 葡萄牙语 (pt) - 土耳其语 (tr) - 法语 (fr) - 西班牙语 (es) - 立陶宛语 (lt) - 拉脱维亚语 (lv) - 爱沙尼亚语 (et) - 阿拉伯语 (ar) - 印地语 (hi) - 简体中文 (cn) ### 添加新的语言 如果您想添加新的语言或改进现有的翻译： 1. 从 `resources/messages/` 文件夹复制 `messages-en.yml` 文件 2. 将其重命名为 `messages-XX.yml`，其中 XX 是您的语言代码 3. 将所有字符串翻译成您的语言 4. 通过 Pull Request 或联系开发者提交翻译 我们始终欢迎新的翻译和对现有翻译的改进！

## ⚙️ 配置文件

首次启动后，插件将创建以下配置文件： ### config.yml 基本插件设置，包括附魔的倍数: ```yaml # 所有可用的语言都可以在这里找到： # https://github.com/XfeaturesGroup/XfeaturesRPGMoney/tree/master/examples/messages # 插件的语言设置 language: "en" # 怪物生成器生成的生物的货币掉落率 spawner-multiplier: 0.6 # 主插件设置 drop-chance: 0.75 # 挖方块和杀死怪物时金币掉落的概率 show-action-bar-messages: true # 在操作栏中拾取金币时显示消息 player-death-drop-percentage: 0.07 # 被杀玩家的货币掉落率 max-money-drop: 1000.0 # 单个金币中最大金额 # 组合附近掉落的设置 combine-nearby-drops: true combine-radius: 1.5 # 关于倍数的消息 show-fortune-multiplier-messages: false show-looting-multiplier-messages: false # “财富”附魔的倍数 fortune-multipliers: 1: 1.25 # 财富 I - 增加金币掉落率 25% 2: 1.5 # 财富 II - 增加金币掉落率 50% 3: 1.75 # 财富 III - 增加金币掉落率 75% # “掠夺”附魔的倍数 looting-multipliers: 1: 1.25 # 掠夺 I - 增加金币掉落率 25% 2: 1.5 # 掠夺 II - 增加金币掉落率 50% 3: 1.75 # 掠夺 III - 增加金币掉落率 75% ``` ### mobs.yml 设置杀死怪物奖励: ```yaml # ENTITY: [min, max] ALLAY: [5, 30] ARMADILLO: [4, 12] AXOLOTL: [5, 30] BAT: [5, 30] BEE: [5, 30] BLAZE: [5, 25] BREEZE: [15, 30] BOGGED: [10, 20] CAMEL: [4, 12] CAT: [5, 30] CAVE_SPIDER: [2.5, 20] CHICKEN: [4, 12] COPPER_GOLEM: [15, 30] COD: [4, 12] COW: [4, 12] CREEPER: [10, 15] DOLPHIN: [4, 22] DONKEY: [4, 12] DROWNED: [10, 20] ELDER_GUARDIAN: [50, 125] ENDER_DRAGON: [100, 250] ENDERMAN: [3, 20] ENDERMITE: [10, 20] EVOKER: [50, 100] FOX: [4, 12] FROG: [5, 12] GHAST: [20, 35] GLOW_SQUID: [4, 20] GOAT: [4, 20] GUARDIAN: [10, 25] HOGLIN: [10, 25] HORSE: [4, 12] HUSK: [5, 15] IRON_GOLEM: [25, 40] LLAMA: [4, 12] MAGMA_CUBE: [2, 7] MOOSHROOM: [4, 14] MULE: [4, 12] OCELOT: [4, 12] PANDA: [4, 12] PARROT: [4, 12] PHANTOM: [15, 20] PIG: [4, 12] PIGLIN: [4, 15] PIGLIN_BRUTE: [4, 15] PILLAGER: [7, 15] POLAR_BEAR: [4, 12] PUFFERFISH: [4, 12] RABBIT: [4, 20] RAVAGER: [50, 70] SALMON: [4, 20] SHEEP: [4, 20] SHULKER: [10, 20] SILVERFISH: [10, 20] SKELETON: [10, 15] SKELETON_HORSE: [10, 15] SLIME: [4, 6] SNIFFER: [10, 25] SNOW_GOLEM: [10, 15] SPIDER: [10, 15] SQUID: [4, 12] STRAY: [10, 15] STRIDER: [10, 25] TADPOLE: [10, 25] TRADER_LLAMA: [10, 25] TROPICAL_FISH: [10, 15] TURTLE: [10, 15] VEX: [10, 25] VILLAGER: [10, 55] VINDICATOR: [10, 25] WANDERING_TRADER: [10, 25] WARDEN: [10, 55] WITCH: [10, 25] WITHER: [10, 55] WITHER_SKELETON: [10, 25] WOLF: [4, 12] ZOGLIN: [10, 25] ZOMBIE: [10, 15] ZOMBIE_HORSE: [10, 15] ZOMBIE_VILLAGER: [10, 15] ZOMBIFIED_PIGLIN: [5, 12] ``` ### fishes.yml 设置钓鱼奖励: ```yaml # LOOT: [min, max] COD: [10, 30] SALMON: [10, 30] PUFFERFISH: [15, 25] TROPICAL_FISH: [10, 25] ENCHANTED_BOOK: [25, 45] LEATHER: [15, 35] TRIPWIRE_HOOK: [15, 35] ROTTEN_FLESH: [15, 35] FISHING_ROD: [15, 35] NAME_TAG: [15, 55] NAUTILUS_SHELL: [55, 200] SADDLE: [15, 35] ``` ### blocks.yml 设置方块挖掘奖励: ```yaml # BLOCK: [min, max] CROPS: [3.5, 21] WHEAT: [3.5, 21] POTATOES: [3.5, 8.75] CARROTS: [3.5, 8.75] BEETROOTS: [7, 42] NETHER_WART: [5.25, 35] MELON: [8.75, 52.5] PUMPKIN: [8.75, 52.5] CACTUS: [1.75, 8.75] SUGAR_CANE: [1.75, 35] GLOW_BERRIES: [1.75, 35] SWEET_BERRIES: [1.75, 35] COCOA_BEANS: [1.75, 35] COAL_ORE: [5.25, 10.5] DEEPSLATE_COAL_ORE: [8.75, 26.25] IRON_ORE: [8.75, 17.5] DEEPSLATE_IRON_ORE: [14, 35] COPPER_ORE: [12.25, 22.75] DEEPSLATE_COPPER_ORE: [8.75, 21] GOLD_ORE: [17.5, 21] DEEPSLATE_GOLD_ORE: [17.5, 35] NETHER_GOLD_ORE: [8.75, 14] REDSTONE_ORE: [8.75, 21] DEEPSLATE_REDSTONE_ORE: [8.75, 22.75] LAPIS_ORE: [8.75, 14] DEEPSLATE_LAPIS_ORE: [8.75, 22.75] DIAMOND_ORE: [17.5, 70] DEEPSLATE_DIAMOND_ORE: [70, 140] EMERALD_ORE: [52.5, 105] DEEPSLATE_EMERALD_ORE: [52.5, 105] NETHER_QUARTZ_ORE: [8.75, 14] ANCIENT_DEBRIS: [87.5, 262.5] ``` ### archeology.yml 设置考古奖励: ```yaml # DROP: [min, max] BROWN_CANDLE: [25, 40] GREEN_CANDLE: [25, 40] PURPLE_CANDLE: [25, 40] RED_CANDLE: [25, 40] LIGHT_BLUE_DYE: [15, 35] ORANGE_DYE: [15, 35] BLUE_DYE: [15, 35] YELLOW_DYE: [15, 35] WHITE_DYE: [15, 35] BRICK: [10, 15] EMERALD: [50, 75] WHEAT: [20, 30] WOODEN_HOE: [15, 20] BLUE_STAINED_GLASS_PANE: [20, 35] LIGHT_BLUE_STAINED_GLASS_PANE: [20, 35] MAGENTA_STAINED_GLASS_PANE: [20, 35] PINK_STAINED_GLASS_PANE: [20, 35] PURPLE_STAINED_GLASS_PANE: [20, 35] RED_STAINED_GLASS_PANE: [20, 35] YELLOW_STAINED_GLASS_PANE: [20, 35] BEETROOT_SEEDS: [25, 30] WHEAT_SEEDS: [25, 30] OAK_HANGING_SIGN: [25, 30] SPRUCE_HANGING_SIGN: [25, 30] DEAD_BUSH: [30, 35] FLOWER_POT: [15, 30] LEAD: [15, 30] STRING: [15, 30] GOLD_NUGGET: [35, 45] COAL: [30, 35] MUSIC_DISC_RELIC: [150, 175] TRIM_PATTERN: [100, 125] ``` ### messages.yml 配置所有插件消息: ```yaml prefix: "&c[XfeaturesRPGMoney]&r" # 命令消息 no-permission: "&c您没有使用此命令的权限。" player-only: "&c此命令仅限玩家使用。" config-reloaded: "&a配置已成功重新加载。" invalid-page-format: "&c无效的页码格式。请使用数字。" no-data-for-page: "&c此页没有数据。" # 统计信息消息 stats-header: "&7===== &c您的统计信息 &7=====" stats-collected: "&e已收集的金钱: &6%amount%" # 排行榜消息 top-header: "&7===== &c玩家排行榜 (第 %page% 页) &7=====" top-player-entry: "&7#%rank% &c%player% &7- &7%amount% 金钱" top-next-page: "&7使用 &c/rpgmoney top %page% &7 查看下一页" # 插件信息消息 info-header: "&7===== &c插件信息 &7=====" info-version: "&c版本: &7%version%" info-author: "&c作者: &7%authors%" info-fortune-header: "&c财富倍数:" info-fortune-entry: "&c等级 %level%: &7+%percent% 金钱" info-looting-header: "&c掠夺倍数:" info-looting-entry: "&c等级 %level%: &7+%percent% 金钱" # 帮助消息 help-header: "&7===== &cXfeaturesRPGMoney 帮助 &7=====" help-reload: "&c/rpgmoney reload &7- 重新加载配置" help-stats: "&c/rpgmoney stats &7- 显示您的统计信息" help-top: "&c/rpgmoney top [页码] &7- 显示玩家排行榜" help-info: "&c/rpgmoney info &7- 插件信息" help-language: "&c/rpgmoney language <语言> &7- 更改插件语言" # 货币收集消息 currency-name: 金钱 pickup: "&e您拾取了 %amount% 金钱!" currency-pickup: "&e您拾取了 %amount% 金钱!" money-item-name: "&e%amount% 金钱" money-drop: "&e您掉落了 %amount% 金钱!" fishing-reward: "&e您钓鱼获得了 %amount% 金钱!" mining-reward: "&e您挖矿获得了 %amount% 金钱!" entity-kill-reward: "&e您通过杀死生物获得了 %amount% 金钱!" player-kill-reward: "&e您通过杀死玩家获得了 %amount% 金钱!" player-death-drop: "&c您因死亡损失了 %amount% 金钱!" currency-format: "%amount% 金钱" currency-singular: 金钱 currency-plural: 金钱 # 语言消息 language-usage: "&c用法: /rpgmoney language <语言>" language-not-found: "&c未找到语言 %language%。" language-changed: "&a语言已更改为 %language%。" ```

## 📜 命令 | 命令 | 描述 | 权限 | |---|---|---| | `/rpgmoney reload` | 重新加载配置 | `xfeatures.rpgmoney.reload` | | `/rpgmoney stats` | 显示您的统计信息 | - | | `/rpgmoney top [page]` | 显示顶尖玩家 | `xfeatures.rpgmoney.top` | | `/rpgmoney info` | 插件信息 | - | | `/rpgmoney language ` | 更改插件语言 | `xfeatures.rpgmoney.language` | ## 🔒 权限 - xfeatures.rpgmoney.reload - 访问重新加载命令 - xfeatures.rpgmoney.top - 访问查看顶尖玩家 - xfeatures.rpgmoney.admin - 访问所有插件功能 - xfeatures.rpgmoney.language - 访问更改插件语言 ## 🛠️ 开发者 API 该插件提供 API 以便与其他插件集成: ```java // 获取插件实例 XfeaturesRPGMoney plugin = (XfeaturesRPGMoney) Bukkit.getPluginManager().getPlugin("XfeaturesRPGMoney"); // 使用怪物配置 MobConfig mobConfig = plugin.mobConfig; List zombieReward = mobConfig.getReward("zombie"); double min = zombieReward.get(0); double max = zombieReward.get(1); // 使用插件 API RPGMoneyAPI api = plugin.getAPI(); // 获取范围内的随机值 double amount = api.getRandomInRange(10.0, 20.0); // 在世界中掉落金钱 api.dropMoney(location, amount); // 检查方块是否由玩家放置 boolean isPlayerPlaced = api.isPlayerPlacedBlock(location); ``` ## 📊 性能 ### 该插件经过优化，对服务器性能的影响最小： - 异步数据保存 - 优化的奖励计算算法 - 最小的内存使用 ## 📝 未来计划 - ✅ 添加更精细的配置 **(已实现)** - ✅ 支持更多语言 **(已实现)** - 集成 PlaceholderAPI - 管理设置的图形界面 - 添加考古、研究、创作的奖励 ## 🤝 为项目做出贡献 ### 欢迎做出贡献！如果您对改进插件有任何想法： 1. 叉取仓库 2. 为您的功能创建一个分支 (git checkout -b feature/amazing-feature) 3. 提交您的更改 (git commit -m ‘Add some amazing feature’) 4. 将更改推送到您的叉子 (git push origin feature/amazing-feature) 5. 打开一个拉取请求 ## 📊 统计 ### 该插件通过 bStats 收集匿名统计信息以改进功能： 您可以在 [bStats](https://bstats.org/plugin/bukkit/XfeaturesRPGMoney/26636) 页面上查看插件统计信息。   ### 收集的数据： - 经济体内的金钱总额 - 有金钱记录的玩家数量 - 在操作栏中使用消息 - 使用财富和掠夺倍数 - 玩家和服务器数量 - 在线模式状态 - 服务器、插件和 Java 版本 ### 禁用统计 如果您想禁用统计信息收集，可以在 `plugins/bStats/config.yml` 文件中通过将 `enabled: false` 禁用它。禁用统计不会影响插件的功能。 ## 📞 支持 ### 如果您遇到任何问题或有任何疑问： - 在存储库中创建一个问题 - 通过 [Discord](https://discord.gg/KJU4DjGkeH) 联系我们   

Made with ❤️ by the XfeaturesGroup team