Skip to content

Installation

Installation

1. Dependencies

Installiere und starte ox_lib vor dieser Resource. Wenn du die Datenbank-Speicherung nutzen möchtest, muss zudem oxmysql laufen.

2. Resource einfügen

Platziere bupa-safezonecreator in deinem resources-Ordner (zum Beispiel innerhalb eines [BUPA]-Kategorieordners) und füge es zu deiner server.cfg hinzu.

3. server.cfg — Startreihenfolge

ox_lib (und oxmysql, falls verwendet) müssen vor der Resource gestartet werden.

server.cfg
ensure ox_lib
ensure oxmysql            # nur wenn du Storage = 'db' nutzt
ensure bupa-safezonecreator

4. Admin-Zugriff

Das Öffnen des Creators ist beschränkt. Während des Testens ist er für jeden zugänglich — sichere ihn ab, bevor du live gehst.

shared/config/general.lua
Config.AdminOnly = false   -- TODO: vor dem Release auf true setzen (derzeit für jeden offen)
Config.AdminAce  = 'bupa.safezone'
Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.CustomAdmin = false -- true = nutze dein eigenes IsPlayerAdmin() in server/editable.lua

Sobald AdminOnly = true ist, passiert ein Spieler die Zugangskontrolle, wenn eine der folgenden Bedingungen erfüllt ist:

  • Er besitzt die ACE-Berechtigung — vergebe sie mit:
server.cfg
  add_ace group.admin bupa.safezone allow
  
  • Seine Framework-Gruppe ist in Config.AdminGroups enthalten (ESX-Gruppe, QB-Core Job-Name / HasPermission('admin'), QBox Job-Name).
  • Config.CustomAdmin = true und dein Editable.isAdmin(src) in server/editable.lua gibt true zurück.

Config.AdminOnly ist standardmäßig auf false eingestellt, damit du sofort testen kannst. Setze es vor dem Release auf true, da sonst jeder den Creator öffnen kann.

5. Speicher — JSON oder Datenbank

shared/config/general.lua
Config.Storage = 'json'   -- 'json' | 'db'
  • json (Standard) — Zonen werden in data/zones.json innerhalb der Resource gespeichert. Kein Setup erforderlich.
  • db — Zonen werden in oxmysql gespeichert. Die Tabelle wird beim ersten Start automatisch erstellt; du musst kein SQL importieren:
auto-created table
CREATE TABLE IF NOT EXISTS bupa_safezones (
    id   VARCHAR(64) PRIMARY KEY,
    data LONGTEXT
);

6. Sprache

Die Sprache wird global über den Locale-Convar von ox_lib festgelegt. Füge dies zur server.cfg hinzu:

server.cfg
setr ox:locale "tr"

Englisch dient als Fallback für alle fehlenden Schlüssel. Siehe Localization für die vollständige Liste der mitgelieferten Sprachen.