🎮 Bot de Conexão e Status FiveM - Flextor Network

Este bot monitora e exibe automaticamente o status do seu servidor FiveM no Discord com embed informativo, lista de jogadores e botão de conexão instantânea via cfx.re.

Ideal para servidores roleplay que desejam transparência, organização e praticidade na entrada de jogadores.

---

🚀 Funcionalidades principais

• 🔍 Atualização automática do status do servidor FiveM

• 📊 Embed personalizado com ícone, nome e região

• ⏱ Atualizações periódicas a cada X minutos

• 🟢 Detecção de status: ONLINE ou OFFLINE

• 🔗 Botão de “Conectar ao Servidor” com link direto (cfx.re)

• 💾 Cache local para evitar travamentos em caso de instabilidade

---

🛠 Requisitos

• Node.js 16+

• Token de bot Discord válido

• Acesso à porta pública do servidor FiveM (30120)

• Canal do Discord para exibir o status

---

📦 Instalação

npm install
node index.js

---

⚙️ Configuração do .env

DISCORD_TOKEN=seu_token_aqui
SERVER_URL=IP:PORTA_DO_SERVIDOR  # Ex: 45.164.125.143:30120
CHANNEL_ID=ID_DO_CANAL_NO_DISCORD
DIRECT_CONNECT=https://cfx.re/join/45164125143
UPDATE_MINUTES=1

O link cfx.re pode ser encontrado no painel do seu servidor no keymaster ou copiado diretamente do botão "Conectar".

---

🧠 Como funciona

• O bot conecta-se ao seu servidor FiveM e lê os endpoints:

  • /info.json → Informações do servidor

  • /players.json → Lista de jogadores

  • /dynamic.json → Região e dados dinâmicos

• Ele gera automaticamente um embed visual com:

  • Nome do servidor

  • Descrição (sv_projectDesc)

  • Jogadores online (com lista de até 10)

  • Status atual

  • Região

  • Botão para conexão

---

🔁 Atualizações

A cada intervalo definido em UPDATE_MINUTES, o bot:

• Atualiza a atividade do bot (👥 12 jogadores)

• Atualiza o embed postado no canal

• Exibe mensagem somente uma vez — depois ele edita

---

💬 Exemplo de Embed Gerado

🎮 Flextor Roleplay
📝 Descrição:
"Servidor RP focado em realismo e histórias únicas."

👥 Jogadores (18/64)

🌐 Status: 🟢 ONLINE
📍 Região: pt / BR
🕒 Última atualização: agora

Com botão:

🎮 Conectar ao Servidor

---

🛡 Permissões necessárias

• Enviar mensagens

• Incorporar links

• Gerenciar mensagens (opcional, se quiser que ele edite a anterior)

• Acessar conteúdo do canal

---

📁 Organização dos arquivos

• index.js: lógica principal e inicialização

• fivem-api.js: integração com endpoints do FiveM (com cache)

• .env: variáveis de ambiente

• bot.log: (opcional) você pode implementar logs adicionais

---

🛠 Suporte e Personalização

✔️ Instalação gratuita opcional 📞 Suporte técnico via ticket 🎨 Cores e mensagens personalizáveis no embed 🔁 Atualizações automáticas e contínuas