AxMines - 终极矿场插件

💡AxMines：终极矿场插件

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

💡核心特性

简单易用

• 配置过程简单直观，易于设置。

性能优化

• 运行速度极快，不会对服务器 TPS 造成影响。

占位符支持

• 支持 PlaceholderAPI，可与其他插件联动。

独立运行

• 无需 WorldEdit，插件内置了完整的独立系统来处理所有功能。

其他功能

• GUI 编辑器：提供图形界面进行编辑。
• 破坏方块随机奖励：玩家破坏矿场方块时有机会获得随机奖励。

🎮自动重置

AxMines 支持为矿场设置自动重置，可通过以下两种方式触发：

基于时间

• 可设置基于游戏刻（ticks）的时间间隔，当指定时间过去后，矿场将自动重置。

基于填充度

• 可设置基于矿场填充百分比，当矿场的矿石被开采达到指定比例时，矿场将自动重置。

🔧命令重置

除了自动重置，您也可以随时使用命令手动重置您的矿场。

❓支持与联系

• 如果遇到插件不兼容或其他问题，请在我们的 Discord 服务器提交工单：dc.artillex-studios.com
• 如需定制开发、技术支持或其他服务，也欢迎通过以上方式联系我们。

✨运行要求

• 支持的 Minecraft 版本：1.20.2 至 1.21.11
• 必需的 Java 版本：21 或更高版本

💡介绍

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** 版本。请始终使用最新的构建版本以获得最佳兼容性。

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