Yoga minigame

1. 01

   Déposer la ressource

   Récupérez le script depuis votre compte Tebex, copiez le dossier avenida_yoga/ dans votre dossier resources, et ajoutez ensure avenida_yoga à votre configuration serveur.

2. 02

   Régler la langue et les enchaînements

   Config.Locale accepte n'importe lequel des quinze codes livrés dans locales/. Config.EnabledMoves décide des enchaînements que les joueurs peuvent lancer, et Config.DefaultMove celui utilisé quand aucun n'est précisé.

3. 03

   Placer vos spots

   Les deux coordonnées de Config.Spots sont des exemples, remplacez-les par les vôtres. Chacune prend une orientation, un enchaînement, et un blip que vous pouvez couper. Une liste vide désactive toute la fonctionnalité et son thread.

4. 04

   Diriger les notifications vers votre stack

   Config.Notif est sur auto et détecte ox_lib, okokNotify, QBCore ou ESX dans cet ordre. Forcez une cible si vous en faites tourner plusieurs, ou utilisez la branche custom de bridges/notif.lua pour votre propre système.

5. 05

   Brancher la récompense, ou pas

   L'activité fonctionne telle quelle sans une ligne de votre code. Quand vous voudrez qu'elle rapporte quelque chose, écoutez avenida_yoga:server:sessionCompleted et lisez le score. C'est le seul point d'intégration.

Transformer une séance en récompense

Un event, déclenché une fois à la fin. Le score est déjà calculé : 1 pour un enchaînement terminé, plafonné à 0,4 pour un abandon, moins 8 pour cent par posture ratée. Ce qu'il rapporte vous appartient.

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)

Exports publics groupés par domaine. Chaque ligne montre la signature d'appel

Server

• StartYoga

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

  Lance une séance pour un joueur depuis votre code serveur, sur l'enchaînement que vous nommez ou sur celui par défaut. Renvoie false quand l'enchaînement est inconnu ou que le joueur est déjà en séance, un job ou un prop peut donc réagir au lieu de tirer à l'aveugle.

• IsDoingYoga

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

  Vrai tant que le joueur tient une séance en cours, expiration comprise. Utile pour bloquer une action de job, un téléport ou une boutique pendant que le minijeu tient ses contrôles.

Client

• StartYoga

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

  Demande une séance au serveur depuis du code client. La demande passe quand même par le registre serveur, ce n'est donc pas un moyen de contourner le garde-fou de session.

• IsDoingYoga

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

  Vrai tant que le joueur local est en séance. Le jumeau côté client de l'export serveur, pour tout ce qui doit réagir dans la même frame.

Exemples copier-coller pour les cas courants. À déposer dans ta ressource, ajuster les valeurs, et c'est en prod.

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

• Faut-il un framework ?
  Non. L'activité ne lit jamais l'argent, les items, les jobs ni l'identité, il n'y a donc rien qu'un framework puisse fournir. Le même fichier tourne sur ESX, QBCore, Qbox, vRP, ox_core ou un serveur nu sans un seul bridge à configurer. La seule partie qui connaisse votre framework est la ligne de notification, un fichier ouvert à six branches.
• Ai-je besoin d'ox_lib ?
• Y a-t-il une base de données ?
• Un client modifié peut-il simuler une séance parfaite ?
• Que se passe-t-il quand un joueur lâche une posture ?
• Peut-on faire du yoga partout, ou seulement sur un spot ?
• Est-ce que ça marche à la manette ?
• Que coûte le script quand personne ne fait de yoga ?