PerWorldChange

PerWorldChange 1.3.0 · 跨世界背包 · 游戏模式 · 世界切换

PerWorldChange 是一款轻量级 Hytale 服务端插件，用于管理多个世界中的背包和游戏模式。可以将世界分组以共享背包，或让其他世界完全隔离，自动在进入世界时应用游戏模式，并支持地牢或副本世界而无需担心背包问题。所有设置均通过简单的 config.json 文件控制，1.3.0 版本新增了热重载支持。

✦ 主要特性

🎒 跨世界背包
创建背包组，让组内世界共享同一背包，或让每个世界完全独立。在同一背包组的世界间切换时，玩家保留其物品；切换到不同组时，则加载该组的已保存背包。

🗺️ 地牢与副本支持
地牢和副本世界可以从其父世界或源世界继承背包。玩家可以带着合适的装备进入地牢，返回时不会出现背包切换错误或物品丢失。

🎮 跨世界游戏模式
为每个世界设置特定的游戏模式。玩家进入世界时自动切换到配置的游戏模式，非常适合创造建筑世界、生存世界、冒险地图、活动世界等。

💾 玩家游戏模式记忆
1.3.0 新增：未明确配置游戏模式的世界会记住每个玩家在该世界最后使用的游戏模式。如果管理员在建筑世界将玩家设为创造模式，PerWorldChange 会在玩家返回时恢复该模式，而非强制恢复为服务器默认。

🗂️ 背包分组
将多个世界分组以共享一个背包。例如，所有生存世界可以共享装备，而创造世界则与生存物品保持隔离。

🌟 通配符支持
在世界名称中使用通配符，如 instance-creativehub*，可自动将背包和游戏模式规则应用于动态创建的世界或世界实例。

🔁 配置热重载
1.3.0 新增：运行 /pwc reload 可重新加载 config.json 而无需重启服务器。如果 JSON 格式错误，插件会保持之前有效的配置并记录清晰的错误信息。

⚙️ 简单 JSON 配置
所有配置都在简洁的 config.json 文件中完成。使用易于阅读的 JSON 语法定义背包组、世界游戏模式、实例模式及调试模式。

🐛 更好的调试日志
调试模式现在会记录玩家名称、源世界、目标世界、解析的背包组以及应用的游戏模式，以便更轻松地诊断世界切换行为。

🖥️ 服务器兼容
为 Hytale 专用服务器和单人游戏服务器构建的 Java 插件。轻量、专注，旨在保证世界切换流畅。

✦ 配置示例

配置文件（config.json）在首次运行时自动生成于插件数据目录。

{
  "configVersion": "1.3.0",
  "debug": false,
  "inventoryGroups": {
    "survival": [
      "V2",
      "default_world"
    ],
    "creative": [
      "default",
      "instance-creativehub*"
    ]
  },
  "worldGamemodes": {
    "V2": "Adventure",
    "default_world": "Adventure",
    "default": "Creative",
    "instance-creativehub*": "Creative"
  },
  "instanceWorlds": [
    "instance-*",
    "instance-creativehub*"
  ]
}

配置说明：

• 背包组： 世界 V2 和 default_world 共享一个生存背包。世界 default 和 instance-creativehub* 共享一个创造背包。
• 世界游戏模式： V2 和 default_world 设为冒险模式。default 及匹配 instance-creativehub* 的世界设为创造模式。
• 通配符： * 表示任何以 instance-creativehub 开头的世界都将使用创造背包组和创造模式。
• 地牢副本： 副本世界可以自动使用其父世界或源世界的背包组。
• 游戏模式记忆： 如果某个世界未在 worldGamemodes 中列出，插件可以记住玩家在该世界最后使用的游戏模式。

✦ 命令

• /pwc reload — 无需重启服务器即可重新加载 config.json。
• /perworldchange reload — 重载命令的别名。

✦ 为什么选择 PerWorldChange？

如果你运行一个多世界服务器，并希望不同世界有不同的规则、背包或游戏模式，这款插件可以帮你化繁为简。不再有创造模式物品泄露到生存世界，不再需要在每次世界切换后重复手动设置游戏模式，地牢副本的麻烦也更少。配置一次，需要时重新加载，让插件来处理切换。

✦ 安装方法

1. 从本页面下载 .jar 文件。
2. 将 PerWorldChange-1.3.0.jar 放入服务器的 mods/ 文件夹。
3. 重启服务器。
4. 编辑生成的 config.json 文件以设置背包组和世界游戏模式。
5. 编辑配置后运行 /pwc reload，或重启服务器。
6. 切换世界进行测试；背包和游戏模式的行为应符合你的配置。

⚠️ 要求： Hytale 抢先体验版服务器构建 2026.03.26-89796e57b · 无外部服务器依赖 · 推荐多世界服务器设置

✦ 社区与支持

🌐 Premium Arcanum | 💬 Discord 服务器

感谢你关注 PerWorldChange。如有问题、疑问或反馈，请加入上方 Discord 服务器。

由 PrimeEcto 使用 Hytale 官方插件 API 创建。