Skip to content

Installation

Installation

1. Dépendances

Installez et démarrez ox_lib avant cette ressource. Si vous prévoyez d'utiliser le stockage en base de données, oxmysql doit également être actif.

2. Ajoutez la ressource

Placez bupa-safezonecreator dans votre dossier de ressources (par exemple dans un dossier de catégorie [BUPA]) et ajoutez-le à votre server.cfg.

3. server.cfg — ordre de démarrage

ox_lib (et oxmysql, le cas échéant) doivent démarrer avant la ressource.

server.cfg
ensure ox_lib
ensure oxmysql            # uniquement si vous utilisez Storage = 'db'
ensure bupa-safezonecreator

4. Accès administrateur

L'ouverture du créateur est protégée. Pendant les tests, elle est ouverte à tout le monde — sécurisez-le avant de passer en live.

shared/config/general.lua
Config.AdminOnly = false   -- TODO: définir sur true avant la sortie (actuellement ouvert à tout le monde)
Config.AdminAce  = 'bupa.safezone'
Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.CustomAdmin = false -- true = utilise votre propre IsPlayerAdmin() dans server/editable.lua

Une fois que Config.AdminOnly = true, un joueur franchit la protection si l'une de ces conditions est remplie :

  • Il possède la permission ACE — attribuez-la avec :
server.cfg
  add_ace group.admin bupa.safezone allow
  • Son groupe de framework est dans Config.AdminGroups (groupe ESX, nom du job QB-Core / HasPermission('admin'), nom du job QBox).
  • Config.CustomAdmin = true et votre fonction Editable.isAdmin(src) dans server/editable.lua renvoie true.
⚠

Config.AdminOnly est configuré sur false par défaut pour vous permettre de tester immédiatement. Définissez-le sur true avant la sortie, sinon n'importe qui pourra ouvrir le créateur.

5. Stockage — JSON ou base de données

shared/config/general.lua
Config.Storage = 'json'   -- 'json' | 'db'
  • json (par défaut) — les zones sont enregistrées dans data/zones.json à l'intérieur de la ressource. Zéro configuration.
  • db — les zones sont stockées dans oxmysql. La table est créée automatiquement au premier démarrage ; vous n'avez pas besoin d'importer de fichier SQL :
auto-created table
CREATE TABLE IF NOT EXISTS bupa_safezones (
    id   VARCHAR(64) PRIMARY KEY,
    data LONGTEXT
);

6. Langue

La langue est définie globalement via la convar de localisation d'ox_lib. Ajoutez à votre server.cfg :

server.cfg
setr ox:locale "tr"

L'anglais est la langue par défaut pour toute clé manquante. Consultez Localization pour la liste complète des langues incluses.

PreviousBUPA Safezone CreatorNext Creating a Safezone