SEPARE WORLD ITEMS - 多世界独立背包

Separe World Items 是一款用于为不同世界分离玩家物品栏的 Minecraft 插件，非常适合拥有多种游戏模式的网络服务器或综合性服务器。它支持从 1.8 到 1.21.X 的版本。

💡重要通知

• 版本 2.0.0 即将发布，因此版本 1.0.0 将不再维护。
• 新版代码更优化，并为其他开发者提供了更友好的 API。
• 如果您发现任何错误，请通过 Discord 联系我进行修复，请不要直接留下差评。

🎮功能特性

• 为服务器中的不同世界创建独立的玩家物品栏。
• 代码经过优化，性能更佳。
• 提供开发者 API，便于集成和扩展。

🔧命令列表

• /swi help - 查看插件帮助信息。
• /swi reload - 重载插件配置文件。
• /swi update - 更新插件。
• /swi api - 查看 API 相关信息。

✨依赖项 (可选)

• MultiverseCore: 用于管理多世界。如果您需要此功能，请安装。
• 链接: https://dev.bukkit.org/projects/multiverse-core

❓配置与权限

• 配置文件 Wiki: https://github.com/Happyuky7/SEPARE-WORLD-ITEMS/wiki/Config
• 权限列表 Wiki: https://github.com/Happyuky7/SEPARE-WORLD-ITEMS/wiki/Permissions

⭐教程与资源

• 西班牙语教程:
• 版本 1.2.10 (由 @Siriusv 制作)
• 版本 1.2.7
• 英语教程: 暂无
• API 文档: https://github.com/Happyuky7/SEPARE-WORLD-ITEMS/wiki/API
• 使用示例服务器: mc.kaory.xyz

💡许可协议

完整协议请查看: https://github.com/Happyuky7/SEPARE-WORLD-ITEMS/blob/master/LICENSE.txt

**主要条款如下**

• 请勿在任何平台或网页上将本插件声称是您自己的作品。
• 请勿出售本插件，它是免费使用的。
• 在任何配置使用本插件的服务器上，请保留原作者 credits。

🎮链接与支持

• GitHub 项目: https://github.com/Happyuky7/SEPARE-WORLD-ITEMS
• Discord 社区: https://discord.gg/3EebYUyeUX
• 捐赠支持: https://www.paypal.me/Happygg

感谢所有用户的支持，插件下载量已突破 12000！

💡插件简介

SEPARE-WORLD-ITEMS 是一个轻量级的 Minecraft 插件，它允许服务器管理员为不同的世界设置独立的物品使用、破坏和放置规则。通过简单的配置，你可以精确控制玩家在各个世界（如主世界、资源世界、生存世界等）中能与哪些方块或物品交互，从而轻松实现世界隔离与资源管理。

🎮主要功能

• 世界物品隔离：为每个世界单独配置可被使用、破坏和放置的物品列表。
• 灵活的规则控制：支持为每个世界独立启用或禁用使用、破坏、放置三种交互类型。
• 详细的交互反馈：当玩家尝试进行被禁止的操作时，会收到清晰的自定义提示消息。
• 简易配置：所有规则均通过直观的 config.yml 文件进行管理，无需修改代码。
• 权限支持：可配置权限节点，允许特定玩家绕过规则限制。

🔧命令与权限

命令

• /swi reload - 重载插件的配置文件。

- 权限节点：`separeworlditems.reload`

权限

• separeworlditems.reload - 允许使用 /swi reload 命令重载配置。
• separeworlditems.bypass - 允许玩家绕过所有世界的物品交互限制。

✨安装与配置

安装步骤

• 确保服务器已安装 Spigot、Paper 或兼容的服务器核心。
• 将下载的 Separe-World-Items.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器以生成默认配置文件。
• 根据需求编辑 plugins/Separe-World-Items/config.yml 文件。

配置文件详解

配置文件 (config.yml) 结构如下。你可以为每个世界设置规则：

worlds:
  world:
    enabled: true
    break:
      enabled: true
      list:
        - GRASS_BLOCK
        - DIRT
    use:
      enabled: true
      list:
        - FLINT_AND_STEEL
        - BUCKET
    place:
      enabled: true
      list:
        - TNT
        - LAVA_BUCKET
  world_nether:
    enabled: true
    break:
      enabled: false
      list: []
    use:
      enabled: true
      list:
        - FIRE_CHARGE
    place:
      enabled: false
      list: []

• worlds: 此节点下每个键（如 world, world_nether）代表一个世界名称。
• enabled: 控制此世界的全部规则是否生效。
• break/use/place:

- `enabled`: 控制此项交互（破坏/使用/放置）的规则是否生效。

- `list`: 一个物品ID列表。当规则启用时，列表定义了**允许**进行的操作。如果列表为空，则对应操作将被完全禁止。

配置示例说明

• 在 world（主世界）中：

- 玩家只能破坏 `GRASS_BLOCK` 和 `DIRT`。

- 玩家只能使用 `FLINT_AND_STEEL` 和 `BUCKET`。

- 玩家只能放置 `TNT` 和 `LAVA_BUCKET`。

• 在 world_nether（下界）中：

- `break` 和 `place` 规则被禁用 (`enabled: false`)，意味着玩家可以自由破坏和放置任何方块。

- `use` 规则启用，但列表为空，意味着玩家不能使用任何物品（除了在 `list` 中的 `FIRE_CHARGE`）。

❓常见问题 (FAQ)

• 如何找到正确的物品/方块ID？

- 插件使用标准的 Bukkit/Spigot 材料枚举名。你可以在 Spigot 的 JavaDoc 或通过游戏内命令（如其他插件）查询。确保在配置中使用的ID全部大写且以下划线连接（例如 `STONE`, `DIAMOND_SWORD`）。

• 玩家拥有 separeworlditems.bypass 权限会怎样？

- 拥有此权限的玩家将不受任何世界中配置的物品使用、破坏、放置规则的限制。

• 如何添加对新世界的支持？

- 只需在 `config.yml` 文件的 `worlds:` 节点下，新增一个以该世界准确名称命名的配置块，并参照示例设置 `enabled`, `break`, `use`, `place` 即可。

• 修改配置后需要重启服务器吗？

- 不需要完全重启。你可以使用拥有 `separeworlditems.reload` 权限的账号执行 `/swi reload` 命令来重载配置。

⭐注意事项

• 请确保输入的世界名称与服务器中加载的世界名称完全一致（区分大小写）。
• 列表中的物品ID若填写错误，该条规则将不会正常生效。
• 本插件主要控制玩家交互。对于更复杂的世界保护（如防爆、生物生成等），你可能需要搭配其他领地或保护插件使用。

🔧支持与信息

• 插件 Wiki 与最新信息：请访问 GitHub Wiki 页面。
• 在使用中遇到问题或需要帮助，建议首先查阅上述 Wiki 页面。