Bot de Discord para Servidor de Minecraft
Este proyecto es un bot de Discord diseñado para comunidades de Minecraft. Permite mostrar información útil, reglas, IPs, enlaces y soporte a los usuarios mediante comandos.
Características principales
- Comandos
/guia,/reglas,/ip,/discord,/soporte,/tienda. - Respuestas con mensajes enriquecidos (embeds) y datos configurables.
- Fácil de extender y mantener gracias a su estructura modular.
Estructura del proyecto
bot-template-mc/
├── src/
│ ├── commands/ # Comandos individuales del bot
│ ├── config/ # Configuración sensible (token, IPs, etc.)
│ └── index.js # Archivo principal del bot
├── package.json # Dependencias y scripts
├── .gitignore # Archivos a ignorar en git
├── LICENSE # Licencia del proyecto
└── README.md # Este archivoInstalación y configuración
1. Clona el repositorio
git clone https://github.com/FeliponsioDev/bot-template-mc
cd bot-template-mc2. Instala las dependencias
npm install3. Configura el bot
Copia el archivo de ejemplo de configuración y edítalo:
cp src/config/config.json src/config/config.jsonEdita src/config/config.json y coloca tu token de bot de Discord y los datos de tu servidor.
Nota: ¡No subas tu
config.jsona GitHub! Ya está en el.gitignore.
4. Inicia el bot localmente
node src/index.js¿Cómo funciona el archivo config.json?
El archivo src/config/config.json es fundamental para el funcionamiento del bot. Aquí se almacenan todos los datos sensibles y configurables, como el token del bot, las IPs de los servidores, enlaces y los IDs de canales de Discord.
Si este archivo no se cuentra creado puedes hacer una carpeta llamada config y crear el archivo config.json.
Ejemplo de config.json:
{
"token": "AQUI_TU_TOKEN_DEL_BOT",
"ip_java": "play.tuserver.com",
"ip_bedrock": "bedrock.tuserver.com",
"puerto_bedrock": 19132,
"discord_invite": "https://discord.gg/yourinvitecode",
"tienda_url": "https://store.tuserver.com",
"canal_ayuda": "ID_CANAL_AYUDA",
"canal_tickets": "ID_CANAL_TICKETS"
}Explicación de los campos:
token: El token de tu bot de Discord (¡nunca lo compartas ni subas a GitHub!).ip_java: IP de tu servidor de Minecraft Java.ip_bedrock: IP de tu servidor de Minecraft Bedrock.puerto_bedrock: Puerto de tu servidor Bedrock (por defecto 19132).discord_invite: Enlace de invitación a tu servidor de Discord.tienda_url: Enlace a la tienda de tu servidor (si tienes).canal_ayuda: ID del canal de Discord donde los usuarios pueden pedir ayuda.canal_tickets: ID del canal de Discord para crear tickets de soporte.
Este archivo permite que el bot sea fácilmente configurable y adaptable a cualquier comunidad sin necesidad de modificar el código fuente.
Despliegue en la nube
Render.com
- Crea una cuenta en Render.
- Crea un nuevo servicio de tipo "Web Service" y conecta tu repositorio.
- En "Start Command" pon:
node src/index.js - En "Environment" agrega una variable
NODE_VERSION(ej:18o la que uses). - Sube tu
config.jsonmanualmente desde el dashboard de Render (no lo subas a git). - ¡Listo! El bot se ejecutará automáticamente.
Vercel/Netlify
Importante: Vercel y Netlify están pensados para apps web (HTTP), no para bots de Discord que requieren procesos persistentes. No son recomendados para bots, pero puedes usar Railway o Render para bots.
Si aún así quieres intentarlo:
- Usa un adaptador como vercel-node-server para mantener el proceso vivo (no recomendado para producción).
- Sube tu código y configura el comando de inicio igual que en Render.
Agregar nuevos comandos
- Crea un archivo
.jsensrc/commands/siguiendo el formato de los existentes. - El bot los cargará automáticamente al iniciar.
Licencia
Este proyecto está licenciado bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.
💬 Soporte
Desarrollado con 💙 por Revers Studio