# VeinMiner: 终极采矿增强
VeinMiner 是您 Minecraft 服务器的终极采矿增强工具！此插件允许玩家通过在破坏方块时按住 Shift 键来开采整个矿脉、原木或其它方块。非常适合生存服务器、天界、或任何希望增强采矿体验的服务器。
**✨ 特色功能**
即时矿脉开采 - 使用单个方块破坏，即可开采整个矿脉、原木丛或其它方块组
高级成长系统 - 玩家在采矿时升级，解锁更大的区块开采能力
全新技能系统 - 通过游戏内 GUI 升级采矿效率
世界保护 (WorldGuard) 集成 - 完全兼容受保护区域
成就系统 - 赚取开采特定方块、达到特定等级等的成就
更新检测器 - 在有新插件更新时收到通知
用户友好的 GUI - 直观的菜单系统用于管理设置和查看成就
工具支持 - 与所有采矿工具配合良好 - 镐、斧头、铲子和锄头
附魔兼容 - 完全支持财富 (Fortune) 和丝绸之触 (Silk Touch) 附魔
平衡游戏 - 可配置的耐久度影响和饥饿成本，以保持游戏平衡
Discord 集成 - 使用详细的 Discord Webhook 通知跟踪采矿活动
多服务器支持 - 在多个服务器上无缝同步玩家数据
视觉指示器 - 在 VeinMiner 激活或未激活时提供清晰的视觉反馈
用户友好的命令 - 简单的命令带有 Tab 自动补全功能，便于管理
灵活的权限系统 - 使用详细的权限节点和可配置的条件来控制谁可以使用该插件
全球权限切换开关，便于设置
工具特定的权限控制
基于命令的权限管理
可配置的每个功能的权限要求
经济系统集成 - 通过游戏内货币奖励玩家成就
**命令**
- /veinminer 或 /vm - 打开 VeinMiner 主 GUI
- /veinminer on - 启用 VeinMiner
- /veinminer off - 禁用 VeinMiner
- /veinminer toggle - 切换 VeinMiner 的开启/关闭状态
- /veinminer tool - 针对特定工具进行切换
- /vmtoggle - 切换 VeinMiner 的开启/关闭状态
- /vmlevel - 查看您当前的等级和进度
- /vmsetlevel - 设置玩家的 VeinMiner 等级（管理员）
- /vmsync - 在服务器之间同步 VeinMiner 数据（管理员）
- /veinminerreload - 重新加载配置文件（管理员）
- /veinminerabout - 显示插件信息
- /veinminerhelp - 显示帮助信息
- /vmskill - 打开技能菜单
- /vmadmin [debug|reload|sync|stats|bstats] - 管理插件的管理员命令（管理员）
**权限**
- veinminer.use - 允许玩家使用 VeinMiner
- veinminer.tool.pickaxe - 允许玩家使用 VeinMiner 镐
- veinminer.tool.axe - 允许玩家使用 VeinMiner 斧头
- veinminer.tool.shovel - 允许玩家使用 VeinMiner 铲子
- veinminer.tool.hoe - 允许玩家使用 VeinMiner 锄头
- veinminer.admin - 允许访问所有 VeinMiner 管理员命令 (默认：op)
占位符
- %veinminer_level% - 显示玩家的当前等级
- %veinminer_experience% - 显示玩家的当前经验值
- %veinminer_blocks_mined% - 显示开采的方块总数
- %veinminer_achievements_completed% - 显示已完成的成就
- %veinminer_top_level_X% - 显示前 X 名玩家的等级 (X = 1-10)
- %veinminer_top_achievements_X% - 显示前 X 名玩家的成就 (X = 1-10)
- %veinminer_top_blocks_X% - 显示前 X 名玩家的开采方块数 (X = 1-10)
**⚙️ 配置文件**
VeinMiner 具有高度的可配置性：
- 设置一次可开采的最大方块数量
- 配置工具的耐久度影响
- 调整平衡的饥饿成本
- 定义可开采的方块
- 自定义等级系统
- 设置具有自定义奖励的成就
- 启用/禁用 Discord 记录
- 配置经济系统集成
- 启用 WorldGuard 兼容性
- 启用更新检测器以获取新版本
- 配置权限要求：
- 在全局范围内启用/禁用权限要求
- 设置工具特定的权限
- 配置命令权限
- 自定义不同功能的权限节点
**⚙️ 自动配置文件更新器**
再也不用担心错过或过时的配置选项了！
每次插件启动时，VeinMiner 都会自动检查 config.yml 文件中的所有重要选项。如果缺少任何必需的选项（例如，在更新后或意外删除后），它将使用安全的默认值将其添加回去——而不会覆盖您现有的设置。
适用于所有受支持和旧版本的配置
仅添加缺失的选项；您的自定义保持不变
所有更改都会在服务器日志中清晰显示，并带有醒目的警告和摘要
确保最大兼容性并防止由于不完整的配置而导致插件出错
示例日志输出：
```
[WARNING] [CONFIG UPDATER] 添加缺失的配置选项: settings.hybrid-mode = false
[WARNING] [CONFIG UPDATER] 添加缺失的配置选项: settings.hybrid-blacklist 使用默认的树 / 树叶块
[SEVERE] ------------------------------------------------------------
[SEVERE] !!! CONFIG UPDATER: 配置文件已更新 !!!
[SEVERE] !!! 缺失的选项已使用默认值添加 !!!
[SEVERE] !!! 请查看您的 config.yml 文件以获取新设置 !!!
[SEVERE] !!! 检查上面的日志以获取详细信息 !!!
[SEVERE] ------------------------------------------------------------
```
如果您的配置文件已完整，您将看到：
```
[INFO] [CONFIG UPDATER] 所有配置选项都已就位且最新。
```
这使得更新和维护您的服务器配置变得轻松而安全！
**🌎 WorldGuard 集成**
VeinMiner 提供与 WorldGuard 无缝集成：
- 在 WorldGuard 保护区域内激活 Veinminer 或禁用它
**成就与技能系统**
- 开采特定方块以获得奖励
- 达到里程碑等级以获得认可
- 兑换游戏内货币和物品奖励
- 通过直观的 GUI 跟踪进度
- 在 GUI 中直接升级技能
- 与其他玩家竞争以获得成就
**入门**
1. 下载并安装插件
2. 在 config.yml 中配置设置
3. 设置 MySQL 以用于进度和成就系统
4. 如果需要，启用 WorldGuard 支持
5. 按住 Shift 键开采以激活 VeinMiner！
❓ 支持
如果您遇到任何问题或有任何建议，请访问我们的 [Github](https://github.com/BischoffTV/Veinminer/issues)、通过 [Spigot](https://www.spigotmc.org/threads/veinminer-ultimate-mining-enhancement.682674/) 联系我们或在 [Discord](https://discord.com/qKzzMNgNMH) 上提问。