Yoga minigame

1. 01

   ضع السكربت

   حمّل السكربت من حسابك على Tebex، وانسخ مجلد avenida_yoga/ إلى مجلد resources، وأضف ensure avenida_yoga إلى إعدادات سيرفرك.

2. 02

   اضبط اللغة والسلاسل

   تقبل Config.Locale أيًا من الأكواد الخمسة عشر في locales/. وتحدّد Config.EnabledMoves السلاسل التي يمكن للاعبين تشغيلها، وConfig.DefaultMove هي السلسلة التي تُستخدم حين لا تُذكر واحدة.

3. 03

   ضع أماكنك

   الإحداثيتان في Config.Spots مثالان، استبدلهما بإحداثياتك. لكل مدخل اتجاه وسلسلة وblip يمكنك إطفاؤه. وتعطّل القائمة الفارغة الميزة كاملة ومعها الخيط.

4. 04

   وجّه الإشعارات إلى نظامك

   القيمة Config.Notif على auto وتكتشف ox_lib وokokNotify وQBCore وESX بهذا الترتيب. افرض هدفًا إن كنت تشغّل أكثر من واحد، أو استخدم فرع custom في bridges/notif.lua لنظامك الخاص.

5. 05

   اربط المكافأة، أو لا تفعل

   يعمل النشاط من دون ضبط ومن دون سطر واحد من كودك. وحين تريده أن يدفع شيئًا، استمع إلى avenida_yoga:server:sessionCompleted واقرأ النتيجة. هذه هي نقطة التكامل الوحيدة.

حوّل الجلسة إلى مكافأة

event واحد، يُطلق مرة واحدة عند النهاية. والنتيجة محسوبة سلفًا: 1 لسلسلة مكتملة، وسقف 0.4 للمهجورة، ناقص 8 بالمئة عن كل وضعية فاشلة. وما يدفعه أنت من يقرّره.

AddEventHandler('avenida_yoga:server:sessionCompleted', function(src, data)
    -- data.move       'warrior' | 'triangle' | 'sunsalutation'
    -- data.completed  true when the routine went to the end
    -- data.posesBest  poses held
    -- data.poses      poses in the routine
    -- data.fails      poses dropped
    -- data.score      0.0 to 1.0

    if not data.completed then return end

    -- your own reward: stress, stamina, a skill, a payout
    local reward = math.floor(250 * data.score)
end)

exports عامة مرتّبة حسب المجال. كل صف يعرض توقيع الاستدعاء وما يفعله، لا كيف يفعله.

Server

• StartYoga

  exports['avenida_yoga']:StartYoga(src, moveKey?) --> boolean نسخ

  يبدأ جلسة للاعب من كود السيرفر عندك، على السلسلة التي تسمّيها أو على الافتراضية. ويعيد false حين تكون السلسلة مجهولة أو اللاعب داخل جلسة أصلًا، فيستطيع job أو prop أن يتصرّف بدل أن يطلقها على العمياء.

• IsDoingYoga

  exports['avenida_yoga']:IsDoingYoga(src) --> boolean نسخ

  يعيد true ما دامت للاعب جلسة حيّة، مع احتساب انتهاء الصلاحية. مفيد لتعطيل إجراء وظيفة أو تنقّل أو متجر ما دام الميني قيم ممسكًا بتحكّمه.

Client

• StartYoga

  exports['avenida_yoga']:StartYoga(moveKey?) --> boolean نسخ

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

• IsDoingYoga

  exports['avenida_yoga']:IsDoingYoga() --> boolean نسخ

  يعيد true ما دام اللاعب المحلي داخل جلسة. وهو توأم export السيرفر على جهة العميل، لكل ما يجب أن يتفاعل في الفريم نفسه.

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

-- config/config.lua
Config.Spots = {
    {
        coords  = vector3(-1204.02, -1566.28, 3.63),
        heading = 125.0,
        move    = 'menu',
        blip    = { sprite = 311, colour = 2, scale = 0.7 },
    },
}

local started = exports['avenida_yoga']:StartYoga(src, 'sunsalutation')

if not started then
    -- unknown routine, or the player is already in a session
    return
end

-- config/config.lua
Config.BreathingAttempts = 3      -- missed cycles before a pose fails
Config.MaxFails          = 5      -- failed poses before the session stops
Config.HoldBreathFailMs  = 15000  -- holding the breath longer fails the pose
Config.MouseGain         = 3.0    -- marker sensitivity on mouse and keyboard

-- config/config.lua
Config.EnabledMoves = { 'warrior' }
Config.DefaultMove  = 'warrior'

• هل يحتاج إلى framework؟
  لا. لا يقرأ النشاط المال ولا الأغراض ولا الوظائف ولا الهوية، فليس هناك ما يمكن لـ framework أن يوفّره. ويعمل الملف نفسه على ESX وQBCore وQbox وvRP وox_core أو على سيرفر مجرّد دون ضبط أي bridge. والجزء الوحيد الذي يعرف الـ framework عندك هو سطر الإشعارات، وهو ملف مفتوح بستة فروع.
• هل أحتاج إلى ox_lib؟
• هل هناك قاعدة بيانات؟
• هل يستطيع عميل معدَّل تزوير جلسة مثالية؟
• ماذا يحدث حين يترك اللاعب وضعية؟
• هل يمكن ممارسة اليوغا في أي مكان أم في مكان محدد فقط؟
• هل يعمل على يد التحكّم؟
• كم يكلّف السكربت حين لا يمارس أحد اليوغا؟