World Manager
Eranio
World Manager
The World page manages every world on the server: permanent server worlds (for example default or a farm world), player worlds, the adventure content of Hytale 0.7 (world events, portals, void invasions), warps, time and weather.
Viewing needs hytale-admin.world-read, every change needs hytale-admin.world-manage. All data comes live from the HytaleAdminAPI mod; if the server does not answer, the page shows a notice and tries again every 10 seconds.
Worlds
Server worlds
Server worlds are shown as compact cards, the default world always first. Each card shows the name, generator (Normal, Flat, Void), size on disk, online players and badges for special settings (PvP, frozen NPCs, paused time and so on).
All actions sit in the three-dot menu of the card, split into two sections:
| Section | Action | What it does |
|---|---|---|
| World | Settings | Display name, game mode, PvP, fall damage, NPC spawning, frozen NPCs, paused time |
| World | Set spawn | At a player's position or by coordinates. The form is always prefilled with the current spawn, so confirming without changes moves nothing |
| World | World events | Turn Hytale's world events (for example goblin raids) on or off |
| World | Send player | Teleports an online player to the spawn of this world |
| Management | Set as default | New players and players without a valid world join here |
| Management | Unload | Saves and unloads the world, it stays on disk |
| Management | Reset | Deletes the world and generates it again with a new seed (farm world). Settings and display name stay. Optionally all warps of the world move to the new spawn. Confirm by typing the world name |
| Management | Move to trash | Moves the world folder to universe/worlds-trash |
Create a world
Create world asks for a name (a-z, 0-9, _ and -, 2 to 32 characters), the generator (Normal, Flat, Void), a display name, the game mode and the same switches as the settings. Created worlds are loaded by Hytale on every start.
Unloaded worlds and trash
Worlds that exist on disk but are not loaded can be loaded again or moved to the trash. The trash lists every deleted world with its date; entries can be restored (moved back and loaded) or deleted permanently.
Player worlds
Player worlds are listed in their own collapsible section as a table with search, a status filter and 25/50/100 rows per page.
| Column | Meaning |
|---|---|
| Name | Folder name, with the display name below |
| Owner | Player who owns the world |
| Status | Loaded, Unloaded or Parked (hover for an explanation) |
| Access | Locked or Unlocked, plus the number of members and guests (names on hover) |
| Players | Number of players currently inside |
| Size | Size on disk |
Row menu: settings, send player, load, park, reset, change type (server world or player world with owner) and move to trash.
Parked worlds
Parked worlds live in universe/worlds-parked. Hytale loads every folder in universe/worlds at start, so player worlds are parked and only loaded when they are needed. A load test with 100 empty worlds showed about 95 MB RAM, 0.75 % of one CPU core and 3 to 5 threads per loaded world.
Player world settings
The button Player world settings above the table controls the in-game system:
| Setting | Default | Meaning |
|---|---|---|
| Players may create their own worlds | on | Turns /myworld creation on or off |
| Worlds per player | 1 | 0 turns own worlds off. Players with hytaleadmin.worlds.bypass have no limit |
| Park an empty world after (minutes) | 5 | Empty player worlds are unloaded and parked after this time |
How players create and share their worlds in game is described in the guide Player Worlds.
Adventure (Hytale 0.7)
For every permanent world the page shows its adventure state:
- World events on or off
- Portal worlds with portal type, remaining time and timer state. Time can be changed by -1, +1 or +5 minutes and the timer can be paused
- Void invasion per portal: the stages are read from the configuration of that portal, so every portal variant works. The card shows the current stage, a timeline with the start times and a live countdown to the next stage. Stop invasion removes the invasion and holds its counter while the portal time keeps running; Allow invasion again resets the plan. After a time change the mod rebuilds an invasion immediately if it is due
- Players in the world, with the option to lock the debug screen (F3) per player
Temporary instance worlds (portals, dungeons) are not listed here. They appear on the Dashboard under Active instances.
Warps
Warps use Hytale's own warp system (TeleportPlugin), so warps created in the panel work in game with /warp <name> and /warp list, and warps created in game (also by teleporter blocks) show up in the panel.
| Action | Details |
|---|---|
| Create warp | At the position of an online player (with view direction) or with world and coordinates |
| Teleport player here | Works across worlds and adds an entry to the player's /back history |
| Delete warp | Removes the warp from Hytale's list |
The list shows name, world, coordinates and creator.
Time and weather
| Action | API | Notes |
|---|---|---|
| Set time | POST /api/world/time |
midnight, sunrise, noon or sunset, applies to the first loaded world (normally the default world) |
| Show weather per zone | GET /api/world/weather |
Current weather, possible weathers and players per zone (HytaleAdminAPI 1.15.0 and later) |
| Set weather of a zone | POST /api/world/weather/zone |
Zone 0 to 4, a weather ID of that zone or natural for the game forecast |
| Force for the whole world | POST /api/world/weather |
One weather ID for every zone, or natural to lift it |
Weather per zone
Hytale does not pick one weather for the whole world, it picks a new one for every zone each in-game hour from that zone's forecast. The "Weather per zone" section of the dashboard shows the current weather and who is there for zone 0 (Ocean), zone 1 (Emerald Grove), zone 2 (Howling Sands), zone 3 (Borea) and zone 4 (Devastated Lands).
- Natural: Hytale decides, the weather follows the zone forecast.
- Fixed: Chosen with "Change weather". It stays through hour changes and restarts until the zone is set back to "Natural".
- It applies on the surface. Caves, mines, dungeons and underground areas keep their own weather.
- Hytale only gives the ocean sunshine, cloudy, fog, rain and storm can be chosen in addition.
- Force for the whole world overrides every zone. While it is on, the per-zone settings are paused and come back when it is switched off.
Servers with an older HytaleAdminAPI show the four simple weather buttons instead.
Troubleshooting
"The server is not answering"
- The server is offline or still starting. The page tries again every 10 seconds
- HytaleAdminAPI is not installed or older than the plugin expects. Install the mod that ships with the plugin
A world cannot be unloaded, parked or reset
- Players are still inside. Send them to another world first
- The default world cannot be unloaded. Set another default world first
A world disappears after a restart
- Player worlds are parked on purpose before the server starts. They load again when the owner enters or logs in inside the world