Instalación

Antes de empezar#

Antes de instalar Biohazard Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Solo un recurso es obligatorio; todo lo demás es opcional y solo añade pulido.

Cada pieza opcional se degrada sin hacer ruido. Si falta un recurso, esa función recurre al comportamiento normal de GTA: no hay errores y el brote sigue funcionando.

Descargar Biohazard Creator#

Después de comprar Biohazard Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en CFX Portal con la misma cuenta usada al finalizar la compra, abre Granted Assets y descarga Biohazard. Con otra cuenta, el asset no aparece.

Después de extraer la descarga, deberías tener lo siguiente:

qs-biohazard/
├── config.lua          -- every global setting
├── client/custom.lua   -- notifications, clothing, death state (open)
├── server/custom.lua   -- identifiers, names, rewards (open)
├── shared/             -- shared helpers
├── locales/            -- en.json · es.json
├── client/ · server/   -- the runtime
└── web/                -- the interface, its images and sounds
[sql]/
└── biohazard.sql       -- the two tables to import

Mantén la carpeta con el nombre qs-biohazard. La app del teléfono y cualquier script que use los exports la llaman por ese nombre.

Instalar el recurso#

Mueve la carpeta qs-biohazard a la carpeta resources de tu servidor. Puede estar en cualquier lugar dentro de ella, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── qs-biohazard/

Una vez copiada, abre tu server.cfg y asegúrate de que oxmysql se inicie antes que Biohazard Creator:

ensure oxmysql

# Optional
ensure chat
ensure qs-interface
ensure qs-appearance
ensure qs-smartphone

ensure qs-biohazard
ensure phone-biohazard   # optional companion app

Solo oxmysql tiene que ir primero. Cada recurso opcional se busca en directo, cada vez que se usa, así que su posición en el archivo no importa, y uno iniciado más tarde se detecta sin reiniciar Biohazard Creator.

La base de datos#

Biohazard Creator incluye sus tablas como un archivo SQL. Importa [sql]/biohazard.sql en la base de datos de tu servidor antes del primer inicio, con HeidiSQL o cualquier cliente MySQL / MariaDB. Crea dos tablas:

CREATE TABLE IF NOT EXISTS `qs_biohazard_events` (
    `id` INT(11) NOT NULL AUTO_INCREMENT,
    `creator` VARCHAR(80) NOT NULL,
    `label` VARCHAR(255) NOT NULL,
    `data` LONGTEXT NOT NULL,
    `created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,

    PRIMARY KEY (`id`),

    KEY `creator` (`creator`),
    KEY `label` (`label`)
) ENGINE=InnoDB
DEFAULT CHARSET=utf8mb4
COLLATE=utf8mb4_unicode_ci;

CREATE TABLE IF NOT EXISTS `qs_biohazard_stats` (
    `identifier` VARCHAR(80) NOT NULL,
    `name` VARCHAR(120) NOT NULL DEFAULT 'Survivor',
    `xp` INT(11) NOT NULL DEFAULT 0,
    `level` INT(11) NOT NULL DEFAULT 1,
    `kills` INT(11) NOT NULL DEFAULT 0,
    `infections` INT(11) NOT NULL DEFAULT 0,
    `games` INT(11) NOT NULL DEFAULT 0,
    `wins` INT(11) NOT NULL DEFAULT 0,
    `losses` INT(11) NOT NULL DEFAULT 0,
    `best_kills` INT(11) NOT NULL DEFAULT 0,
    `mvps` INT(11) NOT NULL DEFAULT 0,
    `last_played` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,

    PRIMARY KEY (`identifier`),

    KEY `level` (`level`),
    KEY `xp` (`xp`),
    KEY `kills` (`kills`),
    KEY `wins` (`wins`)
) ENGINE=InnoDB
DEFAULT CHARSET=utf8mb4
COLLATE=utf8mb4_unicode_ci;

Ambas sentencias usan CREATE TABLE IF NOT EXISTS, así que volver a importar el archivo en una instalación existente es seguro: nunca borra presets ni progresión.

Obtener acceso de administrador#

El creador diseña y lanza brotes para todo el servidor, así que está protegido por un permiso ACE con el nombre de su comando: command.biohazardcreator. A los jugadores sin él que escriban /biohazardcreator se les indica que no pueden usar el creador.

add_ace group.admin command.biohazardcreator allow
add_principal identifier.license:YOUR_LICENSE group.admin

Config.RequireAce = false -- anyone can open the creator

Configurar el recurso#

Casi todo sobre un brote (su zona, duración, hora, clima, horda, zombis, infección y recompensas) se configura por evento en el creador y se guarda en la base de datos. config.lua contiene lo que comparten todos los eventos y la plantilla con la que empieza un evento nuevo:

Los valores que conviene revisar primero:

Config.Language       = 'en'               -- en · es
Config.CreatorCommand = 'biohazardcreator' -- the admin command
Config.RequireAce     = true               -- creator locked behind the ACE

Config.AutoStart = {
    Enabled        = true, -- random outbreaks on their own
    MinHours       = 2,    -- shortest gap between two
    MaxHours       = 5,    -- longest gap between two
    AnnounceInChat = true
}

Config.Scoreboard.Key = 'Z'  -- the kill ranking
Config.Levels.Enabled = true -- XP, levels and ranks

Auto Start viene activado. En una instalación nueva sin presets, lanza la plantilla por defecto (un brote en todo el mapa) entre dos y cinco horas después del arranque. Desactívalo hasta que tus eventos estén diseñados si prefieres no llevarte sorpresas. Los cambios en Config.DefaultEvent solo afectan a los eventos nuevos y a esa alternativa; los presets guardados conservan sus propios valores.

Verificar la instalación#

Tras completar la instalación, reinicia tu servidor y lee la consola:

[Biohazard] Loaded 0 saved event preset(s).
[Biohazard] Auto-start in 187 minutes...

La primera línea confirma que la base de datos es accesible y que las tablas existen. La segunda aparece diez segundos después del arranque cuando Auto Start está activado, con un retraso aleatorio dentro de tu rango.

Luego entra a tu servidor y ejecuta un primer brote:

1. Abre el creador

   /biohazardcreator se abre con una lista vacía: No events yet. Pulsa New event.

2. Diseña un brote corto

   Ponle nombre, establece la duración en 5 minutos, deja la zona en Whole map y pulsa Create. Aparece en la lista de la izquierda.

3. Inícialo

   Selecciónalo y pulsa Start. El creador se cierra, cae la noche, se reproduce la introducción y aparecen zombis a tu alrededor. Deja que te golpeen tres veces para sentir la infección y pulsa Z para ver el marcador.

4. Detenlo

   Vuelve a abrir el creador y pulsa Stop event. Los zombis desaparecen y el clima y la hora vuelven a la normalidad. A partir de ahí, Uso explica cómo dibujar una zona y ajustar cada opción.

A partir de aquí nada necesita un reinicio. Los presets se crean, editan y lanzan en directo; solo las ediciones de config.lua requieren reiniciar el recurso.

Mapa recomendado#

Para el brote más inmersivo, añade un mapa apocalíptico a tu servidor. Total Apocalypse convierte Los Santos en una ciudad en ruinas y devastada, que encaja perfectamente con una noche de zombis y hace que cada encuentro se sienta como un brote real.

github.comGitHub - SparksScripts/Total-Apocalypse: Post Apocalypse Map Pack for FiveMPost Apocalypse Map Pack for FiveM. Contribute to SparksScripts/Total-Apocalypse development by creating an account on GitHub.