الإعدادات

كل الإعدادات موجودة في config.lua. أعد تشغيل السكربت بعد أي تعديل.

عام

الإعداد	الافتراضي	الوصف
`Config.Item`	`'flaptop'`	الأيتم الذي يفتح لابتوب العائلة.
`Config.SafeProp`	`'prop_ld_int_safe_01'`	موديل خزنة العائلة.

الأنظمة

يتم التعرف على كل شيء تلقائيًا. غيّر القيمة فقط إذا أردت فرض ريسورس معيّن.

lua

Config.Systems = {
    Framework = 'auto',
    Inventory = 'auto',
    Target = 'auto',
    Menu = 'auto',
    Input = 'auto',
    Notify = 'auto',
    Progress = 'auto',
}

اترك Config.Inventory.ResourceName = 'qb-inventory' كما هو، فهو مجرد قيمة احتياطية.

المافيا

المافيا تدير كل العائلات من اللابتوب.

lua

Config.Mafia = {
    name = 'maf',            -- job or gang name that counts as Mafia
    useJob = true,           -- players with this job are Mafia
    useGang = true,          -- players in this gang are Mafia
    addCommand = 'addfamily',
    mafiaCommand = false,    -- set a name (e.g. 'mafia') to open the dashboard by command
}

المفتاح	المعنى
`name`	اسم الوظيفة أو العصابة التي تُعتبر مافيا.
`useJob` / `useGang`	هل تُحسب الوظيفة و/أو العصابة.
`addCommand`	أمر إنشاء عائلة جديدة.
`mafiaCommand`	ضع اسمًا (مثل `'mafia'`) لفتح لوحة المافيا بأمر.

إنشاء عائلة

كعضو في المافيا، قف في المكان الذي تريد وضع خزنة العائلة فيه.
اكتب /addfamily.
ضع الخزنة بأداة التحريك، ثم أدخل بيانات العائلة والقائد.

الرتب والصلاحيات

لكل عائلة أربع رتب. المستوى الأعلى = رتبة أعلى.

الرتبة	المستوى
Leader	3
CoLeader	2
Manager	1
Member	0

الصلاحيات الافتراضية لكل رتبة:

الصلاحية	Leader	CoLeader	Manager	Member
`invite_members`	✓	✓	✓
`view_family_settings`	✓	✓	✓	✓
`edit_family_settings`	✓
`remove_roster_members`	✓	✓
`manage_matchmaking_queue`	✓	✓	✓
`edit_roster_roles`	✓	✓
`family_safe_stash_access`	✓	✓	✓	✓
`family_upgrades_buy`	✓	✓	✓

يمكنك تغييرها في Config.FamilyRoleDefaultPermissions.

العائلات الجديدة

lua

Config.FamilyRosterMembersBase = 25   -- starting member slots
Config.FamilyRosterMembersMax = 30    -- hard cap

Config.NewFamily = {
    level = 1,
    xp = 0,
    safeHealth = 50,
    safeHealthMax = 50,
    coins = 50,
}

Config.FamilyInvite = {
    expireSeconds = 120,
}

العائلة الجديدة تبدأ بـ 25 خانة عضو (الحد الأقصى 30)، و 50 صحة للخزنة، و 50 عملة. والدعوة تنتهي بعد 120 ثانية.

المستويات

Config.FamilyLevelProgression يحدد الـ XP المطلوب لكل مستوى من الـ 50 مستوى. تكسب العائلات XP من نتائج حرب الخزائن.

الترقيات

تشتري العائلات الترقيات بالعملات عند الوصول للمستوى المطلوب.

الترقية	المستوى	العملات	التأثير
Family roster expansion I	5	50	+5 خانات أعضاء
Safe Reinforcement I	8	80	+40 لأقصى صحة للخزنة
Safe Security Matrix I	12	100	اختراق أصعب (جولة ثالثة)

lua

Config.Upgrades = {
    {
        id = 1,
        key = 'roster_expansion_1',
        name = 'Family roster expansion I',
        desc = '...',
        level = 5,
        Coins = 50,
        rosterIncrease = 5,
    },
    -- safeHealthIncrease = 40   / safeHackLevel = 1
}

عملات العائلة (التوكنات)

استخدام أيتم التوكن يعطي العائلة عملات. يجب أن يكون اللاعب في عائلة.

الأيتم	العملات
`token_store` (F)	1–3
`token_house` (E)	5–7
`token_truck` (D)	7–10
`token_laundry` (C)	10–13
`token_cashexchange` (B)	15–20
`token_fleeca` (A)	20–25
`token_global` (S+)	25–30

أعطِ هذه التوكنات كمكافأة في سكربتات السرقة لديك، حتى تكسب العائلات عملات من الجرائم.

مخزن الخزنة وإصلاحها

lua

Config.MafiaSafeStash = {
    enabled = true,
    slots = 30,
    maxWeight = 500000,
    requiredPermission = 'family_safe_stash_access',
}

Config.repair_safe = {
    enabled = true,
    coinsPrice = 25,
    bankPrice = 2500,
    itemName = 'repairkit',
    scrapItem = 'safescrap',
    repairIntervalMs = 30 * 60 * 1000,  -- repair tick every 30 minutes
    healthPerScrap = 0.5,
}

تضع العائلات safescrap في مخزن الإصلاح الخاص بالخزنة، فتستعيد الخزنة صحتها تدريجيًا كل 30 دقيقة.

لوحة أفضل لاعب

lua

Config.MVP = {
    enabled = true,
    updateSeconds = 60,
    maxKillDistance = 1000.0,
}

خريطة اللابتوب

Config.Map يتحكم بالخريطة داخل اللابتوب. اتركه كما هو إلا إذا غيّرت صورة الخريطة.

سجلات الديسكورد

الويب هوكات موجودة في الملف الخاص بالسيرفر server/log_config.lua. لا تضعها أبدًا في config.lua لأن اللاعبين يحمّلون ذلك الملف.

lua

Config.DiscordLogs = {
    enabled = true,
    username = 'MG-Family Logs',
    webhooks = {
        default = 'https://discord.com/api/webhooks/...',
        family = '',
        mafia = '',
        matchmaking = '',
        economy = '',
        missions = '',
        messages = '',
        inventory = '',
        robbery = '',
        elimination = '',
        match_disconnect = '',
        security = '',
    },
}

الأنواع الفارغة تستخدم default. بعد إعادة التشغيل، جرّب الويب هوك من كونسول السيرفر:

mgfamilylogtest default
mgfamilylogtest robbery

الإعدادات ​

عام ​

الأنظمة ​

المافيا ​

إنشاء عائلة ​

الرتب والصلاحيات ​

العائلات الجديدة ​

المستويات ​

الترقيات ​

عملات العائلة (التوكنات) ​

مخزن الخزنة وإصلاحها ​

لوحة أفضل لاعب ​

خريطة اللابتوب ​

سجلات الديسكورد ​