Tattoo shop

1. 01

   Resource ablegen

   Hol dir das Script aus deinem Tebex-Konto, kopier den Ordner avenida_tattoo/ in dein resources-Verzeichnis und füg ensure avenida_tattoo hinter ensure oxmysql in deine Serverconfig ein.

2. 02

   SQL ausführen

   Führ Abschnitt [A] von INSTALL.sql auf deiner Datenbank aus. Abschnitt [B] ist bedingt, der Dateikopf sagt, wann du ihn brauchst.

3. 03

   Preise festlegen

   Öffne config/tattoo.lua. Der feste Satz, die Multiplikatoren pro Collection und die Lasergebühr sind die drei Zahlen, die du vor der Eröffnung festlegen solltest. Sprache und Bridges liegen in config/config.lua.

4. 04

   Integrationen prüfen

   Setz Config.Debug = true, starte neu und lies die Konsole: Eine Zeile pro Bridge-Kategorie nennt das gewählte Target. Setz es wieder auf false, sobald die Zeilen zu deinem Server passen. Die freigeschalteten Diagnosebefehle kosten einen Frame-Hitch.

5. 05

   Admin-Rechte geben

   Füg add_ace group.admin avenida_tattoo.admin allow in deine Serverconfig ein und ruf dann im Spiel /avenida_tattoo_check für den vollen Bericht auf.

Den Preis der Tinte festlegen

Ein fester Satz deckt den ganzen Katalog ab, und die Multiplikatoren machen alte Collections billig und seltene teuer, ohne 1615 Motive von Hand zu bepreisen. Alles wird beim Bezahlen serverseitig neu berechnet.

-- 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
}

Öffentliche Exports nach Bereich gruppiert. Jede Zeile zeigt die Signatur und was der Export macht, nicht wie er es macht.

Client

• GetHairbase

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

  Die Hairbase, die der Ped gerade trägt. Das Ink-Studio besitzt sie nicht, muss sie aber nach jedem Redraw zurückgeben, und jede Resource von dir, die Decorations löscht, muss das genauso tun.

• GetTattoos

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

  Die vollständige Liste der getragenen Tattoos als Paare aus Collection und Name-Hash. Das ist die maßgebliche Kopie: Der Laser streicht Einträge daraus, ein Kauf legt neue dazu, lies sie also aus, statt selbst zu cachen.

• GetSkinData

  exports['avenida_tattoo']:GetSkinData() Kopieren

  Der gespeicherte Charakter samt der Zonen-Korrekturen, die die Tinte auf Torso, Armen und Beinen richtig platzieren. Nützlich, wenn dein Script wissen muss, auf welchem Körper es zeichnet.

• ApplySkin

  exports['avenida_tattoo']:ApplySkin(data, ped) Kopieren

  Überträgt ein Aussehen auf einen Ped, Tattoos inklusive. Der Decoration-Slot wird in einem Durchgang neu aufgebaut. Das vermeidet das Flackern, das entsteht, wenn die Tinte Stück für Stück gesetzt wird.

• ApplyClothing

  exports['avenida_tattoo']:ApplyClothing(data, ped, temporary) Kopieren

  Zieht einen Ped an, ohne die Tinte anzufassen. Das dritte Argument hält die Änderung aus der Datenbank heraus, genau richtig für eine Szene, die endet, wenn der Spieler weggeht.

Praxisnahe Copy-Paste-Beispiele. In deine eigene Resource kopieren, Werte anpassen, fertig.

-- 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

• Warum fehlen manche Tattoos im Shop?
  Zwei Gründe, beide gewollt. Neuere DLC-Collections werden nach Game Build eingemischt, ein Motiv, das dein Client nicht rendern kann, wird also gar nicht erst gelistet, statt gelistet und kaputt zu sein. Und mit aktivem `PricePerZone` werden nur Tattoos verkauft, die in einer deklarierten Zone landen, was in der Config auch so steht: Der größte Teil des Katalogs verschwindet, bis du die Overrides gefüllt hast. Im Standard, also mit ausgeschaltetem `PricePerZone`, steht der ganze Katalog zum Verkauf.
• Ein Tattoo taucht im falschen Tab auf
• Welche Frameworks werden wirklich unterstützt?
• Funktioniert es mit dem ox-Stack?
• Was kostet mich vRP?
• Kann ich es neben avenida_barber und avenida_clotheshops laufen lassen?
• Sind die Tattoo-Namen übersetzt?
• Was kostet es, wenn niemand im Shop ist?