Problemas comunesTroubleshooting

Empieza siempre por /securityx status y por los logs del servidor. La mayoría de los problemas se ven en la primera línea del estado.Always start with /securityx status and the server logs. Most issues are visible in the first line of the status.

Invalid license in config.ymlInvalid license in config.yml#

La clave está vacía o no tiene el formato GX-XXXX-XXXX-XXXX. Copia la licencia completa del correo, sin espacios, y reinicia el servidor. El formato se valida antes de llamar a la API.The key is empty or does not match GX-XXXX-XXXX-XXXX. Copy the full license from the email, without spaces, and restart the server. The format is validated before calling the API.

server_limit_reached / server_mismatchserver_limit_reached / server_mismatch#

La licencia ya está vinculada a otro fingerprint. Usa Desvincular mi servidor en el dashboard (una vez cada 30 días) y vuelve a arrancar. No borres fingerprint.txt salvo que el staff te lo indique: consume el slot de vinculación.The license is already bound to another fingerprint. Use Unbind my server in the dashboard (once every 30 days) and restart. Do not delete fingerprint.txt unless staff tells you to: it consumes the binding slot.

Licencia suspendida o revocadaLicense suspended or revoked#

El heartbeat ha dejado de renovar la licencia. Abre un ticket en el Discord de soporte con tu Ticket ID y el estado que muestra /securityx status.The heartbeat stopped renewing the license. Open a support Discord ticket with your Ticket ID and the state shown by /securityx status.

Guard no respondeGuard is unreachable#

Comprueba la salida HTTPS del servidor hacia guard.securityx.sbs y que un firewall no bloquee el puerto 443. Con failOpen: true los jugadores siguen entrando mientras el plugin reintenta con backoff de 30 s a 10 min. Con failOpen: false todos los joins se bloquean hasta que Guard vuelva.Check the server outbound HTTPS access to guard.securityx.sbs and that a firewall is not blocking port 443. With failOpen: true players keep joining while the plugin retries with 30 s to 10 min backoff. With failOpen: false all joins are blocked until Guard recovers.

Un jugador limpio está bloqueadoA clean player is blocked#

• Desactiva datacenter y hosting si los tenías activos.Disable datacenter and hosting if they were enabled.
• Comprueba si la IP está en la blocklist comunitaria con /securityx check <ip>.Check whether the IP is in the community blocklist with /securityx check <ip>.
• Añade el permiso securityx.bypass o el nombre a whitelistBypass.list.Add the securityx.bypass permission or the name to whitelistBypass.list.
• Revisa los proveedores con /v1/check?ip=...&all=true para ver qué categoría hizo match.Review the providers with /v1/check?ip=...&all=true to see which category matched.

La API devuelve 400The API returns 400#

Falta ip o la IP no es válida. Para IPv6, codifica el valor con URLSearchParams o curl --get --data-urlencode.The ip is missing or invalid. For IPv6, encode the value with URLSearchParams or curl --get --data-urlencode.

La API devuelve 429The API returns 429#

Los endpoints de activación y heartbeat tienen límite por IP. El plugin reintenta solo; si lo estás probando a mano, espera un minuto y evita bucles de activación.Activation and heartbeat endpoints are rate-limited per IP. The plugin retries on its own; if you are testing manually, wait a minute and avoid activation loops.

La descarga del jar devuelve 404The jar download returns 404#

La descarga exige una cuenta activa con licencia. Si acabas de registrarte, espera la aprobación del ticket. Si ya tienes licencia, vuelve a iniciar sesión y prueba desde Tu plan y descargas.Downloading requires an active account with a license. If you just registered, wait for the ticket approval. If you already have a license, sign in again and retry from Your plan and downloads.

El plugin no compruebaThe plugin is not checking#

• Confirma checkIps.enabled: true y que /securityx status muestre checks=on.Confirm checkIps.enabled: true and that /securityx status shows checks=on.
• Comprueba que el jar corresponde a tu plataforma y versión de Java.Check that the jar matches your platform and Java version.
• Busca errores de activación en el arranque del servidor.Look for activation errors during server startup.
• Verifica que el plugin está en el proxy o en los backends, no en ambos.Verify the plugin is on the proxy or the backends, not both.