التثبيت

1. الاعتماديات

قم بتثبيت وتشغيل ox_lib قبل هذا المورد. إذا كنت تخطط لاستخدام تخزين قاعدة البيانات، فيجب أن يعمل oxmysql أيضاً.

2. ضع المورد

ضع bupa-safezonecreator في مجلد الموارد الخاص بك (على سبيل المثال داخل مجلد فئة [BUPA]) وأضفه إلى ملف server.cfg الخاص بك.

3. server.cfg — ترتيب التشغيل

يجب أن تبدأ ox_lib (و oxmysql، إذا تم استخدامه) قبل المورد.

ensure ox_lib
ensure oxmysql            # فقط إذا كنت تستخدم Storage = 'db'
ensure bupa-safezonecreator

4. صلاحيات المشرفين

فتح منشئ المناطق مقيد. أثناء الاختبار يكون متاحاً للجميع — قم بقفله وتأمينه قبل الإطلاق الرسمي.

Config.AdminOnly = false   -- TODO: اضبطه على صحيح (true) قبل الإطلاق (مفتوح حالياً للجميع)
Config.AdminAce  = 'bupa.safezone'
Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.CustomAdmin = false -- true = استخدام دالة IsPlayerAdmin() الخاصة بك في server/editable.lua

بمجرد أن يصبح AdminOnly = true، ينجح اللاعب في تجاوز القيد إذا كان أي مما يلي صحيحاً:

• يحمل إذن ACE — امنحه باستخدام:

  add_ace group.admin bupa.safezone allow
  

• مجموعة الإطار (Framework) الخاصة به موجودة في Config.AdminGroups (مجموعة ESX، اسم وظيفة QB-Core / HasPermission('admin')، اسم وظيفة QBox).
• Config.CustomAdmin = true وتعيد دالة Editable.isAdmin(src) في ملف server/editable.lua القيمة true.

5. التخزين — JSON أو قاعدة البيانات

Config.Storage = 'json'   -- 'json' | 'db'

• json (الافتراضي) — يتم كتابة المناطق في ملف data/zones.json داخل المورد. بدون أي إعدادات مطلوبة.
• db — يتم تخزين المناطق في oxmysql. يتم إنشاء الجدول تلقائياً عند التشغيل الأول؛ لست بحاجة إلى استيراد أي ملف SQL:

CREATE TABLE IF NOT EXISTS bupa_safezones (
    id   VARCHAR(64) PRIMARY KEY,
    data LONGTEXT
);

6. اللغة

يتم تعيين اللغة عالمياً عبر متغير اللغات (convar) الخاص بـ ox_lib. أضف إلى server.cfg:

setr ox:locale "tr"

اللغة الإنجليزية هي اللغة الاحتياطية لأي مفتاح مفقود. راجع Localization للاطلاع على القائمة الكاملة للغات المضمنة.