MultiWorld - 多世界管理器

MultiWorld 是一款功能强大的 Bukkit/Spigot 服务器插件，它让管理员能够轻松创建、管理和连接多个世界，并为每个世界配置独立的游戏规则与特性，极大地丰富了服务器的玩法和体验。

💡重要通知

• 本项目将不再在 SpigotMC 上更新。如需获取最新版本，请访问 Hangar 页面。
• 请勿在评论区提问或报告漏洞，此类内容将被忽略，且相关用户可能无法获得后续支持。
• 如需支持，请确保你正在使用此插件，并且运行在 Spigot 服务端上。

❓支持与反馈

• 报告漏洞：请前往 GitHub Issues。
• 提出问题：请加入 Discord discord.dev7ex.com 或访问 SpigotMC 讨论帖。

⭐主要特性

MultiWorld 提供了全面的世界管理功能，让你可以精细控制服务器的每一个维度。

核心功能

• 自定义世界生成器支持：支持使用自定义世界生成器创建独特的地形、结构和生物群系。
• 世界连接：可以将多个世界连接在一起，实现世界间的无缝旅行，构建世界网络。
• 按世界配置 PvP：可以为每个世界独立启用或禁用玩家对战（PvP）。
• 传送门控制：可以自定义传送门的行为，包括将其链接到不同的世界或特定坐标。
• 世界白名单：可以为特定世界设置白名单，限制只有授权玩家才能进入，适合创建私人或 VIP 世界。

可配置的世界属性（Flags）

你可以为每个世界配置以下属性

• AUTO_LOAD：服务器启动时自动加载世界。
• AUTO_UNLOAD：当世界没有玩家时自动卸载。
• DIFFICULTY：设置世界难度（如和平、简单、普通、困难）。
• END_PORTAL_ACCESSIBLE：控制末地传送门是否可用。
• GAME_MODE：设置玩家进入世界时的默认游戏模式（如生存、创造）。
• HUNGER_ENABLED：是否启用饥饿机制。
• KEEP_SPAWN_IN_MEMORY：保持出生点区块常驻内存以加快加载。
• NETHER_PORTAL_ACCESSIBLE：控制下界传送门是否可用。
• PVP_ENABLED：是否启用玩家对战。
• RECEIVE_ACHIEVEMENTS：玩家是否能在该世界获得成就。
• REDSTONE_ENABLED：红石装置是否工作。
• SPAWN_ANIMALS：是否自然生成被动生物。
• SPAWN_ENTITIES：是否生成所有实体（包括自定义实体）。
• SPAWN_MONSTERS：是否自然生成敌对生物。
• WEATHER_ENABLED：是否启用天气效果（如下雨、下雪）。

🎮命令列表

所有命令均以 /world 为基础。

世界操作

• /world back
• 权限：multiworld.command.world.back
• 说明：将玩家传送回上一个所在的世界。
• /world create <Name> <Environment> <-g, -s, -t> <Generator | Seed | Type>
• 权限：multiworld.command.world.create
• 说明：创建一个新世界。
• 参数：

- `<Environment>`：世界环境类型（如 `NORMAL`, `NETHER`, `END`）。

- `-g <Generator>`：指定自定义世界生成器。

- `-s <Seed>`：指定世界生成种子。

- `-t <Type>`：指定世界类型（如 `THE_END`, `NETHER`, `NORMAL`）。

• 示例：

- `/world create SeedWorld NORMAL -s 5011934898247180076`

- `/world create TerraWorld NORMAL -g TerraformGenerator`

- `/world create TheEndWorld THE_END -t THE_END`

• /world import <Name> <Environment> <-g, -t> <Generator | WorldType>
• 权限：multiworld.command.world.import
• 说明：导入一个已存在的世界。
• 示例：

- `/world import CustomWorld NORMAL -t NORMAL`

- `/world import TerraWorld NORMAL -g TerraformGenerator`

• /world delete <World>
• 权限：multiworld.command.world.delete
• 说明：从服务器删除指定的世界。
• /world load <World>
• 权限：multiworld.command.world.load
• 说明：将指定世界加载到服务器。
• /world unload <World>
• 权限：multiworld.command.world.unload
• 说明：从服务器卸载指定世界。
• /world backup <Name>
• 权限：multiworld.command.world.backup
• 说明：为指定世界创建备份。

世界配置

• /world flag <World> <Property> <Value>
• 权限：multiworld.command.world.flag
• 说明：为指定世界设置一个属性（Flag）。
• 示例：/world flag SeedWorld PVP_ENABLED false
• /world gamerule <World> <Gamerule> <Value>
• 权限：multiworld.command.world.gamerule
• 说明：更改指定世界的游戏规则。
• 示例：/world gamerule SeedWorld doDaylightCycle false
• /world link <World> <End | Nether> <World>
• 权限：multiworld.command.world.link
• 说明：链接两个世界，常用于连接下界或末地。
• 示例：/world link Overworld NetherWorld Nether

信息与传送

• /world info <World>
• 权限：multiworld.command.world.info
• 说明：显示指定世界的详细信息。
• /world list
• 权限：multiworld.command.world.list
• 说明：列出服务器当前加载的所有世界。
• /world teleport <Player> <World>
• 权限：multiworld.command.world.teleport
• 说明：将一名玩家传送到指定世界。
• 示例：/world teleport Steve AdventureWorld

白名单管理

• /world whitelist <World> Enable
• 权限：multiworld.command.world.whitelist.enable
• 说明：为指定世界启用白名单。
• /world whitelist <World> Disable
• 权限：multiworld.command.world.whitelist.disable
• 说明：为指定世界禁用白名单。
• /world whitelist <World> Add <Name>
• 权限：multiworld.command.world.whitelist.add
• 说明：将一名玩家添加到指定世界的白名单。
• /world whitelist <World> Remove <Name>
• 权限：multiworld.command.world.whitelist.remove
• 说明：将一名玩家从指定世界的白名单中移除。
• /world whitelist <World> List
• 权限：multiworld.command.world.whitelist.list
• 说明：列出指定世界白名单中的所有玩家。

插件管理

• /world help
• 权限：multiworld.command.world.help
• 说明：显示 MultiWorld 的所有可用命令。
• /world reload
• 权限：multiworld.command.world.reload
• 说明：重载 MultiWorld 插件的配置文件。
• /world version
• 权限：multiworld.command.world.version
• 说明：显示 MultiWorld 插件的版本。

🔧安装指南

• 下载插件

- 下载最新版本的 MultiWorld Jar 文件。

- 前往 [FacilisCommon SpigotMC 页面](https://www.spigotmc.org/resources/faciliscommon-bukkit.107198/history) 下载 **1.0.7-SNAPSHOT** 或所需版本。

• 放置插件

- 将 `MultiWorld.jar` 和 `FacilisCommon.jar` 都放入服务器的 `plugins` 文件夹。

• 重启服务器

- 重启你的 Minecraft 服务器以加载插件并应用更改。

• 完成

- 安装完成！现在你可以开始使用 MultiWorld 管理服务器上的多个世界了。

✨链接与统计

• 源代码：GitHub
• 插件统计：bStats
• Modrinth：MultiWorld on Modrinth

💡开发

本页面面向希望为 MultiWorld 插件开发做出贡献的开发者。它包含了设置开发环境、理解代码结构以及贡献代码的指南。

开发环境设置

要开始为 MultiWorld 开发，你需要设置一个本地工作环境。

• 克隆仓库

首先，将 MultiWorld 的 GitHub 仓库克隆到你的本地机器上。

    git clone https://github.com/Dev7ex/MultiWorld.git

• 导入项目

使用你喜欢的 IDE（例如 IntelliJ IDEA）将克隆的目录作为 Maven 项目打开。

• 构建项目

项目使用 Maven 进行管理。你可以使用 IDE 的 Maven 工具或命令行来构建项目。

    mvn clean install

代码结构

理解项目结构有助于你更高效地导航和修改代码。

• src/main/java/net/dev7ex/multiworld/：这是插件的主要源代码目录。

- **`api/`**：包含插件的应用程序编程接口（API）。其他插件可以通过这些类与 MultiWorld 交互。

- **`base/`**：包含核心功能类，例如插件主类、配置管理和命令处理。

- **`feature/`**：包含实现插件特定功能的模块，例如世界创建、管理和传送。

- **`user/`**：包含与用户（玩家）数据相关的类。

贡献指南

我们欢迎并感谢任何形式的贡献，无论是报告问题、建议新功能还是提交代码。

• 报告问题

- 在提交问题报告前，请先检查是否已有类似的问题。

- 使用清晰、描述性的标题。

- 详细描述问题，包括复现步骤、预期行为和实际行为。

- 如果可能，请附上相关的日志或截图。

• 提交拉取请求（Pull Request）

- 在开始重大工作之前，建议先创建一个问题来讨论你的想法。

- 从最新的 `main` 分支创建你的功能分支。

- 确保你的代码遵循项目中现有的代码风格。

- 为你的更改编写清晰的提交信息。

- 确保所有现有测试仍然通过，并为新功能添加测试（如果适用）。

依赖管理

项目使用 Maven 管理依赖。所有依赖项都在 pom.xml 文件中声明。

• 主要依赖

- **`spigot-api`**：用于与 Spigot/Paper 服务器交互的核心 API。

- **`bStats`**：用于收集匿名的使用统计信息。

• 开发依赖

- **`lombok`**：用于减少样板代码（如 getter/setter）。

- **`junit`**：用于编写和运行单元测试。

测试

为了保证代码质量，建议在提交更改前运行测试。

• 你可以使用 Maven 命令运行测试：

    mvn test

• 或者通过你的 IDE 运行测试套件。

联系与支持

如果你在开发过程中有任何疑问，可以通过以下方式获取帮助：

• GitHub Issues：用于报告错误或提出功能请求。
• GitHub Discussions：用于提出一般性问题或参与社区讨论。

感谢你为 MultiWorld 的发展做出贡献！