PrisonRanksX - 无限进阶监狱等级核心

PrisonRanksX 是一款专注于为服主提供全方位自定义能力的等级晋升插件。它允许用户通过多种方式实现想要的效果，在满足高度定制化需求的同时，也兼顾了服务器性能，确保插件不会对服务器运行产生负面影响。

💡基本信息

• 支持版本: 1.5 至 1.20
• 源码: GitHub
• Wiki: WIKI
• Discord: https://discord.gg/qzkJaMU
• 捐赠: https://www.paypal.me/sandwicha
• 开发状态: 插件正在重写中

🎮核心特性

• 无需重启服务器，在游戏内即可创建和编辑等级、转生与轮回。
• 几乎所有内容均可配置。
• 支持 PlaceholderAPI 和 MVdWPlaceholderAPI，可在插件消息中使用其他插件的变量，或为其他插件提供变量。
• 可选 MySQL 数据库存储玩家数据，支持跨服数据同步。
• 支持 Vault，可在玩家数据更新时异步添加或删除权限。
• 直接支持 LuckPerms、PermissionsEX 和 GroupManager，可通过其 API 管理玩家权限（此为可选功能）。
• 在 1.16+ 版本中支持 RGB 颜色（需游戏本身支持）。
• 提供大量占位符以满足不同需求。
• 可为每个晋升阶段设置自定义的占位符要求，使升级不仅限于金钱。
• 一个 JAR 文件兼容所有版本，只需下载最新版。
• 支持多页的聊天文本列表（等级、转生、轮回），格式会根据玩家所处阶段（已完成、当前、其他）变化；也支持自定义列表。
• 支持多页 GUI 列表，设置与文本列表基本相同。
• 支持无限转生。
• 提供转生、等级、轮回及综合排行榜。
• 运行高效（尽可能缓存、异步任务处理）。
• 提供丰富的开发者 API。
• 完全开源。

亮点功能

• 动态动作栏（带动画效果）
• 快速最大转生 + 无限转生
• 支持无限页面的 GUI 等级列表
• 完全可自定义的升级烟花与全息图
• 排行榜（可分别显示等级、转生、轮回或综合）
• 完全可自定义（或可禁用）的动作栏升级进度条
• RGB 颜色支持
• 易于使用的开发者 API

🔧配置文件概览

主要配置文件包括 config.yml、infinite_prestige.yml 和 ranks.yml，它们定义了插件的核心行为。

config.yml 要点

• 符号替换: 在插件消息中使用如 [>>]、[<3]、[correct] 等符号会被替换为特定图标。
• 禁用世界: 在 worlds 列表中添加的世界将禁用所有晋升功能及相关命令。
• 关键设置:

- `defaultrank`: 默认等级

- `lastrank`: 最终等级

- `firstprestige`: 初始转生

- `lastprestige`: 最终转生

- `firstrebirth`: 初始轮回

- `lastrebirth`: 最终轮回

• 功能开关: 可独立启用或禁用等级、转生、轮回系统。
• 聊天显示: 可强制在聊天格式中显示等级、转生、轮回前缀。
• 列表格式: 可配置文本或 GUI 列表，支持分页。
• 音效: 可为晋升、转生、轮回设置自定义音效。
• 自动化: 支持自动晋升、自动保存数据。
• 进度显示: 可配置动作栏和经验条进度显示。
• MySQL 支持: 可选启用，用于网络数据同步。
• 全息图: 需配合 HolographicDisplays 或 DecentHolograms 使用，可在晋升时显示。
• 晋升后重置选项: 可配置在转生或轮回时重置金钱、等级等。

infinite_prestige.yml

启用无限转生后，将使用此文件配置。

• 全局设置: 定义显示格式、花费计算公式、命令和最终转生上限。
• 特定转生设置: 可在特定转生数（如第500次）执行自定义命令或广播。
• 连续转生设置: 可设置每达到一定转生次数（如每500次）触发的动作。
• 恒定转生设置: 可为一定范围内的转生永久更改显示格式。

ranks.yml

用于定义等级路径及每个等级的具体设置。

• 等级结构: 在 Ranks 下定义，例如 A、B。
• 等级属性: 每个等级可设置 display（显示名）、nextrank（下一级）、cost（花费）。
• 执行动作: 升级时可执行命令（以控制台或玩家身份）、发送广播、私信消息、显示动作栏文本。
• 自定义要求: 通过 requirements 可使用占位符设置非金钱的升级条件。
• 权限管理: 通过 addpermission 和 delpermission 管理玩家权限，支持分世界设置。

❓占位符列表

插件提供了大量占位符，可通过 PlaceholderAPI 或 MVdWPlaceholderAPI 调用。

PlaceholderAPI 占位符

等级相关

• %prisonranksx_currentrank_name% - 当前等级名称（无颜色）
• %prisonranksx_currentrank_displayname% - 当前等级显示名（有颜色）
• %prisonranksx_rankup_percentage% - 升级进度百分比（整数）
• %prisonranksx_rankup_progress% - 进度条
• %prisonranksx_rankup_name% - 下一等级名称
• %prisonranksx_rankup_cost% - 下一等级花费
• %prisonranksx_rank_displayname_<rank>% - 指定等级的显示名（区分大小写）

转生相关

• %prisonranksx_prestige_name% - 当前转生名称
• %prisonranksx_prestige_displayname% - 当前转生显示名
• %prisonranksx_nextprestige_name% - 下一转生名称
• %prisonranksx_nextprestige_cost% - 下一转生花费
• %prisonranksx_has_prestiged% - 是否已转生（true/false）

轮回相关

• %prisonranksx_rebirth_name% - 当前轮回名称
• %prisonranksx_rebirth_displayname% - 当前轮回显示名
• %prisonranksx_nextrebirth_name% - 下一轮回名称
• %prisonranksx_nextrebirth_cost% - 下一轮回花费

排行榜相关

• %prisonranksx_name_rank_<number>% - 等级排行榜第 X 名的玩家名
• %prisonranksx_value_rank_<number>% - 等级排行榜第 X 名的值
• 同类占位符也适用于 prestige、rebirth 和综合 stage 排行榜。

全局相关

• %prisonranksx_money% - 格式化后的金钱
• %prisonranksx_next_percentage% - 下一阶段（等级/转生/轮回）进度百分比
• %prisonranksx_next_progress% - 下一阶段进度条

MVdWPlaceholderAPI 占位符

格式为花括号 {}，提供的变量与 PlaceholderAPI 类似，涵盖等级、转生、轮回和全局信息，例如：

• {prisonranksx_currentrank_name}
• {prisonranksx_prestige_displayname}
• {prisonranksx_money}

聊天插件变量

在聊天格式中可直接使用

• {rank} - 显示等级前缀
• {prestige} - 显示转生前缀
• {rebirth} - 显示轮回前缀

✨依赖与兼容

• 必需:

- Vault

- 经济插件（如 Essentials、PhantomEconomy、IConomy、Ultimate_Economy 或 XConomy）

• 可选（强烈推荐）:

- PlaceholderAPI

• 可选:

- HolographicDisplays 或 Decent Holograms（用于生成全息图）

- HolographicExtension 或 Holographic Placeholders（在全息图中使用本插件变量）

- MVdWPlaceholderAPI

- ActionUtil（用于执行更多动作类型）

⭐开发者 API

插件提供了广泛且易于使用的 API，供开发者进行二次开发或深度集成。插件完全开源，您可以自由修改源码。

🔧支持与致谢

如需帮助，请加入 Discord 服务器或通过讨论区联系开发者。

**感谢以下赞助者**（由新到旧）

• Kobe Jensen - 50.0 USD
• Xentus - 2.55 USD
• Crafters-Island - 5 USD
• mbjorn - 7.50 EUR