Yoga minigame

1. 01

   Coloca el recurso

   Descarga el script desde tu cuenta Tebex, copia la carpeta avenida_yoga/ en tu directorio de recursos y añade ensure avenida_yoga a la config del servidor.

2. 02

   Elige el idioma y las rutinas

   Config.Locale acepta cualquiera de los quince códigos que vienen en locales/. Config.EnabledMoves decide qué rutinas pueden empezar los jugadores, y Config.DefaultMove la que se usa cuando no se indica ninguna.

3. 03

   Pon tus spots en el mapa

   Las dos coordenadas de Config.Spots son ejemplos, cámbialas por las tuyas. Cada una lleva su orientación, su rutina y un blip que puedes apagar. Una lista vacía desactiva toda esa parte y su thread.

4. 04

   Apunta las notificaciones a tu stack

   Config.Notif está en auto y detecta ox_lib, okokNotify, QBCore o ESX en ese orden. Fuerza un target si tienes varios, o usa la rama custom de bridges/notif.lua para tu propio sistema.

5. 05

   Engancha la recompensa, o no

   La actividad funciona tal cual, sin una línea de tu código. Cuando quieras que pague algo, escucha avenida_yoga:server:sessionCompleted y lee la puntuación. Es el único punto de integración.

Convertir una sesión en una recompensa

Un event, lanzado una sola vez al final. La puntuación ya viene calculada: 1 por una rutina terminada, como mucho 0,4 si se abandona, y un 8 por ciento menos por cada postura fallada. Lo que pague lo decides tú.

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 públicos agrupados por dominio. Cada fila muestra la firma de la llamada y qué hace, no cómo lo hace.

Server

• StartYoga

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

  Empieza una sesión para un jugador desde tu código de servidor, con la rutina que le pases o con la de por defecto. Devuelve false cuando la rutina no existe o el jugador ya está en una sesión, así que un trabajo o un prop puede reaccionar en lugar de lanzarla a ciegas.

• IsDoingYoga

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

  Verdadero mientras el jugador tiene una sesión viva, caducidad incluida. Útil para bloquear una acción de trabajo, un teletransporte o una tienda mientras el minijuego se queda con el control.

Client

• StartYoga

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

  Pide una sesión al servidor desde tu código de cliente. La petición pasa igualmente por el registro del servidor, así que no es una forma de saltarse el control de sesión.

• IsDoingYoga

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

  Verdadero mientras el jugador local está en una sesión. Es la versión de cliente del export de servidor, para todo lo que tenga que reaccionar en el mismo frame.

Ejemplos para copiar y pegar en los casos más habituales. Los metes en tu recurso, ajustas los valores y a producción.

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

• ¿Hace falta un framework?
  No. La actividad nunca lee dinero, items, trabajos ni identidad, así que no hay nada que un framework pudiera aportar. El mismo archivo funciona en ESX, QBCore, Qbox, vRP, ox_core o un servidor standalone sin configurar un solo bridge. La única parte que sabe de tu framework es la línea de notificaciones, un archivo abierto con seis ramas.
• ¿Necesito ox_lib?
• ¿Hay base de datos?
• ¿Puede un cliente modificado fingir una sesión perfecta?
• ¿Qué pasa cuando un jugador suelta una postura?
• ¿Se puede hacer yoga en cualquier sitio o solo en un spot?
• ¿Funciona con mando?
• ¿Cuánto cuesta el script cuando nadie hace yoga?