Prison - 监狱服务器插件

💡Prison 全方位开源监狱插件

Prison 是一款功能全面的开源监狱插件，支持 Spigot 1.8 至 1.20.6+ 以及 Java 1.8 至 21+。最新版本 v3.3.0-alpha.18 已完全支持 Spigot 1.20.6 和 Paper 1.20.6。

🎮核心功能

等级与声望

• 等级系统：玩家可购买等级晋升。
• 声望系统：在等级之上提供更长期的进阶目标。
• 多阶梯系统：支持多个独立的等级阶梯，例如默认的声望阶梯或捐赠者阶梯。
• 等级指令：可在玩家升级时运行指令，用于授予新权限或触发特效。
• 聊天标签：借助 EssentialsX-Chat 等插件，可在聊天中显示等级标签。
• 管理操作：管理员可执行 promote、demote 或 set rank 操作，并可选择是否收费或退款。
• 自定义货币：通过 GemsEconomy 插件支持使用自定义货币购买等级。

矿场系统

• 自定义矿场：创建供玩家采集资源的矿场。
• 自动重置：矿场可在设定时间后自动重置。
• 交互式编辑：动态调整矿场的方块组成、移动和调整大小，甚至修复周围地形。
• 安全传送：在矿场重置时将玩家传送至安全位置。
• 重置控制：可设置重置条件，如无人采矿时跳过重置，或达到特定开采百分比阈值时重置。
• 重置分页：支持大型矿场的分页重置，避免服务器卡顿。
• 矿场指令：可在矿场重置前后运行特定指令，与其他插件联动。
• 传送支持：玩家可使用指令传送至有权限进入的矿场。
• 多世界支持：与 Multiverse-core 配合良好。

自动化功能

Prison 包含四大自动化模块，均支持通过配置和游戏内 GUI (/gui) 进行自定义。

• 自动拾取 (AutoPickup)：自动拾取在矿场内挖掘的方块，支持幸运、耐久度和经验计算。
• 自动熔炼 (AutoSmelt)：自动将背包中的矿石熔炼为锭（如铁矿石熔炼为铁锭）。
• 自动合成块 (AutoBlock)：自动将材料合成为方块（如 9 个铁锭合成为铁块）。
• 自动出售 (AutoSell)：当背包满时自动出售物品。玩家可使用 /sellall auto toggle 开关此功能。

出售系统 (SellAll)

• 一键出售：允许玩家出售背包内所有可售物品换取金钱，价值越高，收益越多。
• 收益倍增器：支持基于权限或声望等级的出售收益倍增器。
• 与 AutoSell 联动：AutoSell 是自动化功能的一部分，仅在 Prison 矿场内工作；而 SellAll 本身可在矿场外使用。
• GUI 与配置：支持游戏内 GUI、指令和配置文件编辑。

其他特色功能

• 方块事件 (BlockEvents)：当玩家在矿场内破坏方块时，可触发指令，支持百分比几率、权限关联、与 TokenEnchant 爆炸事件联动等。
• 方块约束 (Block Constraints)：精确控制矿场内方块的生成数量（最小/最大值）以及生成层位。
• GUI 菜单：为大多数玩家和管理员功能提供图形界面，包括等级、矿场、声望、出售、管理、玩家等。
• 自定义方块：通过 Custom Items 插件支持在矿场中使用自定义方块。
• 数据统计：追踪玩家挖掘的所有方块类型。
• Hex 颜色代码：全面支持 Hex 颜色代码，其占位符甚至能让不支持 Hex 颜色的插件间接使用这些颜色。
• 自动配置：使用 /ranks autoConfigure 可快速自动配置等级、虚拟矿场、方块分配、矿场内衬及基础权限指令。

🔧指令概览

Prison 拥有大量指令。主指令 /prison 会显示所有根指令及其别名。在任意指令后添加 help 关键词可查看详细描述、参数、权限和别名。

主要指令分类

• 核心与信息：

- `/prison`

- `/prison placeholders`

- `/prison version`

- `/prison debug`

- `/prison support`

• 矿场管理：

- `/mines`

- `/mines wand` (选区工具)

- `/mines block` (管理方块)

- `/mines info`

- `/mines list`

- `/mines set` (包含 15 个子指令)

- `/mines tp`

• 等级与声望：

- `/ranks`

- `/ranks autoConfigure`

- `/rankup`

- `/rankupmax`

- `/prestige`

- `/prestiges`

• 出售系统：

- `/sellall`

- `/sellall list`

- `/sellall gui`

- `/sellall sell`

• GUI 菜单：

- `/gui`

- `/gui mines`

- `/gui ranks`

- `/gui prestiges`

- `/gui backpack`

• 背包系统 (当前版本不推荐使用，等待重写)：

- `/backpack`

- `/backpack list`

- `/backpack delete`

✨占位符系统

Prison 提供了约 300 个占位符（包括别名），可将玩家、矿场和等级的数据传递给其他插件。

占位符类型

• 等级占位符：与玩家相关的数据，如当前等级、声望、升级成本、升级进度百分比、玩家统计等。
• 矿场占位符：与矿场相关的数据，如重置时间、剩余方块、剩余百分比、矿场内玩家数量等。
• 玩家-矿场占位符：混合型占位符，报告玩家当前所在矿场的具体信息。
• 出售倍增器占位符：报告玩家总出售收益倍增器数值（包括基于权限的加成）。

占位符功能

• 动态格式化：通过占位符属性，可动态调整数字格式、单位（公制、二进制、标准）、进度条样式及 Hex 颜色转换。
• 指令查询：使用 /prison placeholders list 可列出所有占位符，并支持搜索和实时值显示。
• 外部集成：占位符可通过 PlaceholderAPI (PAPI) 或 MVdWPlaceholderAPI 使用。最新占位符列表建议使用游戏内指令查询。

❓依赖与兼容性

Prison 本身没有硬性依赖，但等级模块需要 Prison 内注册一种货币才能运行。

强烈推荐

• Vault：用于连接支持 Vault 的经济和权限插件。
• 经济插件：例如 EssentialsX，用于提供经济系统。

支持与兼容的插件

• 权限与管理：LuckPerms, WorldGuard (配合权限插件可保护矿场区域)
• 聊天与显示：EssentialsXChat (设置聊天前缀), HolographicDisplays (需 HolographicExtension 来使用 Prison 占位符)
• 经济与货币：GemsEconomy (用于替代货币)
• 附魔与特效：TokenEnchant (完全支持其爆炸附魔), Crazy Enchantments (支持 BlastUse 事件)
• 物品与方块：Custom Items (支持在矿场中使用自定义方块), Tokens (可通过 BlockEvents 在挖矿时给予玩家代币)
• 多世界与背包：Multiverse-core, MinesBackPacks (与自动拾取和 SellAll 配合使用)
• 记分板：Scoreboards

⭐为什么选择 Prison？

• 模块化：可按需启用或禁用特定功能。
• 完全开源：代码 100% 开放，开发者可根据需要自定义修改。
• 永久免费：所有代码、资源和二进制文件均免费提供，无隐藏付费内容。
• 积极维护：重视错误修复，发现问题可在 Discord 快速获得支持。
• 持续发展：不断添加新功能、优化性能，并欢迎社区贡献代码、功能请求、错误报告、翻译和文档。
• 透明更新：每个版本都包含大量新功能和修复，并提供详细的更新日志。

🔧资源与链接

• Discord 服务器：快速获取帮助及访问 Alpha 测试版本。
• 指南与文档：GitHub 上的目录。

- 设置矿场

- 设置等级

- SellAll 指南

• 问题反馈：首选 Discord，也可通过 GitHub Issues 提交。
• 源代码：GitHub 仓库
• 官方网站
• 官方 YouTube 频道

关于数据统计：本插件会向 bStats 发送匿名统计信息，以帮助我们更好地决定支持方向。您可以在 config.yml 中将 send-metrics 设置为 false 来退出。可在此处查看统计信息。

💡安装与配置

首次安装 Prison 插件后，建议在开始任何自定义设置前，先执行以下命令：

/ranks autoConfigure

此命令将自动配置插件的大部分基础功能，为你提供一个更完整的环境，以便后续进行个性化调整。

如需了解更详细的配置与自定义方法，请参阅我们在 GitHub 上的完整文档。