Este projeto entrega um bot Discord completo que busca jogadores de Minecraft por nome ou UUID e informa em quais servidores cristãos configurados eles estão online.
- 🔎 Pesquisa por nome ou UUID do Minecraft.
- 📋 Lista servidores cristãos configurados.
- ⚡ Consulta rápida usando a API pública do
mcsrvstat.us. - 🔐 Configuração simples via arquivo
config.json. - 🧵 Controle de concorrência para evitar bloqueios em muitas consultas.
- Python 3.10+
- Token de bot Discord (portal de desenvolvedores da Discord)
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt- Copie o arquivo de exemplo:
cp config.example.json config.json- Preencha o
config.jsoncom:
- Seu token do bot Discord.
- Lista de servidores cristãos que deseja monitorar.
Exemplo:
{
"discord_token": "COLE_SEU_TOKEN_AQUI",
"request_timeout_seconds": 10,
"max_concurrency": 8,
"servers": [
{
"name": "Servidor Cristão Exemplo",
"address": "play.exemplo.com"
}
]
}python src/bot.py/procurar jogador:<nome_ou_uuid>→ Procura o jogador nos servidores cristãos configurados./servidores→ Lista os servidores configurados.
- A busca por jogadores depende do status público do servidor. Alguns servidores podem ocultar listas de jogadores.
- Não existe API oficial que revele em qual servidor um jogador está; o bot varre apenas os servidores configurados.
- Caso o servidor esteja offline ou bloqueie listas de jogadores, ele será ignorado na resposta.
Este projeto é open-source. Use, modifique e compartilhe à vontade.