CataMines - CataMines

CataMines 是一款专为管理矿场而设计的插件，尤其适合空岛挖矿（SkyMining）和监狱（Prison）服务器。它提供了丰富的功能，并拥有直观的图形界面（GUI），旨在提供高效且独特的矿场管理体验。

💡重要提示

• 你需要安装最新版本的 WorldEdit 或 FastAsyncWorldEdit 插件才能正常使用。
• 插件支持 PlaceholderAPI，可提供丰富的占位符。
• 统计页面：https://bstats.org/plugin/bukkit/CataMines/12889
• 支持与反馈 Discord：https://discord.gg/ZhqkSX23YH

🎮核心功能

• 图形界面管理：通过 GUI 轻松管理所有矿场。
• 自定义战利品表：为每个矿场配置独特的掉落物。
• 效率与精准采集：可配置挖掘矿场方块所需的效率等级，并支持时运（Fortune）附魔。
• 极速重置：利用 FastAsyncWorldEdit 实现闪电般的矿场重置速度。
• 灵活的创建与管理：
• 创建/删除矿场。
• 设置/移除矿场内的方块（按百分比）。
• 重命名矿场。
• 移动矿场到新的选区。
• 多种重置模式：
• 按时间自动重置。
• 按被挖掘的百分比自动重置。
• 手动立即重置。
• 设置替换模式（仅替换空气方块）。
• 玩家传送与提示：
• 将玩家传送到矿场顶部或指定位置。
• 设置矿场传送点。
• 重置时传送玩家。
• 重置前警告玩家（可全局或仅限附近玩家）。
• 在玩家快捷栏（ActionBar）显示剩余时间或剩余方块数量。
• 高度自定义：
• 完全自定义警告消息和重置消息。
• 自定义重置前多少秒进行警告。
• 自定义接收警告的玩家距离。
• 便捷操作：
• 完整的指令补全（Tab Complete）支持。
• 启动/停止单个矿场或所有矿场任务。
• 重新加载插件配置。

🔧指令列表

主指令为 /catamines 或 /cm。

基础管理

• /cm create <mine>
• 创建一个矿场。你需要先用 WorldEdit 做出一个选区。
• /cm gui (mine)
• 打开矿场管理 GUI。不指定矿场名则列出所有矿场。
• /cm delete <mine>
• 删除指定矿场。
• /cm list
• 列出所有已注册的矿场。
• /cm info <mine>
• 显示指定矿场的详细信息。
• /cm reload (mines|config|messages|properties)
• 重载插件配置文件。

方块与重置设置

• /cm set <mine> <block> (percentage)%
• 向矿场添加一种方块，并可设置其生成百分比。
• 示例：/cm set Stone_Mine stone 65%
• /cm unset <mine> (block)
• 移除矿场中所有方块或指定的方块。
• 示例：/cm unset Stone_Mine stone
• /cm setdelay <mine> <seconds>
• 设置矿场的自动重置间隔（秒）。
• /cm reset <mine>
• 手动重置指定矿场。
• /cm redefine <mine>
• 根据新的 WorldEdit 选区重新定义矿场区域。

传送与状态控制

• /cm tp <mine> (player)
• 将自己或指定玩家传送到矿场。
• /cm settp <mine>
• 设置矿场的传送点（站在目标位置执行）。
• /cm setresettp <mine>
• 设置矿场重置时玩家的传送点。
• /cm start <mine> / /cm stop <mine>
• 启动或停止指定矿场。
• /cm starttasks / /cm stoptasks
• 启动或停止所有矿场的自动重置任务。

高级标志设置

使用 /cm flag <mine> 查看所有可用标志指令。

• /cm flag <mine> replacemode <true/false>
• 为 true 时，重置矿场将只替换空气方块。
• /cm flag <mine> moveRegion
• 将矿场移动到你的新 WorldEdit 选区。
• /cm flag <mine> rename <name>
• 重命名矿场。
• /cm flag <mine> teleportplayers <true/false>
• 设置重置时是否将玩家传送到矿场顶部。
• /cm flag <mine> teleportplayerstoresetlocation <true/false>
• 设置重置时是否将玩家传送到通过 /cm setresettp 指定的位置。
• /cm flag <mine> warn <true/false>
• 是否在重置前警告玩家。
• /cm flag <mine> warnglobal <true/false>
• 警告是否全局发送（所有在线玩家）。
• /cm flag <mine> warnhotbar <true/false>
• 是否在玩家快捷栏显示剩余时间/方块。
• /cm flag <mine> warnhotbarmessage <message>
• 设置快捷栏显示的消息（不支持多行）。
• /cm flag <mine> warnmessage <message>
• 设置警告消息。使用 /n 换行，支持颜色代码。
• 可用占位符：%cm%（插件前缀），%mine%（矿场名），%seconds%（剩余秒数），%time%（时间单位）。
• /cm flag <mine> resetmessage <message>
• 设置重置时发送的消息。
• /cm flag <mine> warnseconds <n1 n2 n3...>
• 设置在重置前多少秒进行警告。
• 示例：/cm flag Stone_Mine warnseconds 10 5 3 1
• 设置为 -1 则只在重置时通知。
• /cm flag <mine> warndistance <number>
• 设置当非全局警告时，玩家接收警告的最大距离。

✨权限节点

拥有 catamines.* 或 OP 权限即可使用所有功能。以下是具体权限：

• catamines.help - 查看帮助。
• catamines.list - 列出矿场。
• catamines.create - 创建矿场。
• catamines.gui - 打开 GUI（此权限也涉及修改多项矿场属性）。
• catamines.delete - 删除矿场。
• catamines.redefine - 重定义矿场区域。
• catamines.set - 设置矿场方块。
• catamines.unset - 移除矿场方块。
• catamines.setdelay - 设置重置延迟。
• catamines.info - 查看矿场信息。
• catamines.flag - 使用标志指令。
• catamines.reset - 重置矿场。
• catamines.reset.<mine> - 重置指定矿场。
• catamines.teleport - 传送到矿场。
• catamines.teleport.<mine> - 传送到指定矿场。
• catamines.setteleport - 设置矿场传送点。
• catamines.start / catamines.stop - 启动/停止矿场。
• catamines.starttasks / catamines.stoptasks - 启动/停止所有矿场任务。
• catamines.reload - 重载插件配置。

❓PlaceholderAPI 占位符

• %catamines_prefix% - 插件前缀。
• %catamines_countdown_<mine>% - 矿场重置倒计时（格式：分:秒）。
• %catamines_remainingseconds_<mine>% - 剩余秒数。
• %catamines_totalblocks_<mine>% - 矿场总方块数。
• %catamines_minedblocks_<mine>% - 已被挖掘的方块数。
• %catamines_remainingblocks_<mine>% - 剩余方块数。
• %catamines_remainingblockspercentage_<mine>% - 剩余方块百分比。
• %catamines_resetpercentage_<mine>% - 触发重置的百分比阈值。

⭐使用预览

执行 /cm gui 将打开一个列出所有矿场的菜单。点击任一矿场或执行 /cm gui <mine> 可打开该矿场的详细管理界面。

在管理界面中，你可以修改矿场的各项属性。例如，点击左上角的石头方块可以编辑矿场的方块构成。在那里，你可以：

• 查看所有已配置的方块及其生成概率。
• 左击一个方块来调整其生成概率（使用绿色/红色羊毛按钮增减）。
• 界面顶部或悬停提示会显示当前概率及所有方块概率的总和。
• 界面右上角的发射器和投掷器图标提供了更多高级操作选项。

通过这个直观的 GUI，你可以轻松驾驭插件的所有强大功能。