Skip to content

Installazione

Installation

Quattro passaggi: importa il file SQL, concediti l'accesso all'editor, registra i tuoi oggetti, avvia la risorsa.

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

Avvia bupa-addictioncreator dopo le risorse da cui dipende.

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

3. Database

Importa sql/bupa_addictioncreator.sql. Verranno create due tabelle:

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

Entrambi i nomi possono essere modificati in Config.Tables in caso di conflitti con tabelle già esistenti.

4. Access to the editor

L'editor modifica gli effetti delle droghe sul tuo server, quindi l'accesso è protetto.

server.cfg
add_ace group.admin bupa.substances allow

Su un server di sviluppo in cui non sono ancora stati configurati i permessi ACE, inserisci invece il tuo identificativo di licenza nel file di configurazione:

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

5. Register your items

Ogni sostanza creata nell'editor fa riferimento a un oggetto dell'inventario, e quell'oggetto deve esistere. Copia il blocco relativo al tuo inventario dal file corrispondente in 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

Per ox_inventory, sono importanti due righe di quella voce:

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 non dispone di CreateUseableItem, quindi questa esportazione permette alla risorsa di capire quando l'oggetto viene utilizzato.
  • consume = 0 — senza questo parametro, ox_inventory rimuove l'oggetto prima che la risorsa abbia verificato se la dose è consentita. Sarà la risorsa stessa a rimuovere l'oggetto una volta effettuato il controllo.

Su QBox, QB-Core e ESX la risorsa registra automaticamente l'oggetto utilizzabile tramite il core, quindi è sufficiente impostare useable = true sull'oggetto.

Il nome dell'oggetto nell'editor e quello nel tuo inventario devono corrispondere esattamente, in minuscolo. L'editor converte automaticamente in minuscolo ciò che digiti; il file dei tuoi oggetti deve rispettare lo stesso formato.