Barber shop

1. 01

   ضع السكربت

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

2. 02

   نفّذ ملف SQL

   نفّذ القسم [A] من INSTALL.sql على قاعدة بياناتك. القسم [B] مشروط، ورأس الملف يقول متى تحتاجه.

3. 03

   راجع الإعدادات

   افتح config/config.lua. القيم الافتراضية تناسب أغلب السيرفرات، والسطر الوحيد الجدير بالمراجعة هو Config.Locale. والأسعار والمتاجر وسلوك الكرسي في الملف المجاور config/barber.lua.

4. 04

   تحقق من التكاملات

   اضبط Config.Debug = true، وأعد التشغيل، واقرأ الكونسول: سطر لكل فئة bridge يسمّي الهدف الذي اختير. أعده إلى false حالما تطابق الأسطر سيرفرك، فأوامر التشخيص التي يفتحها تكلّف تقطيعًا في الفريمات.

5. 05

   امنح نفسك صلاحيات الإدارة

   أضف add_ace group.admin avenida_barber.admin allow إلى إعداد السيرفر، ثم نفّذ /avenida_barber_check داخل اللعبة للحصول على التقرير الكامل.

افرض تكاملًا بدل أن تكشفه

الكشف التلقائي يغطي أغلب السيرفرات، وهو يجسّ الـ export الحقيقي لا حالة الريسورس. وعلى سيرفر ذي تركيبة خاصة، افرض الهدف فيُتخطى الكشف كليًا.

-- config/config.lua
Config.Locale    = 'en'
Config.UseOxLib  = true

Config.Framework = 'auto'   -- 'qbcore' | 'esx' | 'vrp' | 'standalone' | 'custom'
Config.Notif     = 'ox_lib' -- 'qbcore' | 'esx' | 'ox_lib' | 'okok' | 'vrp' | 'chat' | 'custom'
Config.Interact  = 'auto'   -- 'avenida' | 'ox_target' | 'qb-target' | 'standalone' | 'custom'
Config.Clothing  = 'auto'   -- 'qb' | 'illenium' | 'fivem-appearance' | 'esx_skin' | 'vrp' | 'table' | 'custom'

Config.Camera = {
    Sensitivity = 1.0,      -- rotation, zoom and height, clamped to 0.1 - 5.0
    InvertY     = false,
}

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

Client

• GetHairbase

  exports['avenida_barber']:GetHairbase() --> { c = collection, t = nameHash } | nil نسخ

  قاعدة الشعر التي يرتديها الـ ped الآن، أو nil إذا كانت قصّة الشعر لا تحتاج إليها. اقرأها قبل استدعاء ClearPedDecorations وأعدها بعده، فيحتفظ الشعر بتظليله بدل أن يصبح قبعة مسطّحة.

• GetTattoos

  exports['avenida_barber']:GetTattoos() --> { { c, t }, ... } نسخ

  كل زخارف الوشم التي يملكها هذا السكربت على الـ ped. والحلاق يتقاسم خانة الزينة الوحيدة مع الوشم، وأي إعادة رسم تتجاهل هذه القائمة تمحو وشومًا دفع اللاعب ثمنها.

• GetSkinData

  exports['avenida_barber']:GetSkinData() نسخ

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

• ApplySkin

  exports['avenida_barber']:ApplySkin(data, ped) نسخ

  يكتب مظهرًا كاملًا على ped. مرّر الـ ped الذي تريد تلبيسه، ويمكن أن يكون نسخة معاينة بدل اللاعب، فتستطيع المرآة أو شاشة اختيار الشخصية أن تعرض الوجه نفسه.

• ApplyClothing

  exports['avenida_barber']:ApplyClothing(data, ped, temporary) نسخ

  يطبّق جزء الملابس فقط ويترك الوجه والشعر دون تغيير. واضبط temporary على true لزيّ يجب ألا يُحفَظ في قاعدة البيانات، كزيّ السجن أو التنكّر.

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

-- config/config.lua
Config.Camera = {
    Sensitivity = 1.4,          -- faster drag
    InvertY     = true,
}

Config.UI = {
    Tutorial          = true,   -- first-run tour, replayable from the toolbar
    Sounds            = true,
    Blips             = true,

    Timecycle         = 'casino_brightroom',
    TimecycleStrength = 1.0,
    TimecycleFadeMs   = 400,    -- 0 makes it snap like a light switch

    DofStrength       = 0.1,    -- false drops the per-frame SetUseHiDof call
    DofPlanes         = { 0.4, 0.7, 2.2, 4.5 },
}

-- config/barber.lua
Config.Barber.ChairScene = false   -- menu opens on the spot

Config.Barber.Shops[9] = {
    BarberPedModel = 's_m_m_hairdress_01',
    Welcome        = vec3(-1282.60, -1116.60, 6.99),
    Blip           = { sprite = 71, color = 4, scale = 0.7 },
}

local hairbase = exports['avenida_barber']:GetHairbase()
local tattoos  = exports['avenida_barber']:GetTattoos()

ClearPedDecorations(PlayerPedId())
-- your own decoration work here

if hairbase then
    AddPedDecorationFromHashes(PlayerPedId(), hairbase.c, hairbase.t)
end
for _, dec in ipairs(tattoos) do
    AddPedDecorationFromHashes(PlayerPedId(), dec.c, dec.t)
end

AddEventHandler('avenida_barber:client:uiStateChanged', function(hidden)
    if hidden then
        exports['myhud']:hide()
    else
        exports['myhud']:show()
    end
end)

• ما الفريموركات المدعومة فعلًا؟
  QBCore وESX وvRP، إضافة إلى وضع standalone لا يحتاج إلى أي فريمورك، وفرع `custom` في `bridges/framework.lua` لأي شيء آخر. الكشف يعمل عند الإقلاع ويجسّ الـ export الحقيقي. أما Qbox وox_core فلا فرع مخصص لهما: يمران عبر مسار standalone أو custom، لا عبر هدف مُختبَر.
• ماذا يكلفني vRP؟
• هل يعمل مع حزمة ox؟
• هل أشغّله مع avenida_tattoo وavenida_clotheshops؟
• تسريحة ناقصة من القائمة
• الرأس لا يتابع مؤشري
• هل أضيف لغة أخرى؟
• كم يكلّف حين لا يكون أحد في المتجر؟