AxMines - 终极矿场插件

AxMines 是一款高性能、功能丰富且高度可自定义的矿井插件，无需依赖 WorldEdit 即可运行！

💡版本说明

• 最新版本暂时仅支持 1.20.2-1.20.4 和 1.21.5-1.21.11 版本。如需其他版本，请前往版本历史下载旧版本。
• 支持的 Minecraft 版本：1.20.2-1.21.11。

🎮运行环境

• 所需 Java 版本：21 或更高。

⭐插件特性

• 配置简单：设置过程轻松便捷。
• 性能优化：插件运行极快，不会影响服务器 TPS。
• 变量支持：支持 PlaceholderAPI。
• 独立运行：无需 WorldEdit，内置独立系统处理所有操作。
• 随机奖励：破坏方块时可获得随机奖励。
• GUI 编辑器：提供图形化界面编辑器。

✨自动重置

您可以为矿井设置自动重置功能。

基于时间

• 您可以基于时间设置自动重置，当经过 X 时间后，矿井将自动重置。

基于填充度

• 您可以基于矿井的填充度设置自动重置，当负载达到 X 百分比时，矿井将自动重置。

重置命令

• 您可以通过命令重置矿井。

❓支持与联系

• 如果遇到不支持的插件，请在我们 Discord 开启工单：dc.artillex-studios.com
• 如需定制开发、技术支持或其他服务，请联系我们。

💡介绍

AXMines 是一款高级矿场插件，允许玩家创建、管理和升级可自动重置的矿场。它提供了丰富的自定义选项，包括矿场区域、重置机制、升级系统和商店集成，旨在为服务器提供稳定且可扩展的资源生成解决方案。

🎮功能

• 可自定义的矿场：创建具有不同层级、重置时间、外观和掉落物的矿场。
• 多层升级系统：允许玩家使用游戏内货币或物品升级矿场，提升重置速度、掉落物数量和质量。
• 智能重置：支持多种重置模式（如定时、挖空后、手动），并可配置粒子效果和音效。
• HolographicDisplays 支持：为每个矿场显示动态信息悬浮文本。
• Vault 经济集成：支持使用游戏货币进行升级和交易。
• 多语言支持：内置多种语言，方便国际化服务器使用。
• 统计系统：跟踪每个矿场的开采数据。
• API 支持：为开发者提供集成接口。

🔧命令与权限

玩家命令

• /mine - 打开矿场管理界面。
• /mine help - 显示帮助信息。
• /mine list - 列出所有可用的矿场。
• /mine teleport <矿场名> - 传送到指定矿场。
• /mine stats - 查看你的矿场统计信息。

管理员命令

• /mine create <矿场名> - 在当前位置创建一个新矿场。
• /mine delete <矿场名> - 删除指定矿场。
• /mine addblock <矿场名> - 将目标方块添加到矿场的方块列表中。
• /mine setspawn <矿场名> - 设置矿场的传送点。
• /mine reload - 重载插件配置和语言文件。

主要权限

• axmines.use - 允许使用基础命令（如 /mine）。
• axmines.admin - 允许使用所有管理员命令。
• axmines.teleport - 允许使用传送命令。
• axmines.bypass - 绕过矿场保护（例如，防止方块被破坏）。

✨安装与设置

• 确保服务器已安装 Java 17 或更高版本。
• 将 AXMines.jar 放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件首次运行后会生成配置文件和数据文件夹。
• 根据需要编辑 config.yml 和 mines.yml 来配置矿场。

创建第一个矿场

• 使用世界编辑工具（如 WorldEdit）创建一个矿洞区域。
• 站在矿洞内，执行 /mine create <名称>。
• 使用 /mine addblock <名称> 添加矿洞内需要被重置的方块。
• 使用 /mine setspawn <名称> 设置玩家进入矿场的传送点。
• 编辑 plugins/AXMines/mines.yml 文件，为该矿场配置层级、掉落物和升级选项。

❓依赖

• 必需依赖：无（核心功能独立运行）。
• 软依赖（增强功能）：

- **Vault** - 用于经济系统集成。

- **HolographicDisplays** - 用于显示矿场信息悬浮文本。

- **PlaceholderAPI** - 用于在其他插件中使用矿场变量。

⭐配置概述

主要配置文件位于 plugins/AXMines/：

• config.yml - 主配置文件，设置数据库、语言、重置效果等全局选项。
• mines.yml - 定义所有矿场的具体属性，如区域、层级、升级和掉落物。
• lang/ 文件夹 - 包含多种语言文件（如 en.yml, zh.yml），用于自定义消息。

🔧常见问题 (FAQ)

• 矿场没有重置？

- 检查矿场的 `reset-time` 配置。

- 确保矿场区域被正确定义且包含在 `blocks` 列表中。

- 查看服务器日志是否有错误信息。

• 如何给矿场添加新的升级？

- 在 `mines.yml` 中对应矿场的 `upgrades` 部分添加新的层级，并配置其 `cost`（花费）和 `effects`（效果，如 `reset-time-reduction`）。

• 悬浮文本不显示？

- 确认已安装 **HolographicDisplays** 插件。

- 在 `config.yml` 中检查 `holograms.enabled` 是否设置为 `true`。

• 支持哪些 Minecraft 版本？

- AXMines 支持 **Spigot**、**Paper** 及其衍生服务端的 **1.17.x 至 1.20.x** 版本。请始终使用最新的构建版本以获得最佳兼容性。

如需更多帮助，请访问官方文档或支持频道。