Documentación

Configurar el pluginConfigure the plugin

Referencia de config.yml, categorías, bypass, mensajes, comandos y permisos.config.yml reference, categories, bypass, messages, commands and permissions.

Actualizado 2026-11-14 2 min de lectura 5 / 7

La configuración es la misma en las tres plataformas. Edita config.yml y aplica los cambios con /securityx reload. Los cambios de licencia o de apiUrl requieren reiniciar.The configuration is the same on all three platforms. Edit config.yml and apply changes with /securityx reload. License or apiUrl changes require a restart.

Licencia y conexiónLicense and connection

licensestring: Clave GX-XXXX-XXXX-XXXX del correo de activación. Obligatoria.Your GX-XXXX-XXXX-XXXX key from the activation email. Required.
serverNamestring: Etiqueta opcional que aparece en el dashboard.Optional label shown in the dashboard.
apiUrlstring: Por defecto https://guard.securityx.sbs. Cámbialo solo si usas otra instancia.Defaults to https://guard.securityx.sbs. Change it only if you use another instance.
failOpenboolean: true: si Guard no responde, los jugadores entran. false: se bloquean todos los joins hasta que vuelva.true: if Guard is unreachable, players join. false: all joins are blocked until it recovers.
heartbeatMinutesint 1-1440: Intervalo del heartbeat de licencia. Por defecto 10.License heartbeat interval. Default 10.

Comprobaciones de IPIP checks

checkIps.enabledboolean: Interruptor principal del gate anti-VPN. Por defecto true.Master switch for the anti-VPN gate. Defaults to true.
checkIps.cacheMinutesint 0-1440: Caché por IP en minutos. 0 la desactiva. Por defecto 10.Per-IP cache in minutes. 0 disables it. Default 10.
checkIps.communityEnabledboolean: Incluye la blocklist comunitaria revisada. Por defecto true.Includes the reviewed community blocklist. Defaults to true.
checkIps.categories.vpnboolean: Salidas de VPN. Recomendado true.VPN exits. Recommended true.
checkIps.categories.proxyboolean: Proxies abiertos y residenciales. Recomendado true.Open and residential proxies. Recommended true.
checkIps.categories.torboolean: Nodos de salida Tor. Recomendado true.Tor exit nodes. Recommended true.
checkIps.categories.abuseboolean: IPs reportadas por abuso. Recomendado true.IPs reported for abuse. Recommended true.
checkIps.categories.datacenterboolean: Rangos de datacenter. Por defecto false: puede afectar a jugadores con hosting doméstico.Datacenter ranges. Defaults to false: may affect players on home hosting.
checkIps.categories.hostingboolean: Rangos de hosting. Por defecto false.Hosting ranges. Defaults to false.
checkIps.categories.proxyAsnboolean: ASNs de proveedores de proxy. Por defecto false.Proxy provider ASNs. Defaults to false.

Empieza conservadorStart conservative

Activa primero vpn, proxy, tor y abuse. Añade datacenter u hosting solo después de revisar los falsos positivos de tu comunidad.Enable vpn, proxy, tor and abuse first. Add datacenter or hosting only after reviewing false positives in your community.

Bypass para jugadores de confianzaTrusted player bypass

whitelistBypass.enabledboolean: Activa el bypass. Por defecto true.Enables bypass. Defaults to true.
whitelistBypass.modeperm | list: perm: usa un permiso. list: usa una lista de nombres.perm: use a permission. list: use a name list.
whitelistBypass.permissionstring: Permiso para saltar la comprobación. Por defecto securityx.bypass.Permission to skip the check. Defaults to securityx.bypass.
whitelistBypass.liststring[]: Nombres que saltan la comprobación cuando mode: list (sin distinguir mayúsculas).Names that skip the check when mode: list (case-insensitive).

MensajesMessages

messages.languagees | en | pt | jp | zh: Idioma del kick automático. Por defecto es.Language of the automatic kick. Defaults to es.
messages.prefixstring: Prefijo con códigos de color &.Prefix with & color codes.

messages.kick no se aplicamessages.kick is not applied

En esta versión el texto del kick sale de las traducciones integradas según messages.language. La clave messages.kick del archivo de ejemplo está reservada y no se lee.In this version the kick text comes from the built-in translations selected by messages.language. The messages.kick key in the example file is reserved and is not read.

Ejemplo recomendadoRecommended example

yaml config.yml

license: "GX-XXXX-XXXX-XXXX"
serverName: "Mi servidor"
failOpen: true
heartbeatMinutes: 10

checkIps:
  enabled: true
  cacheMinutes: 10
  communityEnabled: true
  categories:
    vpn: true
    proxy: true
    tor: true
    abuse: true
    datacenter: false
    hosting: false
    proxyAsn: false

whitelistBypass:
  enabled: true
  mode: "perm"
  permission: "securityx.bypass"
  list: []

messages:
  language: "es"
  prefix: "&8[&cSecurityX&8] &7"

Comandos y permisosCommands and permissions

ComandoCommand	Qué haceWhat it does	PermisoPermission
`/securityx status/securityx status`	Estado, heartbeat, caché, versión y último error.State, heartbeat, cache, version and last error.
`/securityx reload/securityx reload`	Relee la configuración y reinicia el pipeline.Reloads the configuration and restarts the pipeline.
`/securityx check <ip>/securityx check <ip>`	Consulta en vivo una IP y muestra si se bloquearía.Runs a live check for one IP and shows whether it would be blocked.

PermisoPermission	Por defectoDefault	UsoUse
`securityx.adminsecurityx.admin`	opop	Acceso a `/securityx`.Access to `/securityx`.
`securityx.bypasssecurityx.bypass`	falsefalse	Salta la comprobación con `mode: perm`.Skips the check with `mode: perm`.

check no usa la cachécheck does not use the cache

/securityx check consulta la API en vivo. No altera el resultado cacheado que se usará en el próximo join./securityx check queries the live API. It does not change the cached result used on the next join.

Verificar la instalaciónVerify the installation Problemas comunesTroubleshooting

¿Necesitas ayuda?

Si algo no encaja, abre un ticket con el estado de tu servidor y las últimas líneas del log.

Abrir ticket en Discord

Licencia y conexiónLicense and connection#

Comprobaciones de IPIP checks#

Bypass para jugadores de confianzaTrusted player bypass#

MensajesMessages#

Ejemplo recomendadoRecommended example#