Player Worlds

Eranio Published on: 13. October 2026

Player Worlds

With HytaleAdminAPI 1.14 players can create their own worlds in game, name them and decide who may enter. Admins control the limits in the panel (World page, Player world settings).

Commands

Command	Alias	Who	What it does
`/myworld`	`/meinewelt`	everyone	Opens the player world window
`/tpa <player>`	`/tpanfrage`	everyone	Asks a player to teleport to them (valid for 2 minutes)
`/tpaccept`	`/tpannehmen`	everyone	Accepts the open request
`/tpdeny`	`/tpablehnen`	everyone	Denies the open request

The window

The overview shows:

Your worlds: click a world to manage it
Worlds you are a member of: click to enter
Create a new world: enter a name (2 to 32 characters) and press create. New worlds use the normal Hytale generator. If the player already has the allowed number of worlds or creation is turned off, a notice replaces the form

Managing a world offers:

Button	Effect
Enter	Loads the world if it is parked and teleports you to its spawn
Unlock / Lock	Guests can only come in while the world is unlocked
Rename	Changes the display name
As member / As guest	Adds a player by name. The player must have been on the server at least once
Remove	Removes a member or guest. A player who is inside is sent back to the main world
Delete world	Moves the world to the trash after a confirmation. An admin can restore it from the trash

Roles

Role	Enter	Build
Owner	always	yes
Member	always (window or `/tpa`)	yes
Guest	only via `/tpa` while the world is unlocked	no
Everyone else	no	no

Guests cannot break, damage, place or use blocks. That includes doors and chests.

Players with the permission hytaleadmin.worlds.bypass (admins with all permissions have it) can enter every player world, build everywhere and have no world limit.

Lock after restart

Unlocking only lasts until the next server restart. After every restart all player worlds are locked, and the owner has to unlock the world again before guests can come in via /tpa.

Teleport requests

The visitor types /tpa <name>
The other player gets a chat message and answers with /tpaccept or /tpdeny
If the accepting player stands in a player world, the visitor is checked: owners and members always pass, guests only while the world is unlocked, everyone else is refused with a message on both sides

In server worlds /tpa works like a normal teleport request.

Protection against unauthorized entry

Every time a player enters a player world (warp, teleport, panel, login) the mod checks the access. A player without access is sent back to the spawn of the main world after one second with the message that the world is private.

Loading and parking

Server start: only server worlds load. Player worlds are moved to universe/worlds-parked before Hytale loads the worlds
Login: if a player logged out inside their own world (or one they are a member of), the world is loaded during the login and the player stands exactly where they logged out
No access anymore: if the last world of a player is locked for them or was deleted, the login goes to the main world instead (last position there, otherwise spawn) with the message "The world ... is locked" or "Your last world no longer exists"
Idle worlds: empty player worlds are parked after the time set in the panel (default 5 minutes)

Data

File	Content
`mods/Eranio_HytaleAdminAPI/player-worlds.json`	Owner, display name, members, guests, settings and the last world of each player
`mods/Eranio_HytaleAdminAPI/worlds-meta.json`	Type (server or player world) and owner shown in the panel
`universe/worlds-parked/`	Parked worlds
`universe/worlds-trash/`	Deleted worlds

Unlock state and accepted visitors are kept in memory only and reset with every restart.