UltiWorlds

UltiWorlds 是 UltiTools-API 框架下的多世界管理模块，提供完整的世界创建、传送、保护和背包隔离功能。

English | 简体中文

---

简体中文

✨ 功能特性

🌍 世界管理

• 世界创建 - 支持多种环境类型（主世界/下界/末地）和地形类型（标准/超平坦/放大化/巨型生物群系）
• 创建向导 - 交互式对话引导，60秒超时保护
• 世界加载/卸载 - 动态加载和卸载世界，节省服务器资源
• 世界删除 - 安全删除世界（包含确认机制）
• 自动卸载 - 空世界自动卸载，可配置等待时间

🚀 传送系统

• 快速传送 - 支持GUI界面和命令行传送
• 传送冷却 - 可配置的传送冷却时间
• 出生点管理 - 每个世界独立的出生点设置
• 权限控制 - 每个世界可单独设置访问权限

🛡️ 世界保护

• 方块保护 - 禁止破坏/放置方块
• 交互保护 - 禁止与方块交互
• 爆炸保护 - 防止爆炸破坏地形
• PVP 控制 - 每个世界独立的 PVP 开关
• 生物控制 - 独立控制怪物/动物生成
• 天气控制 - 锁定世界天气

📦 背包隔离

• 独立背包 - 每个世界（组）独立的背包
• 末影箱隔离 - 每个世界独立的末影箱
• 经验隔离 - 可选的经验等级隔离
• 状态隔离 - 可选的生命值/饥饿度/药水效果隔离
• 世界分组 - 支持多个世界共享同一背包组

🔒 访问控制

• 世界锁定 - 临时锁定世界入口
• 世界封禁 - 完全禁止进入世界
• 隐藏世界 - 从列表中隐藏世界

📋 命令列表

命令	权限	描述
/world	ultiworlds.use	打开世界列表 GUI
/world list	ultiworlds.use	列出所有世界
/world tp <世界>	ultiworlds.use	传送到指定世界
/world info	ultiworlds.use	查看当前世界信息
/world wizard	ultiworlds.admin.create	启动创建向导
/world create <名称> [类型]	ultiworlds.admin.create	创建世界
/world delete <世界>	ultiworlds.admin.delete	删除世界
/world load <世界>	ultiworlds.admin.load	加载世界
/world unload <世界>	ultiworlds.admin.unload	卸载世界
/world setspawn	ultiworlds.admin.setspawn	设置世界出生点
/world set <世界> <选项> <值>	ultiworlds.admin.settings	修改世界设置
/world protect <世界>	ultiworlds.admin.protect	启用完整保护
/world unprotect <世界>	ultiworlds.admin.protect	禁用所有保护
/world block <世界>	ultiworlds.admin.block	禁止进入世界
/world unblock <世界>	ultiworlds.admin.block	允许进入世界

🔧 可设置选项

通过 /world set <世界> <选项> <值> 命令可以修改以下选项：

选项	值类型	描述
pvp	true/false	PVP 开关
monsters	true/false	怪物生成
animals	true/false	动物生成
weather	true/false	天气变化
hidden	true/false	从列表隐藏
locked	true/false	锁定世界
blocked	true/false	禁止进入
displayname	文本	显示名称
description	文本	世界描述
icon	Material	GUI 图标

⚙️ 配置文件

# config/worlds.yml

# 默认世界名称
default_world: "world"

# 受保护的世界（不能自动卸载或删除）
protected_worlds:
  - "world"
  - "world_nether"
  - "world_the_end"

# 服务器启动时自动加载的世界
load_worlds_on_start: []

# 自动卸载配置
auto_unload:
  enabled: false
  check_interval: 60       # 检查间隔（秒）
  unload_after: 300        # 空世界等待时间（秒）

# 传送配置
tp_to_world:
  enabled: true
  permission_per_world: false
  cooldown: 10

# 背包隔离配置
world_isolation:
  enabled: false
  separate_inventory: true
  separate_ender_chest: true
  separate_experience: false
  separate_health: false
  separate_hunger: false
  separate_effects: false
  shared_worlds:
    - "world,world_nether,world_the_end"

🔑 权限节点

权限	描述
ultiworlds.use	基础使用权限
ultiworlds.admin	管理员权限（包含所有子权限）
ultiworlds.admin.create	创建世界
ultiworlds.admin.delete	删除世界
ultiworlds.admin.load	加载世界
ultiworlds.admin.unload	卸载世界
ultiworlds.admin.setspawn	设置出生点
ultiworlds.admin.settings	修改世界设置
ultiworlds.admin.protect	管理世界保护
ultiworlds.admin.block	管理世界访问
ultiworlds.bypass.locked	绕过世界锁定
ultiworlds.bypass.blocked	绕过世界封禁
ultiworlds.bypass.protection	绕过世界保护
ultiworlds.world.*	访问所有世界
ultiworlds.world.<世界名>	访问指定世界

---

English

✨ Features

🌍 World Management

• World Creation - Multiple environment types (Normal/Nether/End) and terrain types (Normal/Flat/Amplified/Large Biomes)
• Creation Wizard - Interactive dialog with 60-second timeout protection
• Load/Unload - Dynamic world loading/unloading to save server resources
• World Deletion - Safe world deletion with confirmation
• Auto-Unload - Automatic unloading of empty worlds with configurable delay

🚀 Teleportation System

• Quick Teleport - GUI and command-line teleportation
• Teleport Cooldown - Configurable cooldown between teleports
• Spawn Management - Independent spawn points per world
• Permission Control - Per-world access permissions

🛡️ World Protection

• Block Protection - Prevent block breaking/placing
• Interaction Protection - Prevent block interaction
• Explosion Protection - Prevent explosion damage
• PVP Control - Per-world PVP toggle
• Mob Control - Independent monster/animal spawn control
• Weather Control - Lock world weather

📦 Inventory Isolation

• Separate Inventory - Independent inventory per world (group)
• Ender Chest Isolation - Per-world ender chest
• Experience Isolation - Optional XP level isolation
• Status Isolation - Optional health/hunger/potion effect isolation
• World Groups - Multiple worlds can share the same inventory group

🔒 Access Control

• World Lock - Temporarily lock world entrance
• World Block - Completely block world access
• Hidden Worlds - Hide worlds from the list

📋 Commands

Command	Permission	Description
/world	ultiworlds.use	Open world list GUI
/world list	ultiworlds.use	List all worlds
/world tp <world>	ultiworlds.use	Teleport to world
/world info	ultiworlds.use	View current world info
/world wizard	ultiworlds.admin.create	Start creation wizard
/world create <name> [type]	ultiworlds.admin.create	Create world
/world delete <world>	ultiworlds.admin.delete	Delete world
/world load <world>	ultiworlds.admin.load	Load world
/world unload <world>	ultiworlds.admin.unload	Unload world
/world setspawn	ultiworlds.admin.setspawn	Set world spawn
/world set <world> <option> <value>	ultiworlds.admin.settings	Modify world settings
/world protect <world>	ultiworlds.admin.protect	Enable full protection
/world unprotect <world>	ultiworlds.admin.protect	Disable all protection
/world block <world>	ultiworlds.admin.block	Block world access
/world unblock <world>	ultiworlds.admin.block	Unblock world access

📦 Installation

1. Install UltiTools-API (required)
2. Download UltiWorlds module
3. Place in plugins/UltiTools/plugins/ directory
4. Restart server
5. Configure config/worlds.yml as needed

🔄 Migration from UltiTools 5.x

UltiWorlds 2.0 is the successor to the multi-world functionality in UltiTools 5.x. Key improvements:

Feature	UltiTools 5.x	UltiWorlds 2.0
Framework	Manual registration	Annotation-driven
Command System	AbstractTabExecutor	BaseCommandExecutor
Data Storage	AbstractDataEntity	BaseDataEntity
GUI	Manual InventoryHolder	BasePaginationPage
World Protection	Basic	Full (break/place/interact/explosion)
Inventory Isolation	None	Full with groups
Creation Wizard	None	Conversation API

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Support

• GitHub Issues: Report a bug
• Discord: UltiKits Community