GameAP

GameAP se autentica con un único token de API: ni un cliente OAuth2 ni un par de claves. Cree uno en el panel y péguelo en Provibr junto con la URL del panel.

• Host: la URL completa del panel con el puerto, por ejemplo http://panel.example.com:8025. GameAP usa HTTP sin cifrar en el 8025 de forma predeterminada, y no hay puerto que Provibr pueda añadir sin adivinar.
• Token de API: el token de Sanctum, con la forma id|secret. Provibr conserva esa forma id|secret y rechaza un token pegado sin la id delante.

El token no caduca, lo que lo convierte en la credencial de larga vida más limpia de los paneles de juego: el agente sigue funcionando durante meses sin que nadie vuelva a escribir una contraseña.

Un GameAP nuevo usa HTTP sin cifrar en el puerto 8025, con el 443 cerrado. No hay campo de huella TLS, porque sin TLS no hay certificado que fijar.

Un panel en http sin cifrar funciona, pero el token de API y todo lo que hace la integración viajan entonces sin cifrar. Ponga delante un reverse proxy con TLS para cambiarlo; el agente valida entonces la cadena de certificados como siempre, sin fijación.

Un servidor GameAP se construye a partir de un juego y un game mod: un título como samp o minecraft, más su plantilla. Juntos son lo que en otros paneles es un egg de Pterodactyl. Provibr no se los lista: el token de API se rechaza en los juegos, los mods y los nodos del panel, que son solo de administrador. Lea el código de juego y el ID del mod en su propio panel de GameAP e introdúzcalos en el plan.

Un plan de juego lleva el código de juego, el ID del mod y los límites de recursos. El pedido se hace mediante un plan: el juego y su plantilla vienen del plan, y el nodo viene de los ajustes de la integración.

El token de API no puede listar los nodos del panel, así que el motor de ubicación no puede elegir ninguno. El nodo viene del ajuste de la integración (el ID de nodo de GameAP, que en un panel de un solo nodo es 1). Tampoco hay sistema de asignación: el agente elige un trío de puertos libres de un rango que se fija de antemano, porque GameAP no reparte ninguno propio.

Crear, iniciar, detener, reiniciar, reinstalar y eliminar funcionan todos. Crear un servidor e instalarlo son dos pasos: el panel escribe primero el registro e instala después, y Provibr hace ambos y luego espera a que termine la tarea del daemon.

Cuando Provibr suspende un servidor de juego para hacer cumplir un límite de licencia, detiene el servidor y lo marca como bloqueado en el panel.

No hay consola: la de GameAP va por un websocket con un token efímero aparte y su propio protocolo de tramas, una vía distinta del túnel que comparten los demás paneles de juego. Tampoco hay gráficas de uso, porque GameAP no da CPU, memoria, disco ni red por servidor. Provibr no gestiona el panel, sus nodos, archivos ni usuarios; un servidor de juego en el panel es la integración.