MineMe 是一款自动矿区重置插件，旨在提供高度自定义的矿区管理功能，包括多种矿区形状、可定制消息、全息显示支持以及开发者友好的API。它兼容 Minecraft 1.8 及以上版本。

✨ 主要特性

• 基础矿区功能：轻松修改矿石百分比、自动传送出矿区、矿区重置广播消息等。
• 可定制的全息显示：支持 HolographicDisplays 插件，展示矿区信息。
• 完全可定制的消息：自定义插件的各种消息提示。
• 开发者友好的 API：方便其他插件集成。
• 自定义 WorldEdit 矿区创建：通过选择区域（长方体、圆柱体）创建矿区。
• 多种矿区形状：支持长方体、圆形和多边形矿区。
• 矿区药水效果：玩家进入矿区时获得药水效果。
• MineResetLite 数据转换。
• 标签替换：显示剩余/已破坏方块数量、下次重置时间、矿区体积等统计信息。
• MVdWPlaceholderAPI 兼容：支持使用 MVdW 插件的占位符。
• 颜色调色板：通过修改预定义颜色更改聊天颜色设计。
• 兼容 Minecraft 1.8 及以上版本。
• MineEditorGUI (MEGUI)：通过菜单编辑矿区。

📦 安装

1. 下载 WorldEdit 插件。
2. 下载 MineMe 插件。
3. 如果需要使用全息显示或 MVdWPlaceholderAPI，下载对应的插件。
4. 确保安装了 Java 1.8 或更高版本。
5. 将 WorldEdit.jar、MineMe.jar 以及其他依赖插件放入 plugins 文件夹。
6. 启动服务器，插件会自动生成配置文件。

🔑 权限

• mineme.admin - 管理员权限，用于执行插件命令。

⚙️ 依赖

• WorldEdit (插件运行所必需)
• HolographicDisplays (如果需要使用全息显示)
• MVdWPlaceholderAPI (用于 MVdW 插件集成)

❓ 常见问题解答和故障排除

问：如何启用我的第一个矿区？

答：首先，打开 mines 文件夹中的矿区配置文件（例如 examplemine.yml），将 enabled 设置为 true，然后在游戏中输入 /mineme reload 命令。

问：如何使用全息显示？

答：确保安装了 HolographicDisplays 插件，然后在 config.yml 中将 enableHolograms 和 useHolographicDisplaysAPI 设置为 true，最后输入 /mineme reload 命令。

问：如何创建圆形矿区？

答：可以通过 WorldEdit 或直接修改矿区配置文件来创建圆形矿区。使用 WorldEdit 时，先使用 //sel cyl 命令选择圆柱形区域，然后输入 /mm create (MineName) 命令。或者，在矿区配置文件中设置 type: CIRCULAR，并配置 X, Y, Z (中心坐标), radius (半径) 和 height (高度) 参数。

问：图标占位符报错？

答：Bukkit 和 Minecraft 的材料名称不同，请使用 Bukkit 材料名称。

问：发现 Bug 怎么办？

答：在论坛或私信中反馈 Bug，作者会尽快修复。

问：启动服务器时出现 java.lang.UnsupportedClassVersionError 错误？

答：请确保安装了 Java 1.8 或更高版本。

✅ 已完成特性

• 终生统计: 100% (自矿区创建以来破坏的总方块数) [已完成]
• 圆形矿区: 100% [已完成]
• MineEditorGUI (MEGUI): 100% 通过菜单编辑矿区! [已完成]
• 多边形矿区: 100% [已完成]

📝 计划中特性

• 多立方体矿区: 50% [进行中]
• 矿区成就: 50% [进行中] (在 x 分钟内完全破坏矿区，破坏 x 个终生方块等)
• 天然小洞穴: 0% (在矿区内生成类似 Minecraft 的洞穴)
• 告示牌支持: 0%
• 可选的随机跳过重置几率: 0%
• 单玩家统计: 0% (自矿区创建以来以及自上次重置以来每个玩家破坏的总方块数)

🏷️ 标签

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

全局标签 (总是被替换)

• %prefix% - 替换为 messagePrefix
• %separator% - 替换为 messageSeparator
• %header% - 替换为 pluginHeader

矿区标签 (仅在矿区消息中被替换)

• %mine% - 替换为矿区名称
• %alias% - 替换为矿区别名
• %totalresets% - 替换为矿区重置总次数
• %totalminedblocks% - 替换为自矿区创建以来开采的方块总数
• %volume% - 替换为矿区体积
• %resettime% - 替换为到下次重置的剩余时间
• %minedblocks% - 替换为已开采的方块数量
• %minedblockspercent% - 替换为已开采方块的百分比
• %avgspeed% - 替换为每秒破坏的方块数
• %totalpercentage% - 替换为所有材料的总百分比
• %totalmaterials% - 替换为材料总数
• %remainingblocks% - 替换为剩余方块的数量
• %remainingblockspercent% - 替换为剩余方块的百分比

全息显示标签 (仅在全息显示消息中被替换)

• %icon% - 替换为矿区图标

📖 教程

启用你的第一个矿区

安装插件后，启动服务器以生成必要的文件。插件配置文件包括：

• config.yml
• messages.yml
• mines 文件夹

首先，我们需要启用矿区！打开 mines 文件夹并打开 examplemine.yml。

enabled: false #<<< Change this
enabled: true #<<< To this
#This basically tells the plugin "Hey, load this!"
#This is initially set to false because the examplemine is set from
#0,64,0 to 20,84,10 and there could be something built, so I've set it
#false by default to prevent MineMe from destroy your builds (Based on a true story, you will be missed Cydonia </3)

现在，我们需要做的第一件事是启用矿区，因此只需在配置中搜索 "enabled"，将其设置为 true，进入 Minecraft 并键入：/mineme reload。

这基本上告诉插件：“嘿！我在这里更改了一些东西！再次加载配置！”，并且你所做的更改将被更新。

建议始终直接在配置中更改设置并键入 /mineme (或 mm 或 mrl 或 mine) reload，因为它更快更有效率，但如果你想使用 /mineme edit (mine) (params)，那就随你便吧。

使用全息显示

要使用全息显示，需要在服务器中安装全息显示插件。目前，唯一兼容的全息显示插件是 HolographicDisplays，但如果你使用任何其他插件并希望我也添加它，请在下面留下建议。

要在 MineMe 中启用 HolographicDisplays，需要在 config.yml 中更改 2 行。

holograms:
  enableHolograms: false #<<< Change this
  enableHolograms: true #<<< To this

  useHolographicDisplaysAPI: false #<<< And this
  useHolographicDisplaysAPI: true #<<< To this
  #useHolographicDisplaysAPI might already be set to true, in this case, you don't need to do anything :)

在游戏中键入 /mineme reload，如果：

• 安装了兼容的全息显示插件
• 在 config.yml 中启用了 useHolograms
• 在 config.yml 中启用了兼容的全息显示插件 API

全息显示应该会出现，很简单。

每个矿区都有自己显示全息显示的方式：

• 立方体和圆形矿区将在每一侧和一个顶部都有一个全息显示
• 多边形全息显示将在每个点上都有一个全息显示

全息显示可以通过 2 种方式找到要显示的文本，它们是：

• 默认全息显示文本
• 自定义全息显示文本

默认全息显示文本是在 config.yml 中找到的字符串（文本）列表。

defaultHologramText:
  - '%header%'
  - '%alias%'
  - '$2Mined: $1%minedblocks%$4/$1%volume% $2blocks'
  - '$1%remainingblockspercent%$2% remaining'
  - '&7Stone $2percentage:$1 %composition:STONE%'
  - '&2Emerald $2percentage$1 %composition:EMERALD_ORE%'
  - '&6Gold $2percentage$1 %composition:GOLD_ORE%'
  - '$2Time until next reset: $1%resettime%'
  - '&e&lBanana for scale!'
  - '%header%'

当以下情况时将使用此文本：forceDefaultHologramOnAllMines 在 config.yml 中设置为 true（将强制所有矿区使用默认全息显示文本），或者 useCustomHologramText 在矿区配置文件中设置为 false（仅影响矿区本身）。

如果想为特定矿区设置自定义全息显示文本，需要这样做：

• 在矿区的配置文件中将 useCustomHologramText 设置为 true
• 将 hologramsText 设置为你想要全息显示的外观

因此你的矿区配置文件应该如下所示：

#If this mine will use the hologramsText below
#False will use the default text in config.yml
useCustomHologramText: true
#This will only be used in case HolographicDisplays is available and enabled
#in config.yml and useCustomHologramText is enabled AAAAND forceDefaultHologramOnAllMines isn't enabled in config.yml :D
hologramsText:
  - '%alias%'
  - '$1Mined: $2%minedblocks% $1blocks'
  - '$2%remainingblockspercent%$1% remaining'
  - '$3This is a custom hologram text! :D'

恭喜！你已成功将全息显示安装到你的矿区中！现在去制作那个 P4 吧。

创建圆形矿区

创建圆形矿区有两种方法：

• 直接通过 WorldEdit 创建（需要中级 WE 知识）
• 通过矿区配置文件创建

通过 WorldEdit 创建

首先，需要了解 MineMe 如何确定你想要创建哪种类型的矿区（以下仅适用于通过 WE 创建矿区时）：

当你键入 /mm create (MineName) 时，它会检测你的选择类型，如果你的选择类型为 Cubeoid，MineMe 会认为：“哦，好的，所以他的选择是 Cubeoid，所以显然他想创建一个 Cubeoid 矿区！”

然后，MineMe 将获取选择区域并自动创建矿区。

现在，当你想创建一个圆形矿区时，你需要更改你的选择类型，要做到这一点，键入 //sel cyl。

这基本上告诉 WorldEdit：“嘿，我现在想选择一个圆圈！”并且神奇地 WE 会将你的选择更改为圆柱类型。

现在当你键入 /mm create (MineMe) 时，MineMe 会认为：“嗯... 他的选择现在是一个圆柱体，所以他想创建一个圆形矿区！”

然后，MineMe 将再次获取选择区域并自动创建矿区，但现在由于它是一个圆柱体，结果将是一个圆形矿区！

请注意，MineMe 将使用圆柱体的 X 半径作为矿区的半径，因为你无法创建椭圆形矿区（目前），这意味着如果你有一个 6 X 半径和 4 Z 半径的圆柱体选择，MineMe 将创建一个半径为 6 的矿区！

通过配置创建

我个人认为通过配置文件创建矿区更容易，但是，嘿，我们都不同。

首先，你需要创建一个矿区文件，并且看在上帝的份上，将它的名称与你的矿区名称完全相同！

你可以使用这个作为模板：

enabled: true
name: 'examplecircularmine'
alias: '&cSpiral'
world: world
type: CIRCULAR
resetDelay: 1
broadcastOnReset: true
broadcastToNearbyOnly: false
broadcastRadius: 50.0
composition:
#{Material}:[Data(Optional)]={Percentage}
#STONE=25
#WOOL:9=25
- STONE=35
- DIAMOND_ORE=60
- DIAMOND_BLOCK=5
radius: 10
height: 30
X: 30.0
Y: 64.0
Z: 30.0
useCustomHologramText: false
#This will only be used in case HolographicDisplays is available and enabled
#in config.yml and useCustomHologramText is enabled AAAAND forceDefaultHologramOnAllMines isn't enabled in config.yml :D
hologramsText:
- '%alias%'
- '$1Mined: $2%minedblocks% $1blocks'
- '$2%remainingblockspercent%$1% remaining'
- '$3This is a custom hologram text! :D'

现在，每种矿区类型以不同的方式读取配置文件，尽管可能有一些相似之处：

首先：每个矿区配置都需要 type 参数，没有例外。请注意，每种矿区使用 type: CUBOID 或 type: CIRCULAR，所以记得更改它！如果你不更改 CUBOID 为 CIRCULAR，MineMe 将尝试将配置加载为 CUBOID 矿区，并且你会收到一个错误。

你将注意到的第一个区别是，CuboidMines 有 X1、Y1、Z1、X2、Y2、Z2，而 CircularMines 有 X、Y、Z，其中：

• X = 矿区中心点的 X 坐标
• Y = 矿区中心点的 Y 坐标
• Z = 矿区中心点的 Z 坐标

这 3 个坐标将是矿区的最低中心点，这意味着这是将创建孔矿区的参考点。

CircularMines 还有另外 2 个需要的参数：

• Height = 从中心点开始的矿区高度
• Radius = 矿区的半径

Height 是一个整数！这意味着你不能放置小数（你可以，但它可能更容易出现 Bug）

Radius 是一个双精度数！这意味着你可以放置小数，尽管整数也可以。

创建此文件后，将其放入 mines 文件夹（如果还没有），键入 /mm reload，并且 CircularMine 将被加载。

创建多边形矿区

检查创建圆形矿区，并将涉及圆圈的所有内容更改为多边形，应该（可能不会）没问题。

🔌 MVdWPlaceholders

占位符:

• minememine: 返回玩家当前所在的矿区的别名。
• minemeremaining: 返回自上次重置以来玩家当前所在的矿区中尚未开采的方块总数。
• minememined: 返回自上次重置以来已开采的方块总数。
• minemeremainingpercent: 以百分比形式返回自上次重置以来玩家当前所在的矿区中尚未破坏的方块总数。
• minememinedpercent: 以百分比形式返回自上次重置以来玩家当前所在的矿区中已开采的方块总数。
• mineme:"minenamehere":remaining: 返回所述矿区自上次重置以来尚未开采的方块总数。
• mineme:"minenamehere":mined: 返回所述矿区自上次重置以来已开采的方块总数。

💻 源码

你可以在 这里 查看源码。