# WorldRulesManage 插件概览
**WorldRulesManage** 是一个用于管理世界规则的专业插件。它允许您自由配置玩家行为（例如，阻止方块破坏、方块触发、方块交互等）和世界行为（例如，阻止火焰蔓延、液体流动等）在特定世界中。您还可以使用坐标定义基于半径的规则，以限制玩家或世界动作在特定区域内。
**使用场景：** 服务器大厅、出生保护和受控世界区域。
> 英文 [README.md](https://github.com/MaddyJace/WorldRulesManage/blob/5.0/README.md)
> 简体中文 [CN-README.md](https://github.com/MaddyJace/WorldRulesManage/blob/5.0/CN-README.md)
---
## 📦 插件功能
- 支持全局和基于半径的世界规则：防止火焰蔓延、防止树叶腐烂、防止方块点燃（非玩家）、防止实体方块破坏，以及阻止液体流动（例如，熔岩和水）。
- 支持全局和基于半径的玩家规则：自定义权限控制、防止方块点燃、阻止方块破坏、阻止方块放置、物品拾取/掉落、水桶使用（例如，收集水）、饥饿、
自动恢复饥饿到饱腹、防止玩家伤害、阻止所有传送门（覆盖虚空/末地）、阻止虚空传送门、阻止末地传送门、阻止特定物品的使用（由您配置）、
阻止与特定实体/方块交互、阻止特定方块的触发。
- 半径规则形状（用于世界和玩家）：2D 圆形（忽略 Y 轴）、3D 球形（包含 Y 轴）、2D 正方形（忽略 Y 轴）、3D 立方体（包含 Y 轴）、自定义原点和半径值。
- 支持黑名单/白名单配置
- 支持多个世界
- 支持配置文件自动热重载
---
# ⚙️ WorldRulesManage 配置指南
> [config.yml](https://github.com/MaddyJace/WorldRulesManage/blob/5.0/src/main/resources/config.yml)
> [world.yml](https://github.com/MaddyJace/WorldRulesManage/blob/5.0/src/main/resources/world.yml)
> [radius.yml](https://github.com/MaddyJace/WorldRulesManage/blob/5.0/src/main/resources/radius.yml)
> [message.yml](https://github.com/MaddyJace/WorldRulesManage/blob/5.0/src/main/resources/message.yml)
### ✅ `worldName: ` # 世界名称 (例如，world)
### ✅ `globalRules:` # 应用于世界的规则，无论玩家权限如何
- `flameSpread: true` # 防止火焰蔓延
- `leavesDecay: true` # 防止树叶腐烂
- `blockIgnite: true` # 防止方块点燃
- `entityBlockBreak: true` # 防止实体破坏方块
- `liquidFlow: true` # 防止液体流动
### ✅ `playerRules:` # 应用于没有权限的玩家的规则
- `permission: "wm.world"` # 权限节点
- `blockIgnite: true` # 防止玩家点燃方块
- `blockBreak: true` # 防止玩家破坏方块
- `blockPlace: true` # 防止玩家放置方块
- `itemPickup: false` # 防止玩家拾取物品
- `itemDrop: false` # 防止玩家掉落物品
- `usePail: true` # 防止玩家使用水桶（例如，收集水）
- `food: true` # 防止饥饿
- `foodSatiety: true` # 恢复饥饿到饱腹
- `playerDamage: true` # 防止玩家伤害
- `portalAll: false` # 防止所有传送门访问 (覆盖传送虚空和传送末地)
- `portalNether: false` # 防止虚空传送门访问
- `portalEnder: false` # 防止末地传送门访问
######
- `🎯playerUseItem:` # 阻止物品使用
- `type:` `BLACKLIST` / `WHITELIST`
- `list:`
- "EGG" # 鸡蛋
- "FLINT_AND_STEEL" # 打火石和钢
######
- `🧍PlayerInteractEntity:` # 阻止与实体互动
- `type:` `BLACKLIST` / `WHITELIST`
- `list:`
- "ITEM_FRAME" # 物品画框
- "PAINTING" # 画作
- "ARMOR_STAND" # 盔甲架
######
- `🧱PlayerInteractBlock:` # 阻止与方块互动
- `type:` `BLACKLIST` / `WHITELIST`
- `list:`
- "LEVER" # 活板门
- "FURNACE" # 熔炉
######
- `🎛️PlayerTriggerBlock:` # 阻止触发方块
- `type:` `BLACKLIST` / `WHITELIST`
- `list:`
- "SOIL" # 耕地
- "TRIPWIRE" # 脚绊线
---
### `此选项仅在 radius.yml 中生效`
- `✅settingsRadius:`
- `type:` `2DRange`, `3DRange`, `2DCube`, `3DCube`
- `xyz:` # 起始坐标 (例如，0 0 0)
- `radius:` # 半径，单位为方块
## 📌 大小写敏感警告
> ⚠️ **重要提示：** 所有配置键都区分大小写。错误地使用大写/小写可能会导致错误或忽略设置。
---
## 🛠 推荐实践
- 在半径边缘附近使用 TNT 时，爆炸可能会影响保护区域之外的方块。为了避免这种情况，请将半径扩大 7 个方块，以确保边缘安全。
- 删除或注释掉未使用的配置部分，以保持您的设置干净整洁。
---