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
- Você abre o BakoshApp.
- Você abre o TikFinity.
- Dentro do TikFinity você cria um Trigger.
- A Action do Trigger é configurada como Third-party action.
- Quando um evento do espectador acontece, o TikFinity manda um sinal.
- O BakoshApp recebe o evento e roda o efeito correspondente.
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
- Abra o TikFinity.
- Vá em Triggers.
- 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
- Pressione Add Action.
- 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:
- Pressione Save.
- Confirme que o Trigger está habilitado.
- Aperte Test.
- 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
- Veja Triggers para o catálogo completo de tipos de trigger dentro do BakoshApp.
- No PRO? Compare com o Native Connector — sem TikFinity.
- Se algo der errado, confira Erros gerais e Lendo os logs.