Yoga minigame

1. 01

   Resource ablegen

   Hol dir das Script aus deinem Tebex-Konto, kopier den Ordner avenida_yoga/ in dein resources-Verzeichnis und trag ensure avenida_yoga in deine Serverconfig ein.

2. 02

   Sprache und Abläufe setzen

   Config.Locale nimmt jeden der fünfzehn Codes aus locales/. Config.EnabledMoves entscheidet, welche Abläufe Spieler starten dürfen, und Config.DefaultMove legt den fest, der ohne Angabe genommen wird.

3. 03

   Deine Spots setzen

   Die beiden Koordinaten in Config.Spots sind Beispiele, ersetz sie durch deine eigenen. Jeder Eintrag nimmt eine Ausrichtung, einen Ablauf und einen Blip, den du abschalten kannst. Eine leere Liste deaktiviert die Funktion samt Thread.

4. 04

   Notifications auf deinen Stack umbiegen

   Config.Notif steht auf auto und erkennt ox_lib, okokNotify, QBCore oder ESX in dieser Reihenfolge. Erzwing ein Ziel, wenn du mehrere fährst, oder nimm den custom-Zweig in bridges/notif.lua für dein eigenes System.

5. 05

   Belohnung anhängen, oder auch nicht

   Die Aktivität läuft von Haus aus, ohne eine Zeile von dir. Wenn sie etwas auszahlen soll, hör auf avenida_yoga:server:sessionCompleted und lies den Score. Das ist der einzige Integrationspunkt.

Aus einer Einheit eine Belohnung machen

Ein Event, einmal am Ende gefeuert. Der Score ist schon berechnet: 1 für einen beendeten Ablauf, bei einem Abbruch auf 0,4 gedeckelt, minus 8 Prozent pro verpatzter Pose. Was er auszahlt, entscheidest du.

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)

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

Server

• StartYoga

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

  Startet eine Einheit für einen Spieler aus deinem Servercode, mit dem genannten Ablauf oder mit dem Standard. Gibt false zurück, wenn der Ablauf unbekannt ist oder der Spieler schon in einer Einheit steckt, ein Job oder ein Prop kann also reagieren, statt blind zu feuern.

• IsDoingYoga

  exports['avenida_yoga']:IsDoingYoga(src) --> boolean Kopieren

  True, solange der Spieler eine laufende Einheit hat. Abgelaufene zählen nicht mit. Praktisch, um eine Job-Aktion, einen Teleport oder einen Shop zu blockieren, während das Minigame die Controls belegt.

Client

• StartYoga

  exports['avenida_yoga']:StartYoga(moveKey?) --> boolean Kopieren

  Fragt aus deinem Clientcode eine Einheit beim Server an. Die Anfrage läuft trotzdem über die Server-Registry, das ist also kein Weg am Schutz des Servers vorbei.

• IsDoingYoga

  exports['avenida_yoga']:IsDoingYoga() --> boolean Kopieren

  True, solange der lokale Spieler in einer Einheit ist. Das Gegenstück zum Server-Export, für alles, was im selben Frame reagieren muss.

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

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

• Brauche ich ein Framework?
  Nein. Die Aktivität liest nie Geld, Items, Jobs oder Identität, es gibt also nichts, was ein Framework liefern könnte. Dieselbe Datei läuft auf ESX, QBCore, Qbox, vRP, ox_core oder einem nackten Server, ohne dass du eine einzige Bridge konfigurierst. Das Einzige, was hier überhaupt ein Framework berührt, ist die Notification-Zeile, eine offene Datei mit sechs Zweigen.
• Brauche ich ox_lib?
• Gibt es eine Datenbank?
• Kann ein modifizierter Client eine perfekte Einheit vortäuschen?
• Was passiert, wenn ein Spieler eine Pose fallen lässt?
• Können Spieler überall Yoga machen oder nur an einem Spot?
• Funktioniert es am Controller?
• Was kostet es, wenn niemand Yoga macht?