PerWorldChange

PerWorldChange 1.3.0 · Per-World Inventories · Gamemodes · World Switching

PerWorldChange is a lightweight Hytale server plugin for managing inventories and gamemodes across multiple worlds. Group worlds together to share inventories, keep other worlds fully isolated, automatically apply gamemodes on world entry, and support dungeon or instance worlds without inventory headaches. Everything is controlled through a simple config.json file, with hot-reload support added in version 1.3.0.

✦ Key Features

🎒 Per-World Inventories
Create inventory groups where worlds share the same inventory, or keep each world completely separate. Players switching between worlds in the same group keep their items; switching to a different group loads that group's saved inventory.

🗺️ Dungeon & Instance Support
Dungeon and instance worlds can inherit inventory from their parent or origin world. Players can enter dungeons with the right gear, then return without inventory switching glitches or lost items.

🎮 Per-World Gamemodes
Set specific gamemodes for each world. Players are automatically switched to the configured gamemode when they enter a world, which is perfect for creative build worlds, survival worlds, adventure maps, event worlds, and more.

💾 Per-Player Gamemode Memory
New in 1.3.0: worlds without an explicit configured gamemode remember each player's last gamemode for that world. If an admin puts a player in Creative in a build world, PerWorldChange restores that mode when they return instead of forcing them back to the server default.

🗂️ Inventory Grouping
Group multiple worlds together to share one inventory. For example, all survival worlds can share gear while creative worlds stay isolated from survival items.

🌟 Wildcard Support
Use wildcards in world names, such as instance-creativehub*, to automatically apply inventory and gamemode rules to dynamically created worlds or world instances.

🔁 Config Hot-Reload
New in 1.3.0: run /pwc reload to reload config.json without restarting the server. If the JSON is malformed, the plugin keeps the previous valid config active and logs clear errors.

⚙️ Simple JSON Config
Configure everything in a clean config.json file. Define inventory groups, world gamemodes, instance patterns, and debug mode with easy-to-read JSON syntax.

🐛 Better Debug Logging
Debug mode now logs player name, source world, destination world, resolved inventory group, and applied gamemode so it is easier to diagnose world-switching behavior.

🖥️ Server Compatible
Java plugin built for Hytale dedicated and singleplayer servers. Lightweight, focused, and designed to keep world switching smooth.

✦ Configuration Example

The config file (config.json) is automatically generated on first run in the plugin data directory.

{
  "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*"
  ]
}

What this does:

• Inventory Groups: Worlds V2 and default_world share a survival inventory. Worlds default and instance-creativehub* share a creative inventory.
• World Gamemodes: V2 and default_world are set to Adventure mode. default and worlds matching instance-creativehub* are set to Creative mode.
• Wildcards: The * means any world starting with instance-creativehub will use the creative inventory group and Creative mode.
• Dungeon Instances: Instance worlds can automatically use their parent or origin world's inventory group.
• Gamemode Memory: If a world is not listed in worldGamemodes, the plugin can remember the player's last gamemode for that world.

✦ Commands

• /pwc reload — Reloads config.json without restarting the server.
• /perworldchange reload — Alias for the reload command.

✦ Why PerWorldChange?

If you run a multi-world server and want different worlds to have different rules, inventories, or gamemodes, this plugin keeps it simple. No more creative items leaking into survival worlds, no more repeated manual gamemode commands after every world switch, and fewer headaches around dungeon instances. Configure it once, reload when needed, and let the plugin handle the switching.

✦ Installation

1. Download the .jar from this page.
2. Place PerWorldChange-1.3.0.jar in your server's mods/ folder.
3. Restart the server.
4. Edit the generated config.json file to set up inventory groups and world gamemodes.
5. Run /pwc reload after config edits, or restart the server.
6. Test by switching between worlds; inventory and gamemode behavior should follow your config.

⚠️  Requirements:  Hytale Early Access release server build 2026.03.26-89796e57b  ·  No external server dependencies  ·  Multi-world server setup recommended

✦ Community & Support

🌐 Premium Arcanum  |  💬 Discord Server

Thanks for checking out PerWorldChange. For issues, questions, or feedback, join the Discord above.

Created by PrimeEcto using Hytale's official plugin API.