Configuração do TikFinity

Guia passo a passo para conectar o TikFinity ao BakoshApp pelo mecanismo Third-party action — funciona nos planos Free e PRO.

Este guia mostra o caminho via TikFinity — conectando eventos da live do TikTok ao BakoshApp pelo mecanismo Third-party action do TikFinity. Essa é a opção gratuita e funciona em qualquer plano do BakoshApp. Para uma alternativa sem TikFinity, veja Native Connector.

O que é uma Third-party action

Third-party action é um tipo de action do TikFinity que encaminha um evento da live do TikTok para um programa externo — no nosso caso, o BakoshApp:

O TikFinity captura o evento → encaminha para o BakoshApp → o BakoshApp roda o efeito no jogo.

Você pode rotear os seguintes eventos do TikTok por ela: Gift, Like, Follow, Share, Comment, Join.

Como tudo se encaixa

  1. Você abre o BakoshApp.
  2. Você abre o TikFinity.
  3. Dentro do TikFinity você cria um Trigger.
  4. A Action do Trigger é configurada como Third-party action.
  5. Quando um evento do espectador acontece, o TikFinity manda um sinal.
  6. O BakoshApp recebe o evento e roda o efeito correspondente.
Warning

O BakoshApp precisa estar rodando antes de testar os triggers. Senão, o TikFinity não tem para quem entregar.

Pré-requisitos

Garanta que você tem:

  • BakoshApp instalado e logado (veja Instalação)
  • TikFinity instalado e conectado à sua live (status: Connected)
  • Uma live do TikTok ativa
  • O jogo alvo rodando (se a ação precisar de um jogo rodando)
  • Nenhum firewall bloqueando os dois apps
  • Uma conexão de internet estável

Bom hábito reiniciar os dois apps antes da primeira passada de configuração.

Passo 1 — Crie um Trigger no TikFinity

  1. Abra o TikFinity.
  2. Vá em Triggers.
  3. Clique em Add Trigger.

Passo 2 — Escolha o evento

Escolha o tipo de evento do TikTok:

  • Gift
  • Like
  • Follow
  • Share
  • Comment
  • Join

Exemplo: Gift se quer reagir ao presente de um espectador.

Passo 3 — Defina as condições

Você pode restringir o trigger por:

  • Gift específico (ex.: Rose ou Galaxy)
  • Contagem mínima
  • Valor mínimo
  • Qualquer gift
  • Apenas de um username específico

Se deixar as condições vazias, o trigger dispara em todo evento desse tipo.

Passo 4 — Adicione uma Action

  1. Pressione Add Action.
  2. Escolha Third-party action na lista.

O painel de configurações abre.

Passo 5 — Configure a Third-party action

Escolha a categoria

O BakoshApp publica suas categorias disponíveis no TikFinity automaticamente — mas apenas para ações que têm um trigger Tikfinity atribuído dentro do BakoshApp. Ações sem trigger, ou com um trigger não-Tikfinity (Gift, Like, Chat, …), não aparecem aqui: essas são tratadas direto pelo Native Connector.

As categorias dependem do mod ativo:

  • GTA V (KOTH / Chaos / Train) — as categorias compartilhadas Vehicles, Props, GTA V Other (definidas em gtav-actions.json) ficam disponíveis nas três variantes do GTA V via empréstimo de catálogo. Cada variante adiciona ainda suas categorias próprias: KOTH e Chaos adicionam seus grupos específicos de gameplay, Train adiciona Trainmod (start/stop, troca de trilhos, controles de velocidade/vida).
  • GTA V Chaos — 7 categorias de Chaos (player, NPC, vehicle, screen, time, weather, misc).
  • Rust Survival — 16 categorias: weapons, tools, food, medical, traps, resources, animal spawns, player effects.

Escolha a ação

Dentro da categoria escolhida, escolha a ação específica — por exemplo, spawnar um veículo, teletransportar, mudar o clima, acionar um efeito de caos ou disparar um efeito temporizado.

Use o botão Test

O painel Third-party action tem um botão Test:

  • Envia um evento sintético para o BakoshApp.
  • Verifica a integração de ponta a ponta.
  • Confirma que o efeito no jogo de fato dispara.

Pressione Test logo depois de configurar. Se nada acontecer, confira se o BakoshApp está rodando e se nenhum firewall está bloqueando os apps.

Exemplo prático

Objetivo: quando um espectador enviar uma Galaxy, disparar uma explosão perto do jogador.

No TikFinity:

  • Event: Gift → Gift Name = Galaxy
  • Action: Third-party action → Category = Effects → Action = Explosion nearby

Depois:

  1. Pressione Save.
  2. Confirme que o Trigger está habilitado.
  3. Aperte Test.
  4. Verifique em uma stream ao vivo.

Checagem de sanidade

Você está configurado certo quando todos estes itens são verdadeiros:

  • Status do TikFinity = Connected to LIVE.
  • Um evento do TikTok dispara o Trigger correspondente no TikFinity.
  • O BakoshApp registra o evento de entrada no log.
  • O efeito no jogo de fato toca.

Se qualquer um dos quatro falhar, revise o passo anterior.

Erros comuns

Nada acontece

  • O BakoshApp não está rodando.
  • O trigger está desligado.
  • Gift errado selecionado.
  • Sem live ativa.

Botão Test não faz nada

  • O BakoshApp não está rodando.
  • As versões dos apps estão dessincronizadas — atualize os dois.
  • Outra ferramenta está interceptando os eventos.

O trigger dispara com frequência demais

  • Sem condições definidas.
  • Ou você escolheu Any Gift sem querer.

Dicas de estabilidade

  • Abra o BakoshApp antes de ir LIVE.
  • Não mude configurações enquanto a LIVE estiver ativa.
  • Não duplique triggers idênticos.
  • Pressione Test de vez em quando como smoke test.
  • Mantenha os dois apps atualizados.

Próximos passos