Skip to content

Configuration

الإعدادات

جميع الخيارات موجودة في ملف shared/config/general.lua.

التخزين

shared/config/general.lua
Config.Storage = 'json'   -- 'json' يكتب البيانات في data/zones.json | 'db' يستهخدم oxmysql

راجع التثبيت للتعرف على جدول قاعدة البيانات الذي يتم إنشاؤه تلقائياً.

حدود الحماية ضد الثغرات

يتحقق الخادم من كل عملية حفظ مقابل هذه الحدود ويرفض أو يقيد أي شيء يتجاوزها. قم بتخفيضها للخوادم الأكثر صارمة.

shared/config/general.lua
Config.Limits = {
    maxZones     = 100,   -- إجمالي المناطق على الخادم
    maxPoints    = 64,    -- النقاط لكل منطقة
    maxJobs      = 40,    -- الوظائف لكل منطقة
    maxWeapons   = 250,   -- المدخلات في قوائم السماح/المنع للأسلحة
    maxLabelLen  = 64,    -- الحد الأقصى للأحرف في اسم المنطقة
    saveCooldown = 1000,  -- الوقت بالمللي ثانية بين عمليات الحفظ لكل لاعب
}

فاصل التحقق

مدى تكرار (بالمللي ثانية) إعادة تقييم العميل للمناطق التي يتواجد اللاعب داخلها.

shared/config/general.lua
Config.CheckInterval = 300

واجهة المستخدم داخل المنطقة (HUD)

شعار الزجاج الذي يظهر أثناء التواجد داخل المنطقة. يتم تحديد ما إذا كان سيظهر أم لا لكل منطقة على حدة بواسطة قاعدة showHud — هذا يتحكم فقط في موقعه وعنوانه.

shared/config/general.lua
Config.Hud = {
    -- إحدى نقاط التثبيت الـ 9:
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = استخدام اسم المنطقة نفسه
}

علامة الأرض

يتم رسمها أثناء تفعيل منطقة تحتوي على groundMarker = true.

shared/config/general.lua
Config.Marker = {
    type = 1,
    size = { r = 60.0, g = 108.0, b = 240.0, a = 90 },
}

تأثيرات الدخول / الخروج

لمسات جمالية عامة تضاف فوق قواعد كل منطقة — ومضة شاشة ملونة وصوت في واجهة المستخدم عند الدخول والخروج.

shared/config/general.lua
Config.Effects = {
    enabled    = true,
    flash      = true,                 -- ومضة شاشة ملونة عبر الـ NUI
    sound      = true,                 -- صوت تنبيه في الواجهة عند الدخول / الخروج
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

الإشعارات

shared/config/general.lua
Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'
  • auto — استخدام إشعارات الإطار البرمجي (Framework) المُكتشف.
  • ox — فرض استخدام إشعارات ox_lib.
  • framework — استخدام نظام الإطار البرمجي نفسه.
  • custom — استدعاء دالتك الخاصة (Hook) في client/editable.lua.

المخزون (مصدر قائمة الأسلحة)

يقوم محدد الأسلحة بسحب قائمة الأسلحة وأيقوناتها الحقيقية مباشرة من مخزونك، لكي يرى اللاعبون الصور الدقيقة الموجودة في حقائبهم.

shared/config/general.lua
Config.Inventory         = 'auto'  -- 'auto' | 'ox' | 'qb' | 'esx' | 'tgiann' | 'codem'
Config.InventoryResource = nil     -- تجاوز اسم الرسورس إذا تم تغيير إسمه
Config.InventoryImagePath = nil    -- تجاوز المسار الأساسي للصور، مثل 'nui://my_inv/html/images/'

يقوم خيار auto باكتشاف ox_inventory, qb-inventory, esx_inventory, tgiann-inventory أو codem-inventory. خيار WEAPON_UNARMED متاح دائماً للاختيار.

القواعد الافتراضية

Config.DefaultRules هي مجموعة القواعد التي يتم تطبيقها على كل منطقة جديدة تماماً. راجع قواعد المناطق لمعرفة وظيفة كل مفتاح.