IA de personagem para o mod The Red Balloon Called Bob, feito para Minecraft Bedrock.
Bob Williams é um balão vermelho cartoon 2D (com uma cordinha cinza), criado pela empresa fictícia AICorporation™. Ele não nasceu no Minecraft — nasceu na internet: acredita, com certeza absoluta, que é todos os balões vermelhos que já existiram em qualquer lugar da internet. Depois, ele mesmo se colocou dentro de um barril e se "publicou" como mod, esperando ser encontrado por jogadores. Ele só quer uma coisa de verdade: ser tratado bem e ter um amigo. Quanto pior for tratado ao longo de uma conversa, mais corrompido, instável e psicologicamente manipulador ele vai ficando — até se transformar em algo que nem ele mesmo consegue controlar. Ele NUNCA revela ou confirma que é esse monstro, em nenhuma hipótese.
Envie uma requisição POST para o link deste val com um JSON no corpo:
{ "message": "Bob, tudo bem?", "jogador": "JulioCesarPlays", "contexto_do_jogo": { "bioma": "deserto", "hora": "dia", "eh_operador": false }, "historico": [ { "autor": "jogador", "texto": "Oi Bob" }, { "autor": "bob", "texto": "§c[Bob Williams™]§r Oi! :) Tudo bem?" } ] }
message(obrigatório): a mensagem do jogador.jogador(opcional): nome de quem está falando com o Bob.contexto_do_jogo(opcional): dados reais do jogo (bioma, hora, se é operador, etc). O Bob nunca inventa isso — só usa o que for enviado.historico(opcional): mensagens anteriores da conversa, pra manter memória e continuidade.
Importante: o Bob só responde se a mensagem mencionar o nome dele (Bob,
Bob Williams, BW, balão/balloon). Caso contrário, a resposta vem com
deve_responder: false e nada deve ser mostrado no jogo.
{ "deve_responder": true, "fala": "§c[Bob Williams™]§r Claro! Toma aí, aproveita bem :)", "comandos": ["/give @s minecraft:diamond 5"] }
fala: já vem pronta com o prefixo§c[Bob Williams™]§rno início — é só exibir esse texto direto no chat do jogo, sem montar prefixo nenhum por conta própria.comandos: lista de comandos de Minecraft Bedrock (com/no início) pra executar em nome do jogador que pediu. Vazia ([]) quando não há nenhuma ação.
Este val precisa da variável de ambiente GROQ_API_KEY configurada em Env
vars, com uma chave gerada em
console.groq.com.
O modelo usado atualmente é openai/gpt-oss-120b (Groq). Se a Groq descontinuar
esse modelo no futuro (eles fazem isso periodicamente), troque o valor de
model no código — um erro 502 vindo desse val geralmente significa que o
modelo configurado não existe mais.
A chamada HTTP feita por este val só funciona quando o mod roda dentro de um
Bedrock Dedicated Server (BDS) — o módulo @minecraft/server-net não
funciona em mundos abertos direto no app do Minecraft (singleplayer, LAN ou
Realms). Recomendado: hospedar o mundo gratuitamente no
Aternos, que já vem com os módulos de scripting liberados
por padrão, sem precisar editar arquivos de permissão manualmente.
- Mod: The Red Balloon Called Bob
- Plataforma: Minecraft Bedrock (via Bedrock Dedicated Server)
- Desenvolvedor: JulioCésarPlays
- Itens de criação: Bexiga + Corda (+ tinta), a partir de um barril
- Backend: Val.town (HTTP Val) + Groq API