Clothing store

1. 01

   ضع السكربت

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

2. 02

   نفّذ ملف SQL

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

3. 03

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

   أضف add_ace group.admin avenida_clotheshops.admin allow وadd_ace group.admin avenida_clotheshops.vip allow إلى إعداد السيرفر. الأولى تفتح محرر الكتالوج، والثانية تفتح ما تضعه خلف قائمة الـ VIP.

4. 04

   سعّر الكتالوج من داخل اللعبة

   اضبط Config.DevMode.Enabled = true، وادخل متجرًا وافتح المحرر. حدّد الأسعار، وأخفِ ما لا تبيعه، واحجز ما يخص وظيفة بعينها. وكل ذلك يستقر في config/clothes_overrides.lua. وأطفئ DevMode عند الانتهاء، مع أن كل حفظ يُتحقَّق منه مجددًا على السيرفر.

5. 05

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

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

تسعير قسم بثلاث طرق

كل متجر يعلن أقسامه، وكل قسم يعلن نمط تسعيره. سعر موحّد لقسم بأكمله، أو مُعامِل يجعل الـ drawables اللاحقة أغلى، أو جدول حين لا تستحق سعرًا خاصًا إلا بضع قطع.

-- config/clothes_shops.lua
categories = {
    tops = {
        enabled = true,
        price   = { mode = 'fixed', base = 300 },
    },
    pants = {
        enabled = true,
        -- price = base + index * mult
        price   = { mode = 'multiplier', base = 100, mult = 2 },
    },
    mask = {
        enabled = true,
        price   = { mode = 'table', map = { [12] = 900, [45] = 1500 } },
        -- only these drawables are offered
        whitelist = { 12, 45, 51 },
    },
}

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

Client

• GetSkinData

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

  الزيّ الذي يرتديه اللاعب، مكوّنًا بمكوّن، بما في ذلك الـ props. وهذا ما يكتبه المتجر عند الشراء، فيبقى دائمًا متوافقًا مع ما تعرضه خزانة الملابس.

• ApplySkin

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

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

• ApplyClothing

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

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

Server

• GetBagStorage

  exports['avenida_clotheshops']:GetBagStorage(sex, drawable) --> { weight, slots } | nil نسخ

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

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

-- config/clothes_shops.lua
Config.Clothes.Shops[22] = {
    name       = 'Ponsonbys - Rockford Hills',
    payment    = 'bank',
    currency   = '$',
    tax        = 0.20,        -- +20% on the cart
    discount   = 0.00,
    outfitMode = true,
    blip = { sprite = 73, color = 4, scale = 0.7, coords = vec3(-708.2, -152.2, 37.4) },
    categories = {
        tops  = { enabled = true, price = { mode = 'fixed', base = 900 } },
        shoes = { enabled = true, price = { mode = 'fixed', base = 450 } },
    },
}

-- config/clothes_overrides.lua, or write it from the in-game editor
Overrides['tops'] = {
    [56] = { job = 'police', label = 'LSPD jacket' },
    [12] = { hidden = true },
    [31] = { restricted = true },   -- ACE permission
}

-- config/clothes.lua
Config.Clothes.RequireOwnership = false

-- how far from a store the server still accepts a purchase
Config.Clothes.PurchaseRange = 30.0

-- saved outfits per character, enforced server side
Config.Clothes.MaxOutfits = 30
Config.Clothes.MaxOutfitsRestricted = 50

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

-- your own clothing 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

• لاعب يقول إنه فقد ملابس كان يملكها
  راجع `Config.Clothes.RequireOwnership`. السجل يبني بيانات الشخصية مما ترتديه أصلًا أول مرة يراها، فتفعيله لا يسحب خزانة أحد. أما ما يرفضه فهو كتابة لقطعة بلا شراء خلفها، وهذا تحديدًا ما يرسله عميل معدَّل. وإذا كان لديك ريسورس يمنح اللاعبين قطعًا لم تُشترَ، فسجّل تلك المشتريات أو اضبط الخيار على false.
• محرر الكتالوج لا يفتح
• السترة نفسها تظهر عدة مرات
• الشعر يخترق الخوذة
• هل تحتاج صور الأطقم إلى شيء؟
• ما الفريموركات المدعومة فعلًا؟
• هل أشغّله مع avenida_barber وavenida_tattoo؟
• كم يكلّف حين لا يتسوق أحد؟