MineMe - 我的矿场插件

简介

MineMe 是一款功能强大的自动矿场重置插件，它打破了传统矿场只能为90°方形的限制，支持创建圆形、多边形等多种形状的矿场。本插件提供了高度可定制化的功能，包括矿场构成、全息显示、消息提示等，并配有友好的图形化编辑界面，旨在为你提供最佳的自动化矿场管理体验。

💡重要通知

• MineMe 1.x 版本已停止维护，MineMe 2.0 正在开发中！MineMe 2.0 将是一个使用 Kotlin 和 Shiroi 框架完全重写的版本，并会带来更多新特性。
• 如果你遇到任何问题，请先查看 FAQ 和故障排除 部分。若问题仍未解决，请在论坛发帖或私信我。
• 如果你希望获得更频繁的更新，可以通过捐赠来支持我的开发工作。

🎮主要特性

以下是已实现并可供使用的功能

• 基础矿场功能：轻松修改矿石百分比、自动传送出矿、重置广播消息等。
• 可定制的全息显示：目前支持 HolographicDisplays，未来将支持更多。
• 完全可定制的消息：所有提示信息均可按需修改。
• 开发者友好的 API：方便其他开发者进行集成和扩展。
• 自定义 WorldEdit 矿场创建：选择长方体区域创建方形矿场，选择圆柱体区域创建圆形矿场。
• 新颖的矿场形状：利用 WorldEdit API 创建不同形状的矿场。当前可用形状：
• Cuboid（长方体）
• Circular（圆形）
• Polygonal（多边形）
• 矿场药水效果：玩家进入矿场时可获得特定效果。
• MineResetLite 转换：支持从 MineResetLite 迁移。
• 标签替换：可显示已破坏/剩余方块数、下次重置时间、矿场体积等统计信息。
• MVdWPlaceholderAPI 兼容：支持使用下方列出的占位符。
• 颜色调色板：通过修改预定义颜色（主色、副色、中性色、错误色）中的一个字母来改变整个聊天颜色设计。
• 版本兼容：兼容 1.9 和 1.8 版本（1.7 及以下版本未测试，但应该可以运行）。
• MineEditorGUI (MEGUI)：通过图形化菜单编辑矿场。

🔧安装步骤

• 下载 WorldEdit（如果尚未安装）。
• 下载 MineMe。
• 如需使用额外功能（全息/MVdW），请下载对应的 .jar 文件。
• 确保已安装 Java 1.8。注意：不能使用 Java 1.7 或 1.6。
• 将下载的 WorldEdit.jar、MineMe.jar 以及其他依赖的 .jar 文件放入服务器的 plugins 文件夹。
• 启动服务器，插件将自动生成配置文件。
• 输入指令 /mineme reload 重载配置。
• 完成！

✨依赖项

• WorldEdit：插件运行所必需。
• HolographicDisplays：仅在需要使用全息显示时需安装（强烈推荐）。
• MVdWPlaceholderAPI：用于与 MVdW 系列插件集成。

⭐权限

• mineme.admin：授予所有管理权限。

❓FAQ 与故障排除

Q：图标占位符报错 java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.(材料名)，但材料名是对的！

A：Bukkit 和 Minecraft 的材料名称不同。例如，Minecraft 中的 ENDER_EYE 在 Bukkit 中是 EYE_OF_ENDER。请使用 Bukkit Materials 名称列表。

Q：发现了一个 Bug！我该怎么办？

A：请在此处发帖报告，我会尽快修复。

Q：服务器启动时出现 java.lang.UnsupportedClassVersionError 错误。

A：请确保已安装 Java 1.8。不能使用 Java 1.7 或 1.6。

Q：如何使用某个功能？

A：请查看下方的 教程 部分，很可能有你要的答案。如果没有，请私信我或在论坛发帖，我会为此制作教程。

🔧教程

启用你的第一个矿场

• 安装插件并启动服务器以生成必要文件。
• 在 plugins/MineMe/mines/ 文件夹中，打开 examplemine.yml。
• 找到 enabled: false 并将其改为 enabled: true。
• 在游戏中输入 /mineme reload 重载配置，矿场即被启用。

使用全息显示

• 确保已安装 HolographicDisplays。
• 打开 config.yml，找到 holograms 部分。
• 将 enableHolograms: false 改为 true。
• 将 useHolographicDisplaysAPI: false 改为 true（如果已经是 true 则无需修改）。
• 在游戏中输入 /mineme reload。
• 全息显示有两种文本来源：
• 默认文本：在 config.yml 的 defaultHologramText 中定义。
• 自定义文本：在单个矿场的配置文件中，设置 useCustomHologramText: true，并在 hologramsText 下自定义内容。

创建圆形矿场

方法一：通过 WorldEdit 创建

• 在游戏中，输入 //sel cyl 将选区类型切换为圆柱体。
• 使用 WorldEdit 工具选择一个圆柱体区域。
• 输入 /mm create <矿场名称>，插件将自动创建圆形矿场。

方法二：通过配置文件创建

• 在 mines 文件夹中创建一个新的 .yml 文件，文件名必须与矿场名称完全相同。
• 使用以下模板，并确保 type: CIRCULAR。
• 关键参数说明：
• X, Y, Z：矿场中心点的坐标。
• radius：矿场半径（可接受小数）。
• height：矿场高度（从中心点算起，应为整数）。
• 保存文件，输入 /mm reload 重载配置。

创建多边形矿场

目前暂无详细教程。请参考创建圆形矿场的方法，并将所有涉及“圆形”的概念替换为“多边形”，原理大致相同。

🎮MVdW 占位符

• %minememine%：玩家当前所在矿场的别名。
• %minemeremaining%：玩家当前所在矿场自上次重置后剩余的方块数。
• %minememined%：玩家当前所在矿场自上次重置后已被挖掘的方块数。
• %minemeremainingpercent%：剩余方块数的百分比。
• %minememinedpercent%：已挖掘方块数的百分比。
• %mineme:"minenamehere":remaining%：指定矿场的剩余方块数。
• %mineme:"minenamehere":mined%：指定矿场的已挖掘方块数。

✨标签列表

你可以在配置文件中使用以下标签

全局标签（始终被替换）

• %prefix%：替换为消息前缀。
• %separator%：替换为消息分隔符。
• %header%：替换为插件标题。

矿场标签（仅在矿场相关消息中被替换）

• %mine%：矿场名称。
• %alias%：矿场别名。
• %totalresets%：矿场总重置次数。
• %totalminedblocks%：自创建以来挖掘的总方块数。
• %volume%：矿场体积。
• %resettime%：距离下次重置的剩余时间。
• %minedblocks%：自上次重置后挖掘的方块数。
• %minedblockspercent%：已挖掘方块的百分比。
• %avgspeed%：每秒挖掘的方块数（平均速度）。
• %totalpercentage%：所有材料的总百分比。
• %totalmaterials%：材料总数。
• %remainingblocks%：剩余方块数。
• %remainingblockspercent%：剩余方块的百分比。

全息图标签（仅在全息消息中被替换）

• %icon%：替换为矿场图标（在配置中设置）。

⭐开发状态

已完成的功能

• 终身统计：100%（自矿场创建以来的总破坏方块数）
• 圆形矿场：100%
• MineEditorGUI (MEGUI)：100%
• 多边形矿场：100%

计划中的功能

• 多长方体矿场：50% [开发中]
• 矿场成就：50% [开发中]（例如在 X 分钟内完全挖空矿场、达成 X 终身破坏方块数等）
• 自然小型洞穴生成：0%
• 告示牌支持：0%
• 可选的随机跳过重置几率：0%
• 玩家个人统计：0%（自矿场创建以来及自上次重置以来，每位玩家挖掘的方块数）

🔧源码

你可以在 https://bitbucket.org/bruno_sf/mineme/ 查看插件源码。