Instalación

Antes de empezar#

Antes de instalar Fuel Stations, asegúrate de que tu servidor cumple los requisitos mínimos. Dos recursos y un framework son obligatorios; todo lo demás es opcional y se detecta solo.

Todo lo específico de un framework o de terceros está detrás de un pequeño archivo puente sin cifrar, y el recurso elige el correcto mirando lo que ya está en ejecución:

Descargar Fuel Stations#

Después de comprar Fuel Stations, el recurso se vincula automáticamente a tu cuenta del CFX Portal.

Inicia sesión en el CFX Portal con la misma cuenta que usaste al pagar, abre Granted Assets y descarga Fuel Stations.

Después de extraer la descarga, deberías tener las siguientes carpetas:

[fuelstations]/
├── qs-fuelstations/
│   ├── config.lua         -- what you may edit
│   ├── client/custom/     -- bridges to other resources (editable)
│   ├── server/custom/     -- bridges to other resources (editable)
│   ├── locales/           -- 41 languages
│   ├── sql/database.sql   -- the schema and the 54 default stations
│   ├── html/sounds/       -- nozzle and pump sounds
│   └── web/               -- the interface, already built
└── [props]/
    └── fuelstations-props/  -- EV charger and connector models

La carpeta debe llamarse qs-fuelstations. Los exports que llaman otros scripts se derivan del nombre de la carpeta, y el recurso se niega a funcionar con cualquier otro nombre — imprime un error y cierra la consola del servidor.

Instalar el recurso#

Mueve la carpeta [fuelstations] al directorio resources de tu servidor. Puede estar en cualquier lugar dentro de él, incluida otra carpeta de categoría:

resources/
└── [qs]/
    └── [fuelstations]/
        ├── qs-fuelstations/
        └── [props]/fuelstations-props/

Una vez copiada, abre tu server.cfg y asegúrate de que cada dependencia — y todo lo que deba detectar — se inicie antes que Fuel Stations:

ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended
# ensure qb-core
# ensure vrp

# Target, inventory, keys, interface
ensure ox_target
ensure qs-inventory
ensure qs-vehiclekeys
ensure qs-interface
ensure qs-textui

# Fuel Stations
ensure fuelstations-props
ensure qs-fuelstations

El orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un framework, sistema de llaves o inventario que se inicie después de Fuel Stations no se encuentra — y un framework que no se encuentra recurre a ESX.

La base de datos#

Importa sql/database.sql en la base de datos de tu servidor con HeidiSQL, phpMyAdmin o cualquier cliente MySQL. No es opcional: las estaciones están en la base de datos, y sin ella el servidor arranca sin ninguna. Un solo archivo sirve para todos los frameworks — nada en el esquema ni en los datos iniciales es específico de ESX o QBCore.

Los datos iniciales colocan 54 estaciones. La gasolina y la electricidad son filas separadas, así que fuel_types te indica de un vistazo cuál es cuál:

Conceder acceso al creador#

El creador de estaciones es donde se colocan las estaciones y se ajusta la economía, así que /fuelcreator está protegido por una comprobación de acceso. Cualquiera de estas vías permite entrar a un jugador:

# One player
add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fuelstations.creator allow

# Everyone in group.admin
add_ace group.admin fuelstations.creator allow

Config.Creator = {
    command     = 'fuelcreator', -- chat command
    keybind     = '',            -- default key, e.g. 'F7'. '' = none
    allowAdmins = true,          -- framework admins can use it
    aces        = {              -- ACE permissions that grant access
        'group.admin',
        'group.superadmin',
        'fuelstations.creator',
    },
}

Configurar el recurso#

Todo lo que cambia en el día a día — estaciones, precios, el modelo de consumo, qué tipo usa cada vehículo — se edita en el juego desde /fuelcreator y se guarda en la base de datos. config.lua contiene la configuración interna:

Los valores que conviene revisar primero:

Config.Language       = GetConvar('qs:locale', 'en') -- 41 languages in locales/
Config.UseTarget      = false     -- true = ox_target / qb-target, false = [E] prompts
Config.EnableJerrycan = true      -- sell jerrycans at pumps
Config.PriceSymbol    = '€'       -- shown everywhere
Config.CurrencyLocale = 'en-US'   -- number formatting
Config.FuelPaymentMethods = { cash = true, bank = true } -- what the pump accepts
Config.PriceMode      = 'market'  -- 'static' or 'market'
Config.EnableJob      = true      -- the tanker delivery job
Config.EveryStationHasFuelLevel = true -- stations can run dry
Config.Debug          = false     -- console logging

Editar Config.FuelPrices, Config.Economy o Config.ElectricModels en un servidor en marcha no hace nada. Solo sirven para rellenar una tabla fuel_settings vacía; después, la pestaña Economy de /fuelcreator es la configuración.

Verificar la instalación#

Después de completar la instalación, reinicia tu servidor y lee la consola. Un inicio correcto se ve así:

[FUELSTATIONS] Market pricing is on — prices move every 30 minute(s).
You are using the latest version of qs-fuelstations!

Una línea que dice No stations in `fuel_stations` o Could not read `fuel_stations` significa que el archivo SQL no se importó en la base de datos que usa este servidor. Después entra en tu servidor y recorre el primer ciclo:

1. Visita una estación

   Cada gasolinera del mapa tiene un blip. Aparca junto a un surtidor, bájate y pulsa E en el surtidor: se abre la pantalla del surtidor con los tipos, el precio y tu depósito.

2. Reposta

   Toma la boquilla, ve hasta la tapa del depósito y pulsa E. Elige una cantidad y cómo pagar, empieza y observa cómo suben los litros y el total.

3. Abre el creador

   /fuelcreator muestra las 54 estaciones. Desde ahí, Uso explica cómo colocar tu propia estación y ajustar la economía.

A partir de aquí nada requiere reiniciar. Cada estación, precio, tipo y valor de consumo se edita en el juego y llega a todos los jugadores en cuanto se guarda.