Tattoo shop

1. 01

   ضع السكربت

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

2. 02

   نفّذ ملف SQL

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

3. 03

   اضبط أسعارك

   افتح config/tattoo.lua. السعر الموحّد، ومُعامِلات المجموعات، وسعر الليزر هي الأرقام الثلاثة التي تحسمها قبل فتح المتجر. أما اللغة والـ bridges ففي config/config.lua.

4. 04

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

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

5. 05

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

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

حدّد سعر الحبر

سعر موحّد يغطي الكتالوج كله، والمُعامِلات تجعل المجموعات القديمة رخيصة والنادرة غالية، دون تسعير 1615 تصميمًا يدويًا. وكل شيء يُعاد حسابه على السيرفر عند الدفع.

-- config/tattoo.lua
Config.Tattoo.Prices = {
    flat  = 1000,   -- every tattoo, unless PricePerZone is on
    hair  = 500,
    reset = 3000,   -- laser removal, per tattoo removed
}

Config.Tattoo.PricePerZone = false

Config.Tattoo.CollectionMultipliers = {
    multiplayer_overlays = 0.80,   -- base game, cheaper
    mpHipster_overlays   = 0.85,
    mpBeach_overlays     = 0.85,
    -- anything not listed stays at 1.0
}

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

Client

• GetHairbase

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

  قاعدة الشعر التي يرتديها الـ ped. استوديو الوشم لا يملكها، لكنه ملزم بإعادتها بعد كل إعادة رسم، وكذلك أي سكربت لديك يمسح الزينة.

• GetTattoos

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

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

• GetSkinData

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

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

• ApplySkin

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

  يدفع مظهرًا إلى الـ ped بما في ذلك الوشوم. ويُعاد بناء خانة الزينة دفعة واحدة، ما يمنع الوميض الذي يظهر عند تطبيق الوشم قطعة قطعة.

• ApplyClothing

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

  يغيّر ملابس الـ ped دون المساس بالوشم. الوسيط الثالث يبقي التغيير خارج قاعدة البيانات، وهو ما تريده لمشهد ينتهي بمغادرة اللاعب.

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

-- config/tattoo.lua
Config.Tattoo.PricePerZone = true

Config.Tattoo.Prices = {
    [0] = 1250, -- torso / back
    [1] = 1000, -- head
    [2] = 600,  -- left arm
    [3] = 600,  -- right arm
    [4] = 750,  -- left leg
    [5] = 750,  -- right leg
    [6] = 750,  -- unknown
    reset = 3000,
}

-- config/tattoo.lua
Config.Tattoo.SubZoneOverrides = {
    ['FM_Hip_M_Tat_000'] = 'back',
    ['MP_Buis_M_Tat_021'] = 'neck',
    -- 'back' | 'chest' | 'neck' | 'head'
}

-- config/tattoo.lua
Config.Tattoo.ApplyScene = true

Config.Tattoo.SceneCamera = {
    Enabled      = true,
    Distance     = 1.5,   -- metres in front of the player
    Height       = 0.75,  -- metres above their feet
    TargetHeight = 0.6,   -- aim at chest height
    Fov          = 42.0,
}

local hairbase = exports['avenida_tattoo']:GetHairbase()
local tattoos  = exports['avenida_tattoo']: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

• لماذا تغيب بعض الوشوم عن المتجر؟
  لسببين، وكلاهما مقصود. مجموعات الـ DLC الأحدث تُدمَج بحسب نسخة اللعبة، فالتصميم الذي لا يستطيع عميل اللاعب عرضه لا يُدرَج أبدًا بدل أن يُدرَج ويظهر معطوبًا. ومع تفعيل `PricePerZone` لا تُباع إلا الوشوم التي تقع في منطقة مُعلَنة، وهذا مذكور صراحة في الإعداد: يختفي معظم الكتالوج حتى تملأ الـ overrides. ومع إطفاء `PricePerZone`، وهو الافتراضي، يكون الكتالوج كله معروضًا.
• وشم يظهر في التبويب الخطأ
• ما الفريموركات المدعومة فعلًا؟
• هل يعمل مع حزمة ox؟
• ماذا يكلفني vRP؟
• هل أشغّله مع avenida_barber وavenida_clotheshops؟
• هل أسماء الوشوم مترجمة؟
• كم يكلّف حين لا يكون أحد في المتجر؟