Início › Documentação › Instalação · origen_ilegalv2

Instalação · origen_ilegalv2

1. Transferência

Descarrega o recurso a partir do teu painel de cliente e extrai-o para a tua pasta de recursos.

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

2. Importa a base de dados

O esquema está em database.sql, na raiz do recurso.

O recurso também verifica o esquema automaticamente em cada arranque através de server/classes/database.lua. Se faltar uma tabela ou uma coluna, é criada automaticamente. O ficheiro database.sql é a fonte de verdade: mantém-no sincronizado se alterares o modelo de dados.

O database.sql inclui a tabela origen_gang_announcements, necessária para o sistema de anúncios de administração. Se estás a atualizar a partir de uma versão anterior, executa manualmente a seguinte instrução:

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 e define o teu idioma:

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

Opcionalmente, abre config_sv.lua para as definições do lado do servidor, como os tokens de logs do Fivemanage.

O config_sv.lua contém tokens sensíveis. Não exponhas o seu conteúdo em logs nem em repositórios públicos.

4. Regista o item ilegal_cad

Adiciona o item do CAD à lista de itens do teu recurso de inventário:

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

O primeiro CAD é entregue automaticamente quando uma gangue é criada. As unidades adicionais são compradas no painel da gangue.

5. Adiciona ao server.cfg

Arranca o teu framework (es_extended, qb-core ou qbx_core), o teu inventário (se usares um dos bridges suportados) e quaisquer outros recursos de que o origen_ilegalv2 dependa para a deteção automática — target, dispatch, voz, etc. — antes do origen_ilegalv2. A deteção só vê os fornecedores que já estão a correr. Consulta Dependências para ver a 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

A ordem de carregamento importa. O oxmysql e o ox_lib têm de arrancar antes do origen_ilegalv2, e o teu framework / inventário / recursos com bridge têm de arrancar antes do origen_ilegalv2 para que a deteção automática os consiga resolver.

origen_graffiti — é necessária prevenção manual de conflitos

Se usas o origen_graffiti, tens de desativar manualmente o sistema de graffiti interno do origen_ilegalv2. Abre config/graffiti.lua e define Enable = false:

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

Isto desativa o spray, o editor NUI, o pano de limpeza e a renderização dos graffitis colocados. A integração de reputação de territórios (graffiti_external.lua) continua ativa e continua a processar as tags do origen_graffiti.

origen_police — Pedidos de assalto

O separador de pedidos de assalto do painel da gangue só fica visível quando o origen_police está a correr. Arranca o origen_police antes do origen_ilegalv2 para que o separador esteja visível desde a primeira ligação. Se o origen_police arrancar depois, o separador aparece automaticamente assim que ficar online.

6. Verifica

Arranca o servidor e consulta a consola. No primeiro arranque deves ver:

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

Todas as dependências detetadas são impressas com o nome do respetivo fornecedor ativo. Qualquer ✗ indica um recurso em falta ou que não foi arrancado.