[MD]
# MeowOreGen - 高级自定义刷石机插件
---
## 📖 简介 (Introduction)
**MeowOreGen** 是一款高性能、高可配置的 Minecraft 刷石机插件。它深度集成了 **BentoBox**，同时也完全支持在普通生存、RPG 或派系服务器中**独立运行**。
无论您的服务器是否运行空岛模式，MeowOreGen 都能通过其强大的分级成长系统，将原本枯燥的圆石生成器转化为激动人心的资源获取点。服主可以设计一套成长系统，让玩家随着等级或权限的提升，解锁更高级的矿物生成概率。
## ✨ 核心特性 (Core Features)
* **🚀 深度集成 BentoBox 生态**: 原生支持 **BSkyBlock**、**AcidIsland (海岛)**、**OneBlock (单方块)**、**Boxed** 等所有 BentoBox 游戏模式，即插即用。
* **🔌 全能独立模式**: 即使没有安装 BentoBox 也能完美运行！可作为生存、公会或 RPG 服务器的全局矿物生成解决方案。
* **📈 动态成长体系**: 构建深度的游戏循环，支持创建无限数量的“刷石机等级”（如：新手级、精英级、传说级），让玩家时刻保持晋升动力。
* **🔐 智能解锁机制**: 支持基于 **岛屿等级** 或 **权限节点** (VIP/Ranks) 自动解锁高级生成器，实现精细化的进度控制。
* **🌍 全维度覆盖**:
* **主世界 (Overworld)**: 重新定义圆石与石头生成机制。
* **下界 (Nether)**: 将地狱岩生成器转化为珍稀资源井。
* **末地 (The End)**: 自定义末地石生成，丰富后期游戏内容。
* **🖥️ 现代化交互体验**: 提供直观、美观的 GUI 界面，玩家可实时查看解锁进度、查询详细掉落概率，并一键切换已解锁的等级。
* **⚙️ 人性化开关控制**: 内置“原版回退”模式，建筑党可随时关闭自定义生成，恢复原版刷石机逻辑，满足多样化需求。
* **🧪 自定义交互规则**: 支持自定义液体流动交互逻辑（例如：岩浆流向堆肥桶时生成圆石）。这使得在**下界**等无法放置水的环境中创建刷石机成为可能，极大拓展了玩法。
* **🛡️ 经济平衡护盾**: 可选的防爆机制，在检测到 TNT 炸毁方块时自动熔断自定义生成，有效遏制全自动 AFK 刷矿，维护服务器经济健康。
* **⚡ 企业级性能优化**:
* **智能缓存架构**: 高效的岛屿等级缓存 (60s TTL)，彻底告别 API 调用延迟。
* **惰性计算 (Lazy Evaluation)**: 仅在必要时刻检查逻辑条件，极大降低服务器计算开销。
* **全异步 I/O**: 数据库操作 (SQLite/MySQL) 100% 异步处理，确保主线程如丝般顺滑，拒绝卡顿。
## 📥 安装指南 (Installation)
1. 确保服务器已安装并运行 **BentoBox**。
2. 下载 `MeowOreGen.jar` 并放入 `plugins` 文件夹。
3. 重启服务器。
4. 根据需要修改 `config.yml` 配置文件。
5. 输入 `/mog reload` 应用更改。
## 🛠 指令与权限 (Commands & Permissions)
| 指令 | 别名 | 描述 | 权限 |
| :--- | :--- | :--- | :--- |
| `/mog` | `/oregen` | 打开刷石机选择界面 (GUI)。 | `meoworegen.use` |
| `/mog gui` | - | 打开刷石机选择界面 (GUI)。 | `meoworegen.use` |
| `/mog reload` | - | 重载插件配置与语言文件。 | `meoworegen.admin` |
* **`meoworegen.use`**: 默认权限 (所有玩家拥有)。允许玩家打开 GUI 并使用自定义刷石机。
* **`meoworegen.admin`**: 管理员权限 (默认 OP 拥有)。允许重载插件。
## ⚙️ 配置指南 (Configuration Guide)
`config.yml` 包含详细的注释，帮助您自定义所有内容。
### 定义刷石机等级 (Defining Tiers)
您可以在 `generators` 部分添加任意数量的等级：
```yaml
generators:
# 等级的唯一 ID
vip_tier:
display_name: "&6VIP 尊享刷石机"
# 解锁条件：岛屿等级 1000 或 拥有权限 'meoworegen.group.vip'
island_level_required: 1000
permission: "meoworegen.group.vip"
# GUI 中的槽位位置
slot: 2
priority: 10
icon: DIAMOND_ORE
# 掉落概率配置
worlds:
NORMAL: # 主世界
STONE: 50.0
DIAMOND_ORE: 1.0
IRON_ORE: 20.0
NETHER: # 下界
QUARTZ_ORE: 30.0
```
### 数据存储 (Storage)
MeowOreGen 支持本地文件 (SQLite) 和企业级数据库 (MySQL)。
```yaml
storage:
type: SQLITE # 或者 MYSQL
```
## ❓ 常见问题 (FAQ)
**Q: 这个插件支持海岛 (AcidIsland) 吗？**
A: 支持！只要是使用 BentoBox 管理岛屿的游戏模式（包括海岛、空岛、单方块等），本插件都能完美工作。
**Q: 我可以设置只有 VIP 才能用的刷石机吗？**
A: 可以。在配置文件中为该等级设置一个特殊的 `permission` 权限节点（例如 `group.vip`），然后只给 VIP 玩家该权限即可。
**Q: 为什么 TNT 炸毁方块后，刷石机自动关闭了？**
A: 这是一个可配置的防挂机特性 (`disable_on_explosion`)。为了防止玩家利用 TNT 全自动刷取稀有矿物，插件会在检测到爆炸破坏时自动关闭自定义生成功能。您可以在配置中关闭此功能。
[/MD]
