FreeRPG - 自由角色扮演插件

FreeRPG 是一款适用于 Spigot 1.15+ 服务器的插件，它为 Minecraft 添加了一套 RPG 技能系统。其灵感来源于 McMMO，旨在提供一个免费的 McMMO 替代方案。每个技能都拥有独立的技能树，并额外设有一个全局技能树。玩家可以通过一个受 Hypixel 启发的极简 GUI 界面（使用 /fRPG 打开）来访问这些技能树。

💡快速开始

安装插件

• 将 freerpg-{version}.jar 文件放入服务器的 plugins 文件夹即可。

玩家入门

• 输入 /frpg 打开技能主界面。点击任意图标即可进入对应技能的技能树。将鼠标悬停或点击图标可以查看技能详情。
• 获取经验的方式非常直观：挖掘获得挖掘经验，砍树获得伐木经验，依此类推。

代币与技能系统

• 被动代币：默认配置下，每升 1 级可获得 1 个，用于投资左侧染料所代表的被动技能。
• 技能代币：每 100 级可获得 1 个，用于投资陶瓦所代表的技能树。
• 全局代币：每 1000 级可获得 1 个，用于投资全局技能树。

激活技能

大多数技能需要右键点击对应工具，然后破坏方块或进行特定操作来激活。以下是 10 项主动技能：

• 大挖掘：右键点击铲子后破坏方块。大幅提升挖掘速度。
• 伐木工：右键点击斧头后砍伐原木。连锁破坏上方的所有原木。
• 狂暴镐：右键点击镐后破坏方块。大幅提升采矿速度。
• 自然再生：右键点击锄头后破坏作物。自动重新种植所有作物，并随机赋予生长阶段。
• 超级诱饵：左键点击鱼竿后钓鱼。无需等待鱼上钩，立即将鱼拉出水面。
• 快速射击：左键点击弓。无论拉弓多久，箭矢都会以最快速度射出。
• 马刺踢：骑乘时右键点击大多数物品，然后左键点击。为你的马匹提供临时速度加成。
• 迅捷打击：右键点击剑后攻击实体。你的攻击将不再有冷却时间。
• 坚如磐石：空手右键后攻击实体。获得抗性提升效果，但自身速度会减慢。
• 巨斧：右键点击斧头后攻击实体。你的攻击变为范围伤害，对一定半径内的敌人造成伤害。

✨玩家特色功能

• 直观的经验获取系统
• 3 种不同类型的代币，分别用于投资各技能树
• “伐木工”连锁砍树能力
• 完全重做的钓鱼系统，包含许多新掉落物
• 抓钩技能
• 新的药水配方（如急迫、抗性提升）
• 扩展的树叶掉落表
• 生物蛋的自定义合成配方
• 无需龙息即可合成 tipped arrows（药箭）的自定义配方
• 查看马匹状态的能力
• 更多详细信息请查阅信息页面

🔧管理员特色功能

• 控制经验曲线
• 完全控制经验掉落
• 调整玩家代币获取
• 修改掉落物品及其概率
• 为获取经验、使用技能和每条命令设置权限
• 设置等级上限
• 控制自定义配方的输入与输出
• 控制自定义药水的效果、持续时间、成分和颜色
• 更多功能即将推出...

🎮配置、权限与语言

配置文件

• config.yml
• languages.yml
• advancedConfig.yml

权限节点概览

• freeRPG.*：授予所有 FreeRPG 命令的访问权限（默认 OP）。
• freeRPG.standardPlayer：授予玩家所有推荐权限（默认 true），包括打开 GUI、获取经验、使用技能等。
• freeRPG.GUI：授予所有 GUI 命令的访问权限（默认 true）。
• freeRPG.changeStats：授予所有状态更改命令的访问权限（默认 OP），如给予经验、设置等级等。
• freeRPG.getEXP：允许玩家获取所有类型的经验（默认 true）。
• freeRPG.useAbilities：允许玩家使用所有技能能力（默认 true）。

每个具体技能的经验获取（如 freeRPG.miningEXP）和能力使用（如 freeRPG.miningAbility）权限默认均为 true。管理员可通过修改权限控制玩家的具体能力。

⭐命令列表

GUI 命令

• /frpg 或 /frpg skills - 打开技能主 GUI
• /frpg globalGUI - 手动打开全局技能树 GUI
• /frpg skillTreeGUI [skillName] - 手动打开指定技能的技能树 GUI
• /frpg configurationGUI - 手动打开配置 GUI
• /frpg skillConfigGUI [skillName] - 手动打开指定技能的配置 GUI

经验/等级命令

• /frpg expGive [playerName] [skillName] [amount] - 给予玩家指定技能的经验
• /frpg setLevel [playerName] [skillName] [newLevel] - 设置玩家指定技能的等级
• /frpg statReset [playerName] [skillName] - 重置玩家的指定技能（不返还代币和经验）
• /frpg setSouls [playerName] [amount] - 设置玩家的灵魂数量
• /frpg setTokens [playerName] [skillName] [skill/passive] [amount] 或 /frpg setTokens [playerName] global [amount] - 设置玩家在特定技能或全局的代币数量
• /frpg saveStats [playerName] 或 /frpg saveStats - 保存单个或所有玩家的状态到文件，并更新排行榜
• /frpg setMultiplier [playerName] [multiplier] - 设置玩家的个人经验倍率（与其他倍率叠加）
• /frpg addMultiplier [playerName] [decimal] - 增减玩家的个人经验倍率（与其他倍率叠加）

开关命令

• /frpg flintToggle - 手动开关“燧石发现者”技能
• /frpg speedToggle - 手动开关“优雅步伐”技能
• /frpg potionToggle - 手动开关“药水大师”技能
• /frpg flamePickToggle - 手动开关“火焰镐”技能
• /frpg grappleToggle - 手动开关“抓钩”技能
• /frpg hotRodToggle - 手动开关“热力鱼竿”技能
• /frpg veinMinerToggle - 手动开关“连锁采矿”技能
• /frpg megaDigToggle - 手动开关“超级挖掘”技能
• /frpg leafBlowerToggle - 手动开关“吹叶机”技能
• /frpg holyAxeToggle - 手动开关“神圣斧”技能

其他命令

• /frpg statLeaders [skillName] [page #] - 显示指定技能的玩家等级排行榜
• /frpg enchantItem [level] - 尝试为手中物品附魔指定等级
• /frpg help [page #] - 在游戏中显示所有命令信息
• /frpg info - 向玩家发送包含详细技能和机制说明的谷歌文档链接
• /frpg resetCooldown [playerName] [skillName] - 将玩家指定技能的冷却时间重置为 0 秒
• /frpg statLookup [playerName] - 显示被查询玩家的所有技能等级和服务器排名

❓PlaceholderAPI 占位符

玩家数据占位符

• %FreeRPG_globalLevel% - 全局等级
• %FreeRPG_globalTokens% - 全局代币
• %FreeRPG_personalMultiplier% - 个人经验倍率
• %FreeRPG_totalSkillTokens% - 总技能代币
• %FreeRPG_totalPassiveTokens% - 总被动代币
• %FreeRPG_souls% - 灵魂数量
• %FreeRPG_totalEXP% - 总经验值
• %FreeRPG_playTime% - 游戏时间
• %FreeRPG_globalLevelRank% - 全局等级排名
• %FreeRPG_playTimeRank% - 游戏时间排名

技能相关占位符

• %FreeRPG_<skillName>_Level% - 指定技能等级
• %FreeRPG_<skillName>_EXP% - 指定技能经验
• %FreeRPG_<skillName>_passiveTokens% - 指定技能的被动代币
• %FreeRPG_<skillName>_skillTokens% - 指定技能的技能代币
• %FreeRPG_<skillName>_Multiplier% - 指定技能的经验倍率
• %FreeRPG_<skillName>_EXPtoNext% - 指定技能距离下一级所需经验
• %FreeRPG_<skillName>_rank% - 指定技能的排名

排行榜占位符

• %FreeRPG_leaderboard_<leaderboardName>_<rank #>_UUID% - 排行榜指定排名玩家的 UUID
• %FreeRPG_leaderboard_<leaderboardName>_<rank #>_playerName% - 排行榜指定排名玩家的名称
• %FreeRPG_leaderboard_<leaderboardName>_<rank #>_sortedStat% - 排行榜排序依据的统计值
• %FreeRPG_leaderboard_<skillName>_<rank #>_exp% - 指定技能排行榜的经验值（便捷格式）
• %FreeRPG_leaderboard_<skillName>_<rank #>_level% - 指定技能排行榜的等级（便捷格式）
• %FreeRPG_leaderboard_global_<rank #>_totalLevel% - 全局总等级排行榜
• %FreeRPG_leaderboard_global_<rank #>_totalEXP% - 全局总经验排行榜
• %FreeRPG_leaderboard_playTime_<rank #>_totalTimePlayed% - 游戏时间排行榜

**说明**

• <leaderboardName> 可以是任何技能名称（如 beastMastery）、PlayTime 或 global。
• 在大多数数字占位符末尾添加 _formatted（例如 %FreeRPG_..._formatted%）可以将数字格式化为带逗号的字符串（如 12,345）。

✨兼容性与语言支持

插件兼容性

FreeRPG 应与大多数流行插件兼容。已测试并确认无冲突的插件包括：

• Essentials / Bssentials
• WorldEdit / WorldGuard
• Silk Spawners
• PlaceholderAPI
• Multiverse（但暂不支持多世界独立玩家档案）

语言支持

FreeRPG 默认完全或部分支持以下语言

• 英语
• 匈牙利语（翻译：vERKE）
• 法语（翻译：Temuel）
• 德语（翻译：KlenerTeufel96 of FruitLab.gg）
• 波兰语（翻译：QuarVey）
• 西班牙语（翻译：PibeChileno）
• 俄语（翻译：Cr1stalz_, MoKotik, DevilPlay）
• 葡萄牙语（翻译：gbuueno）
• 捷克语（翻译：Pieck444, Fractvival）
• 韩语（翻译：Re_Oh）

**管理员须知**

• 服务器默认语言可在 config.yml 中设置。
• 每位玩家可以选择自己偏好的插件显示语言。
• 管理员可以在 languages.yml 中添加自定义语言。
• 如果您希望将自己的翻译硬编码到 languages.yml 中供所有人使用，请在 Discord 或 SpigotMC 网站上联系开发者。

🔧开源说明

FreeRPG 是一个开源项目。任何人都可以在 GitHub 项目页面上查看、使用或修改其（自述为编写不佳的）Java 代码，该项目遵循标准的 MIT 许可证。