Guía de Instalación y Configuración — PolSYS CAD/MDT

Guía de instalación

Última actualización Hace alrededor de 7 horas

Bienvenido a la documentación oficial de instalación de PolSYS, el sistema táctico avanzado de CAD / MDT para servidores de FiveM. Sigue estos pasos para instalar y configurar el recurso correctamente en tu servidor.

🛠️ Requisitos Previos

Antes de proceder con la instalación, asegúrate de contar con las siguientes dependencias activas en tu servidor:

FXServer Artifacts: Versión recomendada 5848 o superior.
Base de Datos: MySQL 8.0+ / MariaDB 10.4+.
Manejador de Base de Datos: oxmysql (Recomendado) o mysql-async.
Framework: Compatible con ESX, QBCore o Standalone (Modo independiente).

📥 Paso 1: Descargar y Extraer el Recurso

Descarga el paquete comprimido de PolSYS desde tu panel de compras de Tebex.
Extrae la carpeta PolSYS dentro de tu directorio de recursos:
```
path
resources/[scripts]/PolSYS
```
IMPORTANT
No cambies el nombre de la carpeta PolSYS. El recurso utiliza rutas NUI y llamadas internas vinculadas a este nombre.

🗄️ Paso 2: Importar la Base de Datos (`polsys.sql`)

El script incluye un archivo .sql optimizado con la estructura completa de tablas persistentes.

Abre tu gestor de base de datos favorito (HeidiSQL, phpMyAdmin o DBeaver).
Selecciona la base de datos principal de tu servidor de FiveM.
Importa y ejecuta el archivo polsys.sql incluido en el recurso.

NOTE

Las tablas utilizan la sintaxis CREATE TABLE IF NOT EXISTS, por lo que no sobrescribirán ni borrarán datos existentes si ya habías instalado una versión previa.

Tablas creadas automáticamente:

polsys_reports — Registro de atestados e informes policiales.
polsys_warrants — Órdenes de búsqueda y captura judiciales.
polsys_stolen_vehicles — Registro de vehículos sustraídos/robados.
polsys_dispatch_logs — Historial de llamadas y entorno de centralita 10-31.

⚙️ Paso 3: Configurar el `server.cfg`

Abre el archivo de configuración de tu servidor (server.cfg) y añade las líneas de inicio en el orden correcto:

cfg
# Dependencias de Base de Datos

ensure oxmysql

# Sistema PolSYS CAD/MDT

ensure PolSYS

WARNING

Asegúrate de que ensure oxmysql esté colocado antes de ensure PolSYS para garantizar que la conexión a la base de datos se inicialice correctamente en el arranque.

🎮 Paso 4: Mandos y Teclas Predeterminadas

Abrir Tablet MDT Tecla K o /mdt Abre la tablet táctica principal con todas las pestañas y registros.
Visor Táctico de Entornos Tecla Y o /ultimoentorno Muestra u oculta el visor flotante emergente con los avisos recientes.
Enviar Alerta de Entorno /entorno [mensaje] Envía una alerta 10-31 con la ubicación GPS exacta del emisor.
Marcar Ruta en GPS Tecla ENTER (con el visor abierto) Traza inmediatamente el destino en el mapa de pausa y minimapa.
Navegar Entornos Flechas ← / → Alterna entre los avisos de entorno activos en el visor flotante.

🔐 Permisos y Seguridad

Acceso a la Tablet MDT: Restringido a jugadores con trabajo policial (police, sheriff, etc.) estando en servicio (ON DUTY).
Acceso a Cámaras (Bodycam & Dashcam):
- Bodycam (Cámara Corporal): Requiere estar ON DUTY. Muestra una perspectiva en primera persona 3D anclada al chaleco del oficial sin clipping de ropa.
- Dashcam (Patrulla): Requiere estar ON DUTY y montado dentro del vehículo patrulla.

❓ Solución de Problemas Frecuentes (Troubleshooting)

1. ¿Por qué el visor de entornos se veía con un rectángulo negro en versiones antiguas?

Se ha eliminado la propiedad CSS backdrop-filter para evitar conflictos de renderizado con el motor CEF de FiveM. El visor ahora utiliza un fondo sólido #0B132B 100% limpio.

2. Los atestados o las órdenes de búsqueda no se guardan

Revisa la consola del servidor (FXServer) para confirmar que oxmysql está iniciado correctamente. Si es la primera vez que instalas el script, la estructura SQL se cargará automáticamente al arrancar.

💻 ¿Necesitas soporte técnico adicional?
Únete a nuestro canal oficial de Discord o abre un ticket de soporte en nuestra plataforma de FeatureBase.