Skip to content

Pemasangan

Installation

1. Dependencies

Instal dan jalankan ox_lib sebelum resource ini. Jika Anda berencana menggunakan penyimpanan database, oxmysql juga harus berjalan.

2. Drop the resource in

Letakkan bupa-safezonecreator di dalam folder resources Anda (misalnya di dalam folder kategori [BUPA]) dan tambahkan ke server.cfg Anda.

3. server.cfg — ensure order

ox_lib (dan oxmysql, jika digunakan) harus dijalankan sebelum resource ini.

server.cfg
ensure ox_lib
ensure oxmysql            # only if you use Storage = 'db'
ensure bupa-safezonecreator

4. Admin access

Membuka pembuat zona dibatasi. Selama pengujian, fitur ini terbuka untuk semua orang — kunci aksesnya sebelum server Anda rilis ke publik.

shared/config/general.lua
Config.AdminOnly = false   -- TODO: set true before release (currently open to everyone)
Config.AdminAce  = 'bupa.safezone'
Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.CustomAdmin = false -- true = use your own IsPlayerAdmin() in server/editable.lua

Setelah AdminOnly = true, pemain dapat melewati batasan jika salah satu kondisi berikut terpenuhi:

  • Mereka memiliki izin ACE — berikan izin dengan:
server.cfg
  add_ace group.admin bupa.safezone allow
  
  • Grup framework mereka ada di dalam Config.AdminGroups (grup ESX, nama job QB-Core / HasPermission('admin'), nama job QBox).
  • Config.CustomAdmin = true dan fungsi Editable.isAdmin(src) Anda di server/editable.lua mengembalikan nilai true.

Config.AdminOnly diatur ke false secara default agar Anda dapat langsung mengujinya. Ubah menjadi true sebelum rilis, atau siapa pun dapat membuka pembuat zona.

5. Storage — JSON or database

shared/config/general.lua
Config.Storage = 'json'   -- 'json' | 'db'
  • json (default) — zona ditulis ke data/zones.json di dalam resource. Tanpa pengaturan tambahan.
  • db — zona disimpan di oxmysql. Tabel akan dibuat secara otomatis saat pertama kali dijalankan; Anda tidak perlu mengimpor file SQL apa pun:
auto-created table
CREATE TABLE IF NOT EXISTS bupa_safezones (
    id   VARCHAR(64) PRIMARY KEY,
    data LONGTEXT
);

6. Language

Bahasa diatur secara global melalui convar locale milik ox_lib. Tambahkan ke server.cfg:

server.cfg
setr ox:locale "tr"

Bahasa Inggris adalah cadangan (fallback) untuk setiap kunci yang hilang. Lihat Localization untuk daftar lengkap bahasa yang tersedia.