Inicio › Documentación › Instalación · origen_ilegalv2

Instalación · origen_ilegalv2

1. Descarga

Descarga el recurso desde tu panel de cliente y extráelo en tu carpeta de recursos.

bash
cd resources/
unzip origen_ilegalv2.zip -d [origen]/origen_ilegalv2

2. Importa la base de datos

El esquema está en database.sql, en la raíz del recurso.

El recurso también verifica el esquema automáticamente en cada arranque mediante server/classes/database.lua. Si falta una tabla o una columna, se crea automáticamente. El fichero database.sql es la fuente de verdad: mantenlo sincronizado si cambias el modelo de datos.

database.sql incluye la tabla origen_gang_announcements, necesaria para el sistema de anuncios de administración. Si actualizas desde una versión anterior, ejecuta manualmente la siguiente sentencia:

sql
CREATE TABLE IF NOT EXISTS `origen_gang_announcements` (
  `id`               int(11)      NOT NULL AUTO_INCREMENT,
  `title`            varchar(255) NOT NULL,
  `description`      text         DEFAULT NULL,
  `image_url`        varchar(512) DEFAULT NULL,
  `target_all_gangs` tinyint(1)   NOT NULL DEFAULT 1,
  `sent_by`          varchar(60)  NOT NULL,
  `sent_by_name`     varchar(150) NOT NULL,
  `sent_at`          timestamp    NOT NULL DEFAULT current_timestamp(),
  PRIMARY KEY (`id`),
  KEY `sent_at` (`sent_at`),
  KEY `target_all_gangs` (`target_all_gangs`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

3. Configura

Abre config/general.lua y establece tu idioma:

luaconfig/general.lua
Config.Debug    = false
Config.Language = 'en'  -- 'en' | 'es'

Opcionalmente, abre config_sv.lua para los ajustes del lado servidor, como los tokens de logs de Fivemanage.

config_sv.lua contiene tokens sensibles. No expongas su contenido en logs ni en repositorios públicos.

4. Registra el item ilegal_cad

Añade el item del CAD a la lista de objetos de tu recurso de inventario:

luaExample — ox_inventory/data/items.lua
['ilegal_cad'] = {
    label  = 'Gang CAD',
    weight = 100,
    stack  = false,
},

El primer CAD se entrega automáticamente cuando se crea una banda. Las unidades adicionales se compran desde el panel de la banda.

5. Añade al server.cfg

Arranca tu framework (es_extended, qb-core o qbx_core), tu inventario (si usas uno de los bridges compatibles) y cualquier otro recurso del que origen_ilegalv2 dependa para la detección automática — target, dispatch, voz, etc. — antes de origen_ilegalv2. La detección solo ve los proveedores que ya están en marcha. Consulta Dependencias para ver la matriz completa.

bashserver.cfg
# Framework + inventory + optional bridges (examples — use your actual resource names)
# ensure qbx_core
# ensure ox_inventory
 
# Optional integrations — must start BEFORE origen_ilegalv2 if used
# ensure origen_graffiti   # standalone graffiti system
# ensure origen_police     # police integration (Robbery Requests)
 
ensure oxmysql
ensure ox_lib
ensure origen_ilegalv2

El orden de carga importa. oxmysql y ox_lib deben arrancar antes que origen_ilegalv2, y tu framework / inventario / recursos con bridge deben arrancar antes que origen_ilegalv2 para que la detección automática pueda resolverlos.

origen_graffiti — se requiere prevención manual de conflictos

Si usas origen_graffiti, debes desactivar manualmente el sistema de grafitis interno de origen_ilegalv2. Abre config/graffiti.lua y establece Enable = false:

luaconfig/graffiti.lua
Config.Graffiti = {
    Enable = false, -- Disable internal graffiti — using origen_graffiti instead
    ...
}

Esto desactiva la lata de spray, el editor NUI, el trapo de limpieza y el renderizado de grafitis colocados. La integración de reputación de territorios (graffiti_external.lua) sigue activa y continúa procesando los tags de origen_graffiti.

origen_police — Solicitudes de robo

La pestaña de solicitudes de robo del panel de banda solo es visible cuando origen_police está en marcha. Arranca origen_police antes de origen_ilegalv2 para que la pestaña sea visible desde la primera conexión. Si origen_police arranca después, la pestaña aparece automáticamente en cuanto se pone en línea.

6. Verifica

Arranca el servidor y revisa la consola. En el primer arranque deberías ver:

text
[origen_ilegalv2]
* Framework: qb-core
* Inventory: ox_inventory
* Language: en
* Debug: Disabled
* Version: 1.0.0  Latest Version

Todas las dependencias detectadas se imprimen con el nombre de su proveedor activo. Cualquier ✗ indica un recurso que falta o que no está arrancado.