Yoga minigame

1. 01

   Coloque o resource

   Baixe o script pela sua conta Tebex, copie a pasta avenida_yoga/ para o seu diretório de resources e adicione ensure avenida_yoga na config do servidor.

2. 02

   Defina o idioma e as rotinas

   Config.Locale aceita qualquer um dos quinze códigos que vêm em locales/. Config.EnabledMoves decide quais rotinas os jogadores podem começar, e Config.DefaultMove diz qual entra quando nenhuma é informada.

3. 03

   Coloque os seus spots

   As duas coordenadas de Config.Spots são exemplos, troque elas pelas suas. Cada uma leva direção, rotina e um blip que dá para desligar. Uma lista vazia desativa essa parte inteira e a thread dela.

4. 04

   Aponte as notificações para a sua stack

   Config.Notif está em auto e detecta ox_lib, okokNotify, QBCore ou ESX nessa ordem. Force o alvo se você roda vários, ou use o caminho custom de bridges/notif.lua para o seu próprio sistema.

5. 05

   Ligue a recompensa, ou não

   A atividade funciona do jeito que está sem uma linha do seu código. Quando quiser que ela pague algo, escute avenida_yoga:server:sessionCompleted e leia a pontuação. É o único ponto de integração.

Transformar uma sessão em recompensa

Um event, disparado uma vez no fim. A pontuação já vem calculada: 1 para uma rotina terminada, no máximo 0,4 se ela for abandonada, menos 8 por cento por postura falhada. O que isso vai pagar é escolha sua.

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 domínio. Cada linha mostra a assinatura da chamada e o que ela faz, não como faz.

Server

• StartYoga

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

  Começa uma sessão para um jogador a partir do seu próprio código de servidor, na rotina que você nomear ou na padrão. Retorna false quando a rotina é desconhecida ou o jogador já está numa sessão, então um job ou um prop pode reagir em vez de disparar às cegas.

• IsDoingYoga

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

  Verdadeiro enquanto o jogador tem uma sessão viva, com a expiração já contada. Útil para bloquear uma ação de job, um teleporte ou uma loja enquanto o minigame está com os controles dele na mão.

Client

• StartYoga

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

  Pede uma sessão ao servidor a partir do código de client. O pedido passa pelo registro do servidor do mesmo jeito, então não é um jeito de escapar do controle de sessão.

• IsDoingYoga

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

  Verdadeiro enquanto o jogador local está numa sessão. O gêmeo no client do export de servidor, para qualquer coisa que precise reagir no mesmo frame.

Exemplos de copiar e colar para os casos mais comuns. Você cola na sua resource, ajusta os valores e já está em produção.

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

• Precisa de framework?
  Não. A atividade nunca lê dinheiro, itens, jobs nem identidade, então não existe nada que um framework pudesse entregar. O mesmo arquivo roda em ESX, QBCore, Qbox, vRP, ox_core ou num servidor standalone sem configurar um único bridge. A única parte que sabe do seu framework é a linha de notificação, um arquivo aberto com seis caminhos.
• Preciso do ox_lib?
• Tem banco de dados?
• Um client modificado consegue forjar uma sessão perfeita?
• O que acontece quando um jogador solta uma postura?
• Dá para fazer yoga em qualquer lugar ou só num spot?
• Funciona no controle?
• Quanto custa o script quando ninguém está fazendo yoga?