# 🌍 LilWorlds - 高级世界管理
**一个为支持 1.16 至 1.21.6 版本的 Minecraft 服务器设计的，高性能且模块化的世界管理插件。**
---
## ✨ 核心功能
### 🌍 **世界管理**
- **创建世界**，带有自定义环境和生成器
- **克隆现有世界**，包含所有数据
- **动态加载/卸载世界**
- **无缝导入外部世界**
- **通用传送系统**，用于跨世界传送
### 📦 **独立物品栏**
- **按世界/组的独立物品栏** - 玩家可以在不同的世界拥有不同的物品栏
- **世界组** - 在同一组中的世界之间共享物品栏
- **可配置的分离** - 选择要分离的内容：物品栏，生命值，经验，游戏模式，飞行，效果，位置，末影箱
### ⚡ **性能优先**
- 优化世界加载/卸载
- 尽可能地使用异步操作
- 最小化服务器影响
- 速率限制保护
### 🔧 **模块化设计**
- 自定义生成器系统，使用 YAML 配置文件
- 完整的配置选项
- PlaceholderAPI 集成
- bStats 指标集成
---
## 🎮 指令
### 世界指令 (`/world` 或 `/w`)
```
/world create <名称> [环境] [-g 生成器] # 创建新的世界
/world clone <源> <目标> # 克隆现有世界
/world load [世界] # 加载世界(们)
/world unload [世界] # 卸载世界(们)
/world import <名称> [环境] # 导入外部世界
/world setspawn # 设置世界重生点
/world setuniversalspawn # 设置通用重生点
/world info [世界] # 显示世界信息
/world list # 列出所有世界
```
### 插件指令 (`/worlds`)
```
/worlds reload [目标] # 重新加载插件组件
/worlds inventory <操作> # 管理独立的物品栏
/worlds groups <操作> # 管理世界组
```
---
## 🛠️ 自定义生成器
使用 `generators/` 文件夹中的 YAML 文件创建自定义世界生成器：
```yaml
display-name: "自定义平坦世界"
type: "FLAT"
generate-structures: true
biomes: ["PLAINS", "FOREST"]
layers:
- "minecraft:bedrock"
- "minecraft:stone:5"
- "minecraft:dirt:3"
- "minecraft:grass_block"
```
---
## 📊 独立的物品栏系统
高级物品栏分离系统，允许玩家在不同的世界或世界组中拥有不同的物品栏：
```yaml
features:
separate-inventories:
enabled: true
separate:
inventory: true
health: true
experience: true
world-groups:
survival: ["world", "world_nether", "world_the_end"]
creative: ["creative_world", "build_world"]
```
---
## 🔗 PlaceholderAPI 支持
广泛的占位符支持，用于与其他插件集成：
- `%lilworlds_current_world%` - 当前世界名称
- `%lilworlds_total_worlds%` - 加载的世界总数
- `%lilworlds_world_players_<世界>%` - 特定世界中的玩家
- 以及更多...
---
## 📋 要求
- **Minecraft**: 1.16 - 1.21.5 (Bukkit/Spigot/Paper)
- **Java**: 8 或更高版本
- **依赖项**: 无 (PlaceholderAPI 可选)
---
## 🚀 快速开始
1. 下载并放置在 `plugins/` 文件夹中
2. 重新启动服务器
3. 创建你的第一个世界: `/world create myworld`
4. 启用独立的物品栏: `/worlds inventory enable`
5. 在 `plugins/LilWorlds/config.yml` 中进行配置
---
## 📚 链接
- **[📖 文档](https://hydr4.mintlify.app/lilworlds)** - 完整的指南和教程
- **[💬 Discord](https://discord.gg/phVzDFAZ3v)** - 社区支持
- **[🐛 Issues](https://github.com/QQuantumBits/LilWorlds/issues)** - 错误报告和功能请求
- **[⭐ GitHub](https://github.com/QQuantumBits/LilWorlds)** - 源代码和发布版本
---
**LilWorlds** - 让世界管理变得简单、快速和强大。