HytaleAdminAPI Documentation
Complete REST API for managing and monitoring Hytale servers
Quick Start
Test the API with a simple status check:
curl -H 'X-Admin-Token: YOUR_TOKEN' http://localhost:5550/api/status
Response:
{
"online": true,
"online_players": 3,
"default_world": "default",
"world_count": 2,
"server_name": "Hytale Server",
"max_players": 100,
"version": "0.7.0",
"cpu_system": 11,
"cpu_process": 4,
"ram_total_mb": 16384,
"ram_free_mb": 9120,
"ram_used_mb": 7264,
"heap_used_mb": 1444,
"heap_max_mb": 8192,
"heap_percent": 17,
"jvm_uptime": "2h 15m",
"jvm_uptime_ms": 8100000,
"uptime": "2h 14m",
"uptime_ms": 8040000,
"tps": 30.0,
"installed_mods_count": 2
}
API Reference
Status
/api/status
Server state, resources, players and installed mods at a glance
Statistics
/api/stats
JVM memory and processor figures
Version
/api/version
Server version, revision and protocol
Players
/api/players
Online and known players, actions and inventory
Chat
/api/chat
Chat history, events and broadcasts
Bans
/api/bans
Ban and unban players, also offline
Mutes
/api/mutes
Mute players for a time or permanently
World
/api/world
Time, forced weather and weather per zone
Warps
/api/warps
Hytale's own warps, usable in game with /warp
Items
/api/items
Item catalogue with search and icons
Icons
/api/icons
Item icons as PNG
Permissions
/api/permissions
Users, groups and OP in permissions.json
Whitelist
/api/whitelist
Allow players by name or UUID, also before their first visit
Server config
/api/serverconfig
Read and change Hytale's config.json
Backups
/api/backup
Hytale's built-in universe backups
Deaths
/api/deaths
Latest player deaths
Memories
/api/memories
Discovered memories of the server
Adventure
/api/adventure
Hytale 0.7: world events, portals, void invasions, instances and player tools
Worlds
/api/worlds
Create, load, park, reset and delete permanent worlds
Player worlds
/api/playerworlds
Worlds that players create in game with /myworld
Guides
Architecture & Overview
# Architecture & Overview **HytaleAdminAPI** (current version 1.15.0, built aga...
Eranio
Authentication
# Authentication Every request needs the header `X-Admin-Token` with the token...
Eranio
Configuration
# Configuration The mod reads `mods/Eranio_HytaleAdminAPI/config.json`. The fil...
Eranio
Error Handling
# Error Handling ## Status codes | Code | When | |------|------| | `200` | Nor...
Eranio
Persistence & Data
# Persistence & Data The mod keeps no database. Data lives in files on the Hyta...
Eranio
Background Processes
# Background Processes ## Backups `POST /api/backup/create` calls Hytale's own...
Eranio
PHP Client Example
# PHP Client Example A simple PHP client for the HytaleAdminAPI. ## Base Class...
Eranio