Docs

Mapa, país y globo

Mapa de zonas

En Jugadores, el mapa tiene vista 2D (arrastrar para mover, rueda para el zoom) y vista 3D: inclinada y giratoria (Mayús + arrastrar o botón derecho), con cada jugador sobre una línea tan alta como su altura real, para ver al momento quién vuela o está bajo el mapa. Dibujado en canvas 2D, sin WebGL.

  • Viene con un mapa satélite de Los Santos de 2752x3962 píxeles (html/img/map.jpg) ya calibrado. ZoneMap.ImageOpacity cambia su opacidad; ZoneMap.Image = '' dibuja una cuadrícula neutra.
  • Imagen propia: ponla en html/, añádela a files en fxmanifest.lua y pon la ruta y los límites del mundo que cubre en ZoneMap.Image y ZoneMap.Bounds.
  • ZoneMap.Zones: contornos con nombre (círculos o polígonos) para zonas seguras, cárcel, aeropuerto...

País de cada jugador (activado, sin configurar)

Geo.Country = true busca el país de cada jugador al entrar en data/geoip_country.dat, una base de datos incluida. No usa ningún servicio externo ni necesita clave: la IP no sale de tu servidor y no se guarda.

  • La base de datos es "IP to Country Lite" de DB-IP, con licencia CC BY 4.0. La licencia obliga a citar la fuente: el panel muestra "IP Geolocation by DB-IP" bajo la lista de jugadores. No lo quites.
  • Actualízala cada pocos meses: descarga dbip-country-lite-AAAA-MM.csv.gz de db-ip.com, ejecuta python tools/build_geoip.py dbip-country-lite-AAAA-MM.csv.gz AAAA-MM en la carpeta de Guardian y reinicia Guardian.

Globo terráqueo (sección "Mundo")

Un globo que se gira con el ratón muestra desde qué países se conectan los jugadores; al hacer clic en un país se ven sus jugadores conectados. Solo lo ve el propietario (permiso view.geo). No muestra IP ni nada más preciso que el país. Los contornos (html/data/world.json) salen de Natural Earth, de dominio público.

Detección de VPN y proxy (opcional, desactivada)

  • Geo.VpnCheck.Enabled = true. Con Provider = 'proxycheck' (proxycheck.io) funciona sin clave con una cuota diaria pequeña. También ipapi_pro (de pago) o custom (rellena GeoRequest y GeoParse en server/editable.lua).
  • La clave, mejor en server.cfg: set guardian_geo_key "...".
  • Geo.VpnCheck.Action: alert (por defecto), kick (el staff con exempt nunca) o none. Algunas operadoras móviles salen como proxy: empieza con alert.
  • La consulta envía la IP de cada jugador a ese proveedor: dilo en tu aviso de privacidad.