API Playground
Test API endpoints directly in your browser.
Base URL
Status /api/status
/api/status
Returns online state, player count, default world, TPS, CPU and RAM usage, uptime and the number of installed mods.
Response
Statistics /api/stats
/api/stats
Returns heap usage, free and maximum memory and available processors.
Response
Version /api/version
/api/version
Returns the Hytale server version, build revision and protocol version.
Response
Players /api/players
/api/players
Returns all online players with position, world, game mode, health and stats, plus offline players known to the mod.
Response
/api/players/known
Lightweight list of every player that has been on the server (name, UUID, last seen).
Response
/api/players/{name}
Returns the same detailed data as the list for one online player.
Parameters
name
string
*
Response
/api/players/{name}/inventory
Returns hotbar, storage, armor, utility, backpack and tools with item IDs, amounts and icons.
Parameters
name
string
*
Response
/api/players/{name}/kick
Disconnects an online player with a message.
Parameters
name
string
*
Request Body
reason
string
Response
/api/players/{name}/op
Gives the player operator rights.
Parameters
name
string
*
Response
/api/players/{name}/deop
Removes operator rights from the player.
Parameters
name
string
*
Response
/api/players/{name}/teleport
Teleports the player to coordinates in their current world.
Parameters
name
string
*
Request Body
x
number
*
y
number
*
z
number
*
Response
/api/players/{name}/give
Adds an item to the inventory, hotbar first.
Parameters
name
string
*
Request Body
item
string
*
amount
integer
Response
/api/players/{name}/heal
Restores the player to full health.
Parameters
name
string
*
Response
/api/players/{name}/gamemode
Switches the player between Adventure and Creative.
Parameters
name
string
*
Request Body
gamemode
string
*
Response
/api/players/{name}/inventory/clear
Empties hotbar, storage, armor, utility, backpack and tools.
Parameters
name
string
*
Response
/api/players/{name}/inventory/slot
Places an item into a specific slot and replaces what was there.
Parameters
name
string
*
Request Body
item
string
*
amount
integer
section
string
slot
integer
Response
/api/players/{name}/inventory/slot/remove
Removes the item from one slot.
Parameters
name
string
*
Request Body
section
string
slot
integer
Response
/api/players/{name}/inventory/slot/swap
Swaps two slots, also between containers (for example storage and hotbar).
Parameters
name
string
*
Request Body
fromSection
string
fromSlot
integer
toSection
string
toSlot
integer
Response
Chat /api/chat
/api/chat
Returns the latest chat messages or entries of another event log (for example playerJoin, playerLeave, broadcast).
Query Parameters
limit
integer
eventType
string
Response
/api/chat/broadcast
Sends a message to all online players.
Request Body
message
string
*
Response
Bans /api/bans
/api/bans
Returns all banned players with reason and date.
Response
/api/bans
Bans a player, online or offline. Unknown names are resolved through the Hytale profile service.
Request Body
player
string
*
reason
string
Response
/api/bans/{player}
Removes a ban.
Parameters
player
string
*
Response
Mutes /api/mutes
/api/mutes
Returns all muted players with reason, moderator and end time.
Response
/api/mutes
Mutes a player; muted players cannot write in chat.
Request Body
player
string
*
reason
string
muted_by
string
duration_minutes
integer
Response
/api/mutes/{player}
Removes a mute.
Parameters
player
string
*
Response
World /api/world
/api/world
Returns name, time of day and forced weather of the first loaded world.
Response
/api/world/time
Sets the time of day.
Request Body
time
string
*
Response
/api/world/weather
Returns the current surface weather of zones 0 to 4, the weathers each zone can have, the weather fixed per zone and which players are where.
Parameters
world
string
Response
/api/world/weather/zone
Fixes the weather of one zone or gives it back to the game forecast with natural.
Request Body
zone
string
*
weather
string
*
world
string
Response
/api/world/weather
Forces one weather for the whole world, overriding every zone. natural lifts it again.
Request Body
weather
string
*
world
string
Response
Warps /api/warps
/api/warps
Returns all warps with world, position, rotation and creator, including warps created in game.
Response
/api/warps
Creates a warp at a player's position or at coordinates.
Request Body
name
string
*
player
string
world
string
x
number
y
number
z
number
replace
boolean
creator
string
Response
/api/warps/{name}/tp
Teleports an online player to the warp, also across worlds.
Parameters
name
string
*
Request Body
player
string
*
Response
/api/warps/{name}
Removes a warp.
Parameters
name
string
*
Response
Items /api/items
/api/items
Returns every item of the running server (Hytale 0.7.0: 4008) with type, name and icon.
Query Parameters
q
string
type
string
Response
/api/items/search
Same as the list, meant for search requests.
Query Parameters
q
string
type
string
Response
Icons /api/icons
/api/icons/{itemId}/icon
Returns the icon of an item as image/png.
Parameters
itemId
string
*
Response
Permissions /api/permissions
/api/permissions
Returns all users with their groups and all groups with their permission nodes.
Response
/api/permissions/groups
Returns only the groups.
Response
/api/permissions/op
Gives a player operator rights by UUID.
Request Body
uuid
string
*
Response
/api/permissions/op/{uuid}
Removes operator rights.
Parameters
uuid
string
*
Response
/api/permissions/user/group
Puts a player into a group.
Request Body
uuid
string
*
group
string
*
Response
/api/permissions/user/group
Takes a player out of a group.
Request Body
uuid
string
*
group
string
*
Response
/api/permissions/groups
Creates a permission group.
Request Body
name
string
*
permissions
array
Response
/api/permissions/groups/{name}
Deletes a permission group.
Parameters
name
string
*
Response
Whitelist /api/whitelist
/api/whitelist
Returns whether the whitelist is enabled and all entries.
Response
/api/whitelist
Adds a player. Unknown names are resolved through Hytale's whitelist command; success is only reported when Hytale confirms.
Request Body
name
string
uuid
string
Response
/api/whitelist/{name}
Removes a player from the whitelist.
Parameters
name
string
*
Response
Server config /api/serverconfig
/api/serverconfig
Returns the complete config.json of the server.
Response
/api/serverconfig
Updates one or more keys of config.json. Most changes need a restart.
Request Body
<key>
any
Response
/api/serverconfig/reload
Reads config.json from disk again.
Response
Backups /api/backup
/api/backup
Returns all backup zip files with size and date.
Response
/api/backup/config
Returns Hytale's backup configuration (folder, interval, retention).
Response
/api/backup/status
Shows whether a backup is running and the result of the last one.
Response
/api/backup/create
Starts a backup of the universe with Hytale's own backup function.
Response
/api/backup
Deletes one backup file.
Request Body
filename
string
*
Response
Deaths /api/deaths
/api/deaths
Returns the last 10 deaths with time, player and cause, plus the total count.
Response
Memories /api/memories
/api/memories
Returns all memory categories and entries with discovery state and translated names. Memories are server-wide.
Response
Adventure /api/adventure
/api/adventure
Returns every loaded world (permanent or instance) with world events, spawn, portal state, void invasion stages and players with size, teleport history, wilderness map and debug lock; also the instance templates.
Response
/api/adventure/world-events
Turns Hytale's world events (for example goblin raids) on or off for one world.
Request Body
world
string
enabled
boolean
*
Response
/api/adventure/portal/time
Changes the remaining time of a portal world, between 10 seconds and 6 hours.
Request Body
world
string
seconds
integer
*
mode
string
Response
/api/adventure/portal/timer
Toggles the time limit of a portal world.
Request Body
world
string
Response
/api/adventure/portal/void
stop removes the invasion and holds its counter while the portal time keeps running; allow resets the plan.
Request Body
world
string
action
string
*
Response
/api/adventure/debug-screens
Locks or unlocks the debug screen (F3) for a player.
Request Body
player
string
*
blocked
boolean
*
Response
/api/adventure/teleport-player
Teleports a player to another player, also across worlds.
Request Body
player
string
*
target
string
*
Response
/api/adventure/spawn
Sets the spawn point of a world at a player's position or at coordinates.
Request Body
player
string
world
string
x
number
y
number
z
number
Response
/api/adventure/send-to-spawn
Sends a player to the spawn of a world.
Request Body
player
string
*
world
string
Response
/api/adventure/scale
Scales a player between 25 and 400 %.
Request Body
player
string
*
scale
number
*
Response
/api/adventure/history
Moves a player one step back or forward in the teleport history (like /back).
Request Body
player
string
*
direction
string
Response
/api/adventure/wilderness
Shows or hides the wilderness debug map for a player.
Request Body
player
string
*
enabled
boolean
*
Response
/api/adventure/instance/spawn
Opens a new instance from a template and sends the player in. On leaving the player returns to the old position.
Request Body
template
string
*
player
string
*
Response
/api/adventure/instance/exit
Brings a player out of an instance back to the previous world.
Request Body
player
string
*
Response
/api/adventure/instance/close
Closes an empty instance.
Request Body
world
string
*
Response
Worlds /api/worlds
/api/worlds
Returns loaded worlds (default first) with type, owner, settings and size, plus unloaded, parked and trashed worlds and the available generators.
Response
/api/worlds/create
Creates a permanent world. Hytale loads it on every start.
Request Body
name
string
*
generator
string
kind
string
owner
string
display_name
string
game_mode
string
pvp
boolean
fall_damage
boolean
npc_spawning
boolean
npc_frozen
boolean
time_paused
boolean
Response
/api/worlds/load
Loads an unloaded world.
Request Body
name
string
*
Response
/api/worlds/unload
Saves and unloads a world; the folder stays.
Request Body
name
string
*
Response
/api/worlds/delete
Moves a world to the trash; nothing is deleted yet.
Request Body
name
string
*
Response
/api/worlds/restore
Moves a world back from the trash and loads it.
Request Body
folder
string
*
Response
/api/worlds/purge
Deletes a trash entry from disk.
Request Body
folder
string
*
Response
/api/worlds/park
Unloads a world and moves it to universe/worlds-parked, so Hytale does not load it on start.
Request Body
name
string
*
Response
/api/worlds/unpark
Moves a parked world back and loads it.
Request Body
name
string
*
load
boolean
Response
/api/worlds/mark
Marks a world as server world or player world with owner (for the panel).
Request Body
name
string
*
kind
string
owner
string
Response
/api/worlds/default
Makes a world the default world of the server.
Request Body
name
string
*
Response
/api/worlds/settings
Changes settings of a loaded world; only the given fields change.
Request Body
name
string
*
display_name
string
game_mode
string
pvp
boolean
fall_damage
boolean
npc_spawning
boolean
npc_frozen
boolean
time_paused
boolean
Response
/api/worlds/reset
Deletes a world and generates it again with a new seed (farm world). Generator, settings and display name stay.
Request Body
name
string
*
move_warps
boolean
Response
/api/worlds/send
Teleports a player to the spawn of another world.
Request Body
player
string
*
world
string
*
Response
Player worlds /api/playerworlds
/api/playerworlds
Returns the settings and every player world with display name, owner, members, guests, loaded and unlocked state.
Response
/api/playerworlds/config
Changes the global settings for player worlds.
Request Body
creation_enabled
boolean
max_per_player
integer
idle_park_minutes
integer
Response