Começando com Bots e Automação

Este guia ajuda você a configurar seu servidor de Bots e Automação no ServerPrism. Você aprenderá como implantar seu servidor, configurar o bot escolhido e fazê-lo funcionar em sua plataforma.

Antes de começar

Antes de fazer o pedido, identifique o bot que você deseja executar. Cada bot requer tokens específicos ou chaves de API da plataforma com a qual interage (por exemplo, Twitch, Discord, servidores de jogos). Obtenha essas chaves com antecedência.

Fazendo o pedido no ServerPrism

1. Selecione um plano: Escolha o jogo Bots & Automation na página de pedidos do ServerPrism. Recomendamos um mínimo de 2 GB de RAM para bots básicos, até 8 GB de RAM para configurações mais complexas ou múltiplas instâncias.
2. Escolha uma região: Selecione a localização do data center mais próxima do seu público-alvo ou de você para um desempenho ideal.
3. Escolha seu bot: Na página de configuração do pedido, selecione o tempo de execução do bot desejado (por exemplo, PhantomBot, SogeBot, JTS3ServerMod) nas opções disponíveis. Isso instala os arquivos principais para você.
4. Implantar: Conclua seu pedido. Seu servidor começará a ser implantado automaticamente.

Primeira inicialização

Após a implantação, seu servidor será iniciado pela primeira vez. A inicialização inicial baixa quaisquer dependências restantes para o bot escolhido. Você pode monitorar o progresso na guia Console do painel ServerPrism. O servidor estará pronto quando a saída do console indicar que o bot foi iniciado com sucesso, geralmente exibindo uma mensagem como "Bot started" ou "Listening for commands."

Conectando / convidando jogadores

Os bots geralmente não têm uma "conexão" direta como um servidor de jogo. Em vez disso, eles se conectam a uma plataforma (como Twitch ou Discord) usando as credenciais que você fornece. Uma vez configurado, o bot opera dentro dessa plataforma. Para bots que gerenciam servidores de jogos (como Big Brother Bot B3 ou JTS3ServerMod), o bot se conecta à porta RCON ou de consulta do servidor de jogo.

Noções básicas de configuração

A configuração do seu bot é feita via arquivos ou variáveis de ambiente, dependendo do bot.

PhantomBot

1. Acessar arquivos: Use o File Manager do painel ServerPrism ou SFTP para navegar até o diretório phantombot do seu servidor.
2. Editar botlogin.txt: Este arquivo contém seu canal Twitch, nome de usuário do bot e token OAuth. Siga as instruções dentro do arquivo para inserir suas credenciais.
3. Editar config.ini: Ajuste as configurações gerais do bot, como prefixo de comando, idioma e configurações de módulo aqui.
4. Reiniciar: Após salvar as alterações, reinicie seu servidor na guia Console ou Power do painel ServerPrism para que elas entrem em vigor.

SogeBot

O SogeBot usa principalmente variáveis de ambiente para a configuração inicial.

1. Variáveis de Inicialização: Vá para a guia Startup no seu painel ServerPrism.
2. Definir TWITCH_USERNAME e TWITCH_OAUTH: Insira seu nome de usuário do bot Twitch e token OAuth aqui. Você também pode precisar definir CHANNEL para o canal Twitch de destino.
3. Outras configurações: Consulte a documentação do SogeBot para outras variáveis de ambiente disponíveis para configuração avançada.
4. Reiniciar: Reinicie seu servidor no painel ServerPrism para que as alterações sejam aplicadas.

JTS3ServerMod

1. Acessar arquivos: Use o File Manager do painel ServerPrism ou SFTP.
2. Navegar: Vá para config/server1/.
3. Editar JTS3ServerMod_server.cfg: Este é o arquivo de configuração principal. Edite configurações como o endereço de consulta do seu servidor TeamSpeak 3, porta, nome de usuário, senha e configurações específicas do módulo.
4. Salvar e Reiniciar: Salve o arquivo e reinicie seu servidor no painel ServerPrism.

Big Brother Bot (B3)

1. Acessar arquivos: Use o File Manager do painel ServerPrism ou SFTP.
2. Navegar: Vá para b3/conf/.
3. Editar b3.xml: Este é o arquivo de configuração principal. Você precisará configurar sua conexão de banco de dados (SQLite é frequentemente o padrão e suficiente), detalhes do servidor de jogo (IP, porta, senha RCON) e configurações administrativas.
4. Editar plugins.xml: Ative ou desative plugins B3 específicos aqui.
5. Salvar e Reiniciar: Salve todas as alterações e reinicie seu servidor no painel ServerPrism.

Problemas comuns

• Bot não conecta à plataforma: Verifique novamente suas chaves de API, tokens OAuth e nomes de usuário para erros de digitação. Certifique-se de que eles tenham as permissões corretas na plataforma (por exemplo, status de moderador para bots Twitch).
• Bot não inicia: Verifique a guia Console para mensagens de erro. Dependências ausentes, caminhos de arquivo incorretos ou sintaxe de configuração inválida são culpados comuns. Se você fez alterações nos arquivos de configuração, reverta-os um por um para isolar o problema.
• Comandos não funcionam: Verifique se o bot está conectado com sucesso e se o prefixo do comando está correto. Para bots de servidor de jogo, certifique-se de que a senha RCON e o IP do servidor de jogo estejam configurados corretamente nas configurações do bot.
• Alto uso de recursos: Se o seu bot estiver consumindo muita RAM ou CPU, revise sua configuração. Alguns módulos ou recursos podem ser intensivos em recursos. Considere atualizar seu plano ServerPrism através do painor do cliente, se necessário.

Próximos passos

Uma vez que seu bot esteja funcionando, explore suas capacidades completas:

• Gerenciamento de Módulos/Plugins: A maioria dos bots permite que você ative, desative ou configure módulos ou plugins adicionais para funcionalidade estendida.
• Comandos personalizados: Aprenda como adicionar comandos personalizados específicos para sua comunidade ou servidor de jogo.
• Troca de tempo de execução: Se você quiser experimentar um bot diferente, você pode trocar o tempo de execução do seu servidor diretamente na guia Startup do seu painel ServerPrism sem precisar reordenar seu servidor.
• Suporte da comunidade: Muitos bots têm comunidades ativas ou documentação que você pode consultar para configurações avançadas. Se você encontrar problemas persistentes, abra um ticket de suporte em https://serverprism.com/tickets, fornecendo seu ID de servidor e quaisquer logs de console relevantes.