Antes de empezar#
Antes de instalar Bunkers Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Tres recursos son obligatorios; todo lo demás es opcional y se detecta por sí solo.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. Las tablas se crean solas. |
| Obligatorio | Zonas, barras de progreso, menús, callbacks y notificaciones. |
| Obligatorio | Carga el interior del búnker de gunrunning. Sin él, el interior de un búnker no existe. |
Build del juego | Obligatorio | 2802 o superior. Las misiones usan vehículos y props de DLC (Terrorbyte, contenedores de tren, amoladoras, cajas). |
Framework | Opcional | ESX, QBCore o Qbox — se detecta automáticamente. Funciona en modo standalone sin ninguno, pero sin trabajos nadie puede asaltar. |
Inventario | Recomendado | Guarda los suministros, el stock, el almacenamiento del búnker y el armero. Se admiten catorce. |
Target | Opcional | ox_target o qb-target. Sin ninguno, cada punto muestra un aviso de texto y se usa con E. |
Llaves de vehículos | Opcional | Da las llaves del caddy del búnker y de los vehículos que entran por la entrada de vehículos. |
Cada capa se detecta buscando un recurso iniciado:
Capa | Recursos detectados |
|---|---|
Framework | es_extended · qb-core · qbx_core |
Inventario | ox_inventory · qb-inventory · qs-inventory · esx_inventoryhud · origen_inventory · mf-inventory · codem-inventory · tgiann-inventory · lj-inventory · core_inventory · chezza_inventory · ps-inventory · aj-inventory · mythic_inventory |
Target | ox_target · qb-target |
Llaves de vehículos | qs-vehiclekeys · qb-vehiclekeys · jg-vehiclekeys · wasabi_carlock · vehicles_keys · mk_vehiclekeys · t1ger_keys · Renewed-Vehiclekeys · jota-dev-vehicle-key · qbx_vehiclekeys |
Lo que no se encuentre pasa a standalone en esa capa. Integraciones explica cómo fijar uno a mano.
GitHubReleases · Bob74/bob74_iplFix holes and customize the map.Descargar Bunkers Creator#
Después de comprar Bunkers Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets, y descarga Bunkers Creator.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-bunkers-creator/
├── shared/config.lua -- the settings you may edit
├── client/custom/ -- bridges to other resources (editable)
├── server/custom/ -- bridges to other resources (editable)
├── locales/ -- the eleven translations
├── data/ -- bunkers.json and globalConfig.json
├── stream/ -- props streamed by the resource
├── web/ -- the interface
└── fxmanifest.luaMantén la carpeta con el nombre
qs-bunkers-creator. Todos los exports se llaman a través de ese nombre, y la app del teléfono y otros scripts la buscan.
Instalar el recurso#
Mueve la carpeta qs-bunkers-creator al directorio resources de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-bunkers-creator/Abre tu server.cfg, fuerza una build reciente del juego y asegúrate de que todas las dependencias — y todo lo que deba detectar — se inicien antes que Bunkers Creator:
sv_enforceGameBuild 3095
ensure oxmysql
ensure ox_lib
ensure bob74_ipl
# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Inventory, target, vehicle keys
ensure ox_inventory
ensure ox_target
ensure qs-vehiclekeys
ensure qs-bunkers-creatorEl orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un inventario o target que se inicie después de Bunkers Creator no se encuentra y esa capa funciona en modo standalone.
La base de datos#
No hay ningún archivo SQL que importar. Bunkers Creator crea sus tablas al iniciarse y añade cualquier columna que le falte a una instalación anterior, así que actualizar nunca requiere una migración manual.
Tabla | Contiene |
|---|---|
| Una fila por búnker comprado: el propietario, el precio pagado, los poseedores de llaves, las ganancias y el historial de ingresos, las tasas de éxito de las misiones, el nivel de búsqueda, el bloqueo de asaltos y una copia del almacenamiento del búnker. |
| Quién está dentro de un búnker en este momento, para que un jugador que se desconecta o pasa un reinicio dentro vuelva a aparecer en la entrada cuando regrese. |
Los búnkeres en sí y los ajustes globales no están en la base de datos: se guardan en data/bunkers.json y data/globalConfig.json, escritos por el creador dentro del juego.
Cada vez que se guarda
bunkers.json, se conserva la versión anterior comobunkers.json.bak. Si el archivo falta o está dañado, el servidor restaura la copia de seguridad al arrancar y lo indica en la consola.
Ítems de inventario#
Dos ítems deben existir en tu inventario: bunker_supplies (lo que consume la producción y dan las cajas del tren) y bunker_stock (lo que fabrica la producción y transportan las misiones de venta). Las armas que fabrican las recetas incluidas — weapon_pistol, weapon_smg, weapon_assaultrifle, weapon_pumpshotgun — también deben existir, al igual que cualquier ítem que añadas como suministro, como botín de las cajas o a una receta.
En ox_inventory/data/items.lua:
['bunker_supplies'] = {
label = 'Bunker Supplies',
weight = 1000,
stack = true,
close = true,
description = 'Supplies for bunker operations'
},
['bunker_stock'] = {
label = 'Bunker Stock',
weight = 2000,
stack = true,
close = true,
description = 'Processed goods from bunker production'
},En qs-inventory/shared/items.lua:
['bunker_supplies'] = {
name = 'bunker_supplies',
label = 'Bunker Supplies',
weight = 1000,
type = 'item',
image = 'bunker_supplies.png',
unique = false,
useable = false,
shouldClose = true,
description = 'Supplies for bunker operations'
},
['bunker_stock'] = {
name = 'bunker_stock',
label = 'Bunker Stock',
weight = 2000,
type = 'item',
image = 'bunker_stock.png',
unique = false,
useable = false,
shouldClose = true,
description = 'Processed goods from bunker production'
},En qb-core/shared/items.lua:
bunker_supplies = { name = 'bunker_supplies', label = 'Bunker Supplies', weight = 1000, type = 'item', image = 'bunker_supplies.png', unique = false, useable = false, shouldClose = true, description = 'Supplies for bunker operations' },
bunker_stock = { name = 'bunker_stock', label = 'Bunker Stock', weight = 2000, type = 'item', image = 'bunker_stock.png', unique = false, useable = false, shouldClose = true, description = 'Processed goods from bunker production' },Para los inventarios que leen la tabla items de ESX:
INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('bunker_supplies', 'Bunker Supplies', 100, 0, 1),
('bunker_stock', 'Bunker Stock', 500, 0, 1);Las imágenes de los ítems en el banco de trabajo se leen de la carpeta de imágenes de tu propio inventario, así que coloca ahí bunker_supplies.png y bunker_stock.png. Las carpetas aparecen en Config.InventoryImagePaths.
Obtener acceso de administrador#
El creador — donde se colocan los búnkeres y se configura el servidor — se abre con /bunkercreator y solo para administradores. Quién cuenta como administrador depende del framework:
Jugadores del grupo admin o superadmin. Asigna el grupo con tu herramienta de administración de ESX habitual o en la tabla users.
Jugadores con el permiso de QBCore admin, o con el ace command.
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx qbcore.adminJugadores con el ace command — los administradores de txAdmin ya lo tienen.
add_ace group.admin command allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.adminLa regla está en IsAdmin en server/custom/frameworks/<framework>.lua, y puedes cambiarla por cualquier comprobación que quieras.
Configurar el recurso#
La economía, las reglas de asalto y el interior se editan dentro del juego desde /bunkercreator → Settings. Algunos valores están en archivos:
Archivo | Contenido |
|---|---|
| Idioma, detección, blips, carpetas de imágenes del inventario, el requisito de policías, la cuenta de pago en QB, el aumento del nivel de búsqueda y las recetas de fabricación. |
| Lo que guarda la pestaña Settings: producción, precios, ítems de suministro, botín de las cajas, reglas de asalto, trabajos que pueden asaltar, estilo del interior y mejoras. |
| Cada búnker y sus puntos. Lo escribe el creador; no hace falta editarlo a mano. |
| Todos los textos que lee el jugador. |
Los valores que conviene revisar primero:
Config.Language = 'en' -- de · en · es · fr · hi · it · ja · nl · pt · zh-CN · zh-TW
Config.EnableBlips = true -- bunker blips on the map
Config.MinPoliceOnline = 0 -- on-duty police needed to start a mission
Config.PoliceJobs = { 'police' } -- jobs counted for that gate
Config.SellPayoutAccount = 'cash' -- QBCore / Qbox only: cash · bank · cryptoVerificar la instalación#
Reinicia tu servidor, comprueba que la consola no muestra líneas rojas de qs-bunkers-creator, luego entra y completa el primer ciclo:
Encuentra un búnker
Hay once búnkeres en el mapa con un blip — Zancudo, Route 68, Paleto y el resto. Acércate a la entrada y elige View Bunker.
Cómpralo
Confirma la compra. El precio se cobra del banco. Entra y se reproduce la cinemática de la primera visita (E la salta).
Reabastece
Abre el portátil → Resupply → Buy Supplies. En unos segundos empieza a aparecer stock y las cajas llenan el suelo.
Abre el creador
/bunkercreatorabre el panel de administración. Desde ahí, Uso explica cómo colocar tu propio búnker.