الخرائط ومحرر المسارات

يأتي MG-Payload مع خريطتين: South Side و Paleto Bay. ويمكنك إضافة خرائطك الخاصة بمحرر المسارات المدمج.

صيغة الخريطة

الخرائط موجودة في Config.Maps داخل config.lua:

{
    id = 'southside',
    label = 'South Side',
    enabled = true,
    attackerSpawn = { vector4(...), ... },
    defenderSpawn = { vector4(...), ... },
    payload = {
        model = 'stockade',
        startCoords = vector4(-136.747, -1545.692, 34.099, 136.063),
        escortRadius = 12.0,
        contestRadius = 12.0,
        maxEscortPlayers = 3,
        baseSpeed = 1.3,
        speedPerExtraPlayer = 0.25,
        maximumSpeed = 2.0,
        rollbackEnabled = true,
        rollbackDelay = 10,
        rollbackSpeed = 0.5,
    },
    route = { vector4(...), ... },
    checkpoints = {
        { routeIndex = 41, label = 'South Side Checkpoint #1', addedTime = 240 }
    },
    boundaries = {
        center = vector3(-78.74, -1758.83, 35.96),
        radius = 1500.0
    }
},

الخاصية	الوصف
id	مفتاح فريد للخريطة، تستخدمه أوامر مثل /payloadsetmap.
enabled	false يخفي الخريطة من التصويت.
attackerSpawn / defenderSpawn	نقاط الرسبون لكل فريق.
payload.model	المركبة التي تتم مرافقتها.
payload.escortRadius	المسافة التي يجب أن يكون فيها المهاجمون لدفع المركبة.
payload.contestRadius	المسافة التي يجب أن يكون فيها المدافعون لإيقافها.
payload.baseSpeed / speedPerExtraPlayer / maximumSpeed	سرعة المركبة، والزيادة لكل مرافق إضافي.
payload.rollback*	المركبة ترجع للخلف إذا لم يرافقها أحد.
route	المسار الذي تتبعه المركبة، نقطة بنقطة.
checkpoints	نقاط على المسار (حسب الترتيب) تضيف وقتًا.
boundaries	منطقة اللعب. يجب أن يبقى اللاعبون داخل هذه الدائرة.

بناء مسار داخل اللعبة

فقط الأدمنز الموجودون في Config.Admins يستطيعون استخدام المحرر.

1. قف في مكان بداية المركبة واكتب /payloadeditor.
2. امشِ أو قد على طول المسار. اضغط E لوضع نقطة مسار.
3. اضغط G لتحويل النقطة الحالية إلى نقطة تفتيش.
4. اضغط H لإظهار أو إخفاء معاينة المسار.
5. استخدم /payloadundo لحذف آخر نقطة، أو /payloadclear للبدء من جديد.
6. اكتب /payloadsave.

يُحفظ المسار كملف جديد في مجلد generated_routes/ داخل السكربت. انسخ route و checkpoints منه إلى خريطة جديدة في Config.Maps، وأضف نقاط الرسبون والحدود، ثم أعد تشغيل السكربت.

TIP

اجعل المسافات بين النقاط متساوية على طول الطريق. المسموح حتى 250 نقطة و 20 نقطة تفتيش لكل مسار.

يمكن تغيير أزرار المحرر في Config.Editor:

Config.Editor = {
    Enabled = true,
    ToggleKey = 'H',
    PointKey = 'E',
    CheckpointKey = 'G',
    MaximumPoints = 250,
    MaximumCheckpoints = 20,
}

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

1. اكتب /payloadtest لبدء جولة تجريبية وحدك.
2. اكتب /payloadsetmap <id> لتغيير الخريطة.
3. اكتب /payloaddebug لرسم المسار ونقاط التفتيش والحدود.
4. اكتب /payloadteststop عند الانتهاء.