# XFWorldLocker (XFWL) v1.0.0
## 概述
XFWorldLocker 是一个为 Paper、Spigot 和 Bukkit 1.21.1+ 版本 Minecraft 提供高级世界保护和管理功能的高级插件。
## 功能
### 🌍 世界区域保护
- 使用 X1,Z1 和 X2,Z2 坐标在世界中定义矩形区域
- 玩家离开定义区域时自动传送
- 与 Y 坐标无关（全高保护）
### 🔒 世界限制
- **方块保护**: 控制方块破坏和放置
- **交互控制**: 管理玩家与方块/实体的交互
- **生物管理**: 控制生物生成和清理
- **伤害控制**: 启用/禁用玩家伤害
- **爆炸保护**: 阻止爆炸（除了在创造模式下）
### ✨ 玩家效果
- 在特定世界中向玩家应用自定义药水效果
- 离开世界时自动移除效果
- 可配置效果放大器
### 🚀 动态命令
- 为每个世界创建自定义传送命令
- 支持命令别名
- 可选的权限要求
- 自动命令注册
### 📝 多语言支持
- 通过 `language.yml` 完全自定义消息
- 支持动作栏和聊天消息
- 支持使用 `&` 符号的颜色代码
## 安装
1. 下载 XFWorldLocker.jar 文件
2. 将其放在服务器的 `plugins` 文件夹中
3. 重启服务器
4. 在 `config.yml` 中配置世界
5. 在 `language.yml` 中自定义消息
## 配置
### config.yml 示例
```yaml
settings:
prefix: "&a[XFWL]"
debug: false
worlds:
world:
enabled: true
spawnWorld: "world"
area:
x1: -100
z1: -100
x2: 100
z2: 100
spawnMobs: false
canBreakBlocks: false
canPlaceBlocks: false
canInteract: false
canTakeDamage: false
effects:
SPEED:
amplifier: 1
JUMP:
amplifier: 0
commands:
command: "/world"
aliases:
- "/worldtp"
- "/w"
permission: ""
```
### language.yml
所有消息都可以在 `language.yml` 文件中自定义。使用 `&` 用于颜色代码，并使用 `{placeholder}` 用于动态值。
## 命令
### 管理员命令
- `/xfwl reload` - 重新加载插件配置
- `/xfwl help` - 显示帮助消息
- `/xfwl version` - 显示插件版本
- `/lock <世界名称>` - 立即将默认限制应用于一个世界
### 动态世界命令
自定义命令将根据您的世界配置自动注册。
## 权限
- `xfwl.admin` - 访问所有管理员命令 (默认: op)
- `xfwl.lock` - 使用 lock 命令的权限 (默认: op)
- `xfwl.bypass` - 绕过所有世界限制 (默认: false)
## 特色功能
### 智能实体管理
- 村民和 NPC 始终受到保护
- 盔甲架和物品框被保留
- FancyNPCs 插件集成
- 限制世界中的自动生物清理
### 创造模式支持
- 创造模式玩家可以绕过方块限制
- 创造模式玩家附近爆炸生效
- 管理员增强的建造能力
### 性能优化
- 高效的区域检查算法
- 对服务器的影响最小
- 异步更新检查
## 兼容性
- **Minecraft 版本**: 1.21.1+
- **最佳 Minecraft 版本**: 1.21.5+
- **服务器软件**: Paper, Spigot, Bukkit
- **Java 版本**: 17 或更高版本
## 支持
如有任何支持、更新或报告错误，请联系我。
## 许可证
此插件由 xfinity 创建。版权所有。