HyRESTAPI

HyRESTAPI es un mod para servidores de Hytale que proporciona una API REST para gestionar jugadores, ejecutar comandos del servidor y monitorizar el estado del servidor a través de un endpoint http.

Instalación de HyRESTAPI

• Coloca HyRESTAPI-x.x.x.jar en la carpeta mods de tu servidor.
• Inicia tu servidor para generar la configuración predeterminada.
• Prueba si la API está lista en http://localhost:8080/api/health.

Endpoints

• GET /api/health – Comprueba el estado de la API.
• GET /api/server/status – Obtén información del servidor.
• GET /api/players – Lista todos los jugadores en línea.
• GET /api/players/{name} – Obtén información específica de un jugador.
• POST /api/players/{name}/give – Entrega un objeto a un jugador.
• POST /api/players/{name}/kick – Expulsa a un jugador.
• POST /api/players/{name}/ban – Banea a un jugador.
• POST /api/players/{name}/unban – Levanta el baneo a un jugador.
• POST /api/broadcast – Envía un mensaje a todos los jugadores.
• POST /api/command – Ejecuta un comando del servidor.

Ejemplo de Uso

Entregar Objeto (Entrega una Espada Larga de Llama a un jugador)

Cambia <name> por tu nombre de usuario.

curl -X POST http://localhost:8080/api/players/<name>/give 
  -H "X-API-Key: changeme" 
  -H "Content-Type: application/json" 
  -d '{"item": "Weapon_Longsword_Flame", "amount": 1}'

Transmitir Mensaje del Servidor

curl -X POST http://localhost:8080/api/broadcast 
  -H "X-API-Key: changeme" 
  -H "Content-Type: application/json" 
  -d '{"message": "hola mundo"}'