Instalación

Diez minutos. Sin archivo SQL ni recurso de props: las tablas se crean solas y las cámaras son props que el juego ya tiene.

Antes de empezar

Necesitas	Por qué
ESX, QBCore o QBox, en marcha	Identificadores, trabajos e ítems usables. Se detecta solo
oxmysql, en marcha	Cámaras, claves de acceso, pruebas y registros
fmLib	Una dependencia obligatoria: `mic_cctv` no arranca sin él
screenshot-basic	La cuadrícula en directo y todas las fotos. Sin él la cuadrícula se queda vacía
Una cuenta de FiveManage y un token de API	Allí se suben las fotos de pruebas. Crea uno en fivemanage.com, en Tokens
ox_inventory (recomendado)	Una `cctv_photo` impresa conserva su imagen gracias a los metadatos del ítem

1. Coloca la carpeta

Pon mic_cctv en tus recursos, por ejemplo dentro de resources/[mic]/. No le cambies el nombre: la pantalla de la tablet se comunica con el script a través de él.

2. Orden de arranque

En server.cfg, debajo de tu framework y tu inventario, arranca oxmysql, screenshot-basic y fmLib, y después mic_cctv, cada uno en su propia línea ensure.

Ha funcionado si la consola del servidor muestra, al arrancar:

[MIC-CCTV] Server Bridge initialized. Detected Framework: esx (o qbcore, que es también lo que muestra QBox)
[MIC-CCTV] Server Main Loop & Database initialized.
[MIC-CCTV] FiveManage integration loaded (server-side).

Si la primera línea dice standalone, mic_cctv arrancó antes que tu framework: muévelo más abajo.

En QBox, deja Config.Framework en 'auto': QBox se detecta gracias a su compatibilidad con QBCore (qbx_core proporciona qb-core), así que no hay nada que configurar.

3. La base de datos: no hay nada que hacer

El primer arranque crea las cuatro tablas que necesita (mic_cctv_cameras, mic_cctv_private_access, mic_cctv_evidence y mic_cctv_logs) y añade cualquier columna que le falte a una versión anterior.

Ha funcionado si esas cuatro tablas están en tu base de datos después del primer arranque.

4. FiveManage

Pon tu token de API de FiveManage en el archivo de token del lado del servidor del recurso. Se carga solo como script de servidor, así que los jugadores nunca lo reciben.

Solo lo necesitan las fotos. Todo lo demás (la cuadrícula, las cámaras, los registros) funciona sin él.

Ha funcionado si haces una foto (paso 7) y la consola muestra FiveManage upload success.

5. Añade los ítems

Ítem	Qué hace
`cctv_tablet`	Abre la tablet de seguridad
`cctv_wall`	Coloca una cámara de pared (gira 45° a cada lado)
`cctv_360_cam`	Coloca una cámara de cúpula 360°
`cctv_pole`	Coloca una cámara de poste (gira 45° a cada lado)
`cctv_360_pole`	Coloca una cámara de poste 360°
`cctv_repair`	Saca el láser de reparación. No se gasta
`cctv_photo`	Una foto de prueba impresa. La da la tablet; al usarla se muestra la imagen

Las definiciones listas para usar vienen en mic_cctv/items/, y los iconos en mic_cctv/items/images/:

Inventario	Definiciones (`mic_cctv/items/`)	Dónde van	Iconos
ox_inventory	`ox.lua`	`ox_inventory/data/items.lua`	Copia `items/images/*.png` a `ox_inventory/web/images/`
QBCore / qb-inventory	`qb.lua`	`qb-core/shared/items.lua`	Cópialos a `qb-inventory/html/images/`
Inventario por defecto de ESX	`esx.sql`	Impórtalo una vez en tu base de datos	—

Las entradas de ox.lua y qb.lua están comentadas: quita el -- del principio al pegarlas. No hay icono para cctv_photo en items/images/; usa la imagen que quieras.

Ha funcionado si te das uno de cada y aparecen en tu inventario.

6. El permiso del creador para administradores

El creador dentro del juego está protegido por un permiso ACE, mic_cctvcreator.open por defecto. Dáselo a tu grupo de administradores en server.cfg con una línea add_ace que conceda mic_cctvcreator.open a group.admin.

Ha funcionado si /camcreator abre el creador para un administrador, y cualquier otro recibe un mensaje de sin permiso.

7. La primera cámara

Usa cctv_wall. Una cámara transparente sigue a donde miras. Rueda del ratón para rotar, E para colocar, clic derecho o ESC para cancelar.
Ponle un nombre cuando te lo pida. Se retira el ítem y la cámara aparece en la pared.
Usa cctv_tablet. Tu cámara está en la cuadrícula, en movimiento.
Ábrela, gírala con A / D, pulsa Espacio para hacer una foto y Retroceso para volver.

Ha funcionado si la cuadrícula muestra la cámara en directo y la foto aparece en la galería de pruebas un momento después.

Antes de abrir tu ciudad

Decide quién puede usar la tablet. Config.AllowedJobs vacío significa todo el mundo; una lista de trabajos significa solo ellos, y además convierte cada cámara que coloca un jugador en una cámara de su trabajo. Consulta Personalización.
Da el permiso del creador solo al staff que deba montar redes de cámaras de trabajo.
Comprueba el token de FiveManage con una foto real antes de que los jugadores dependan de la galería.
Comprueba que Config.Locale es el idioma que quieres.