Skip to content

Instalación

Installation

Cuatro pasos: importa el SQL, otórgate acceso al editor, registra tus ítems e inicia el recurso.

1. Dependencies

Resource Required Why
ox_lib Yes Callbacks, notifications, locales
oxmysql Yes Storing substances and player addiction state
A targeting resource Optional Examining a player without a command

2. server.cfg — ensure order

Inicia bupa-addictioncreator después de los recursos de los que depende.

server.cfg
ensure ox_lib
ensure oxmysql
ensure ox_target
ensure bupa-addictioncreator

3. Database

Importa sql/bupa_addictioncreator.sql. Esto crea dos tablas:

Table Holds
bupa_substances The substance definitions you build in the editor
bupa_addictions Per-character addiction level, tolerance, dose count and history

Ambos nombres se pueden cambiar en Config.Tables si entran en conflicto con algo que ya estés ejecutando.

4. Access to the editor

El editor modifica lo que hacen las drogas en tu servidor, por lo que está protegido por accesos.

server.cfg
add_ace group.admin bupa.substances allow

En un servidor de desarrollo donde nadie haya configurado los ACEs todavía, introduce tu identificador de licencia en la configuración en su lugar:

config.lua
Config.Creator = {
    Command = 'substances',
    UseAce  = true,
    Ace     = 'bupa.substances',
    Developers = { 'license:0000000000000000000000000000000000000000' },
    LivePreview = true,
}

5. Register your items

Cada sustancia que crees en el editor apunta a un ítem del inventario, y ese ítem debe existir. Copia el bloque correspondiente a tu inventario del archivo coincidente en install/inv/:

File Covers
inv/ox_inventory.txt ox_inventory
inv/qb-inventory.txt qb-inventory, lj-inventory, ps-inventory
inv/qs-inventory.txt qs-inventory
inv/codem-inventory.txt codem-inventory
inv/tgiann-inventory.txt tgiann-inventory
inv/esx.txt classic ESX inventories

Para ox_inventory, dos líneas de esa entrada son importantes:

ox_inventory/data/items.lua
['meth_syringe'] = {
    label = 'Meth',
    weight = 20,
    stack = true,
    close = true,
    consume = 0,
    description = 'A loaded syringe',
    client = { image = 'meth_syringe.png' },
    server = { export = 'bupa-addictioncreator.useSubstance' },
},
  • server.export — ox_inventory no tiene CreateUseableItem, por lo que este export es la forma en que el recurso sabe que se ha usado el ítem.
  • consume = 0 — sin esto, ox_inventory elimina el ítem antes de que el recurso haya decidido si se permite la dosis. El recurso elimina el ítem por sí mismo una vez que lo ha decidido.

En QBox, QB-Core y ESX, el recurso registra el ítem usable por sí mismo a través del core, por lo que solo se necesita useable = true en el ítem.

El nombre del ítem en el editor y el nombre del ítem en tu inventario deben coincidir exactamente, en minúsculas. El editor convierte a minúsculas lo que escribas; tu archivo de ítems debe coincidir.