WorldSelector - 世界选择器

WorldSelector 是一个世界选择器插件，允许你设置一个物品，右键点击即可打开一个 GUI 界面，列出所有可传送的世界。这对于非 Bungee 但拥有多个世界的服务器非常实用。

💡核心特性

• 完全可配置：所有内容均可通过配置文件自定义。
• 大容量 GUI：支持最多 54 个物品槽位。
• 权限系统：通过权限控制特定世界仅对 VIP 或管理员可见。
• 使用世界限制：可指定仅在特定世界内才能使用物品打开 GUI，防止误操作。
• 个性化显示：物品名称与描述支持变量，实现个性化界面。
• 传送欢迎语：玩家传送到新世界后，可收到一条欢迎消息。
• 调试模式：内置调试功能，便于快速定位错误。
• 物品发放：可在玩家加入服务器或进入特定世界（如大厅）时，自动给予打开 GUI 的指定物品。
• 物品属性：用于打开 GUI 的物品支持自定义名称、描述等完整属性。
• 快捷命令：可使用 /worldselector 命令直接打开 GUI。

🎮变量支持

目前支持的变量有

• %playername%：使用 GUI 的玩家名称。
• %onlineplayers%：当前服务器在线玩家总数。
• %worldonlineplayers%：目标世界内的当前在线玩家数。

未来将更新更多变量。如有建议，请通过资源页或私信联系作者。

🔧命令与权限

主要命令与权限

• worldselector.get

- 允许玩家使用 `/worldselector` 命令。

- 根据配置，此命令会直接打开 GUI 或给予打开 GUI 的物品。

• worldselector.admin

- 允许使用 `/worldselector` 主命令及其所有子命令。

- **子命令列表**：

- `reload`：重载配置文件。

- `setspawn`：设置当前世界的玩家传送点。

- `getworld`：获取当前世界的名称。

- `reference`：打开一个包含 54 个编号槽位的参考界面，便于配置 GUI 布局。

- `debug`：开启调试模式。遇到错误时使用，有助于定位问题。

- `addworld`：将当前所在世界添加到“允许使用 GUI 的世界”列表中（也可在配置文件中完成）。

槽位权限

• worldselector.slot.x

- `x` 为 1 到 54 之间的数字。

- 默认所有玩家都拥有此权限。

- 如果玩家没有某个槽位（例如 `worldselector.slot.5`）的权限，则该槽位将显示配置文件中 `replacement` 项定义的物品，而非原设定物品。这可用于创建仅对管理员或 VIP 可见的世界入口。

✨安装与使用

安装步骤

• 下载插件。
• 将 .jar 文件放入服务器的 /plugins 文件夹。
• 重启或重载服务器。
• 配置插件。

配置与使用指南

请按以下步骤设置插件（步骤虽多，但操作简单）

• 前往你希望设置为传送目标的世界，使用 /worldselector getname 获取该世界名称并记录。
• 编辑配置文件中的 Slots 部分，配置每个槽位显示的物品。
• 对于每个希望用于传送的物品，将其 teleport 下的 enabled 设为 true，并填入第一步获取的 destination 世界名称。
• 前往目标世界，使用 /worldselector setspawn 设置玩家传送点。
• 前往你希望玩家使用物品打开 GUI 的世界（例如主城），获取其名称并添加到配置文件 allow-use-in-world 列表中。
• 在配置文件的 general.GUI-item 部分，选择用于打开 GUI 的物品（默认为指南针 COMPASS）。
• 如果一切正确，右键点击该物品应显示配置好的世界列表，点击即可传送。

⭐配置文件详解

配置文件采用 YAML 格式，以下为关键部分说明：

通用设置 (`general:`)

• GUI-item:：定义用于打开 GUI 的物品。

- `item`: 物品材质（如 `COMPASS`）。

- `item-name`: 物品显示名称。

- `lore`: 物品描述。

• GUI:：定义 GUI 界面本身。

- `inventory-name`: GUI 界面标题。

- `inventory-slots`: 槽位数量（9 到 54 之间，且为 9 的倍数）。

• options:：功能选项。

- `debug`: 调试模式开关。

- `worldselector-command`: 控制 `/worldselector` 命令的行为（给予物品或直接打开 GUI）。

• GUI-item-give:：控制物品发放。

- `give-item-in-worlds`: 允许发放物品的世界列表。

- `on-server-join` / `on-world-join`: 控制玩家加入服务器或进入特定世界时是否自动获得物品。

槽位设置 (`Slots:`)

• 格式为 slot-编号:，例如 slot-1:。
• 每个槽位可配置：

- `item`: 显示的物品材质。

- `name`: 物品显示名称（支持变量和颜色代码）。

- `lore`: 物品描述。

- `teleport:`：传送设置。

- `enabled`: 是否启用点击传送。

- `destination`: 目标世界名称。

- `message`: 传送后的欢迎消息。

• replacement:：当玩家没有某个槽位的权限时，该槽位将显示此处定义的替代物品。

世界出生点 (`world-spawn:`)

• 此部分会在使用 /worldselector setspawn 后自动生成，记录每个世界的传送坐标，无需手动编辑。

**配置注意事项**

• 复制槽位配置时，请保持缩进一致（使用空格，而非 Tab 键）。
• 无法配置两个完全相同的物品（指材质和名称都相同）。
• 可使用 /worldselector reference 命令查看槽位编号参考界面。

❓常见问题与提示

• 如何获得打开 GUI 的物品（如指南针）？

- 该物品是原版物品（默认是指南针），可从创造模式物品栏获取，或通过其他插件在玩家加入时发放。本插件也提供了在特定世界自动发放物品的功能。

• 权限如何工作？

- 玩家需要 `worldselector.get` 权限才能使用命令。

- 使用 `worldselector.slot.x` 权限可以精细控制每个世界入口的可见性。

• 计划更新内容

- 未来计划添加 `%worldplaytime%`（世界游玩时间）和 `%serverplaytime%`（服务器总游玩时间）等变量。

🔧其他信息

• 如发现漏洞或有任何问题，请前往 Discord 或插件讨论区反馈。
• 如果你喜欢这个插件，请留下积极的评价！
• 欢迎提出任何未来更新的建议。
• 非常喜欢这个插件？可以考虑捐赠支持作者！