No description
- TypeScript 99%
- Dockerfile 0.7%
- JavaScript 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .forgejo/workflows | ||
| assets | ||
| mejoras | ||
| odd/tasks | ||
| openspec | ||
| openwiki | ||
| propuestas | ||
| src | ||
| test | ||
| .dockerignore | ||
| .gitignore | ||
| AGENTS.md | ||
| bun.lock | ||
| bunfig.toml | ||
| CHANGELOG.md | ||
| CHANGELOG.md.bak | ||
| CLAUDE.md | ||
| cog.toml | ||
| docker-compose.yml | ||
| Dockerfile | ||
| env.example | ||
| eslint.config.mjs | ||
| nest-cli.json | ||
| package.json | ||
| README.md | ||
| release-please-config.json | ||
| tsconfig.build.json | ||
| tsconfig.json | ||
Centaurus
Bot de Discord avanzado con temática de Metal Gear Solid, desarrollado sobre NestJS, Necord, discord.js y MongoDB.
📋 Descripción
Centaurus es un bot de Discord integral inspirado en el universo de Metal Gear Solid. Integra sistemas de progresión militar (rangos por XP de texto y voz), facciones icónicas (FOX, XOF, Diamond Dogs, MSF, etc.), economía de operaciones (GMP y Metal Gear Parts), generación de tarjetas de perfil y clasificaciones mediante Canvas, notificaciones automáticas y herramientas temáticas de administración de comunidades.
🚀 Características principales
- 🎯 Sistema de Facciones: Únete a facciones legendarias (FOX, XOF, Diamond Dogs, MSF, etc.) con roles dinámicos, seguimiento de contribución y estadísticas de facción.
- 🎖️ Rangos y Progresión (XP de Texto y Voz): Nivelación automática por mensajes en el chat y tiempo en canales de voz, con multiplicadores, límites diarios y asignación de roles.
- 💼 Economía y Recursos de Operaciones: Obtención de fondos brutos militares (GMP) y piezas (Metal Gear Parts) mediante recompensas diarias (
/daily) y misiones periódicas (/mission). - 🎨 Tarjetas Visuales Renderizadas con Canvas: Tarjetas de perfil (
/profile), bienvenida a nuevos reclutas y ranking Top 10 (/top) generadas dinámicamente con tipografías y arte de MGS. - 🦅 Comandos Temáticos de Moderación: Protocolos de moderación de staff con identidad MGS (Ban encriptado con IA Patriot
/nanomachine-ban, Mute épico con Revolver Ocelot/spin-revolver). - 📺 Notificaciones Automáticas (Social & Streaming): Monitoreo periódico de transmisiones en directo en Twitch y nuevos videos en YouTube.
- 🎮 Presencia y Actividades Rotativas: Cambio dinámico de presencia y estado del bot con mensajes contextuales de la saga Metal Gear.
- 📜 Verificación y Bienvenida: Aceptación de reglas por reacción para asignación automática del rol Recluta y bienvenida personalizada.
🛠️ Stack Tecnológico
- Framework: NestJS v11 (Arquitectura modular basada en decoradores e inyección de dependencias)
- Discord Integration: Necord v6 + discord.js v14
- Base de Datos: MongoDB vía Mongoose v8
- Renderizado Gráfico:
canvas+canvacardcon fuentes personalizadas (MGS2.ttf, Gotham) - Lenguaje & Tooling: TypeScript v5, SWC compiler (
@swc/cli), Bun (runtime de prod y CI), Jest, ESLint 9, Prettier
📦 Instalación y Puesta en Marcha
Prerrequisitos
- Bun >= 1.x (runtime de producción, tests y CI; Node.js
>= 18como fallback) — verbunfig.toml/bun.lock - MongoDB corriendo localmente o una instancia en la nube (MongoDB Atlas)
- Dependencias del sistema para compilar
canvas(Cairo, Pango, libpng, libjpeg, giflib, librsvg según tu SO)
1. Clonar el repositorio
git clone https://github.com/tu-usuario/centaurus.git
cd centaurus
2. Instalar dependencias
bun install
3. Configurar variables de entorno
Copia el archivo de plantilla env.example a .env y completa los valores requeridos:
cp env.example .env
Ejemplo de configuración básica (.env):
# Discord
DISCORD_TOKEN=tu_token_de_bot_discord
DISCORD_CLIENT_ID=tu_application_client_id
DISCORD_GUILD_ID=tu_guild_id_de_desarrollo # Opcional (para registro instantáneo en dev)
# Base de Datos
MONGODB_URI=mongodb://localhost:27017/centaurus
# Servidor HTTP & Healthcheck
PORT=3000
NODE_ENV=development
# Notificaciones (Opcional)
TWITCH_CLIENT_ID=tu_twitch_client_id
TWITCH_CLIENT_SECRET=tu_twitch_client_secret
DISCORD_TWITCH_CHANNEL_ID=canal_id_default_twitch
YOUTUBE_API_KEY=tu_youtube_api_key
4. Compilar e iniciar
# Modo Desarrollo (Watch)
bun run start:dev
# Compilación
bun run build
# Modo Producción
bun run start:prod
🕹️ Lista de Comandos Slash
🛡️ Comandos de Utilidad y Jugador
| Comando | Descripción |
|---|---|
/profile |
Muestra tu tarjeta visual de perfil (rango, XP, facción y recursos). |
/faction |
Consulta la información y estadísticas de tu facción actual. |
/join [faccion] |
Únete a una de las facciones disponibles en el servidor. |
/join-fox |
Atajo directo para alistarte en la facción FOX. |
/leave |
Abandona tu facción actual. |
/daily |
Reclama tu recompensa diaria de GMP (cooldown de 24h). |
/mission |
Completa una misión de operaciones para ganar GMP y Metal Gear Parts (cooldown de 12h). |
/resources |
Consulta tu balance actual de GMP y Metal Gear Parts. |
/voicestats [usuario] |
Muestra tus estadísticas de tiempo acumulado y sesiones en canales de voz. |
/voiceleaderboard [limite] |
Muestra la tabla de líderes por actividad en canales de voz. |
/ping |
Mide la latencia de respuesta del bot y de la API de Discord. |
📊 Comandos Sociales
| Comando | Descripción |
|---|---|
/top |
Muestra la tabla visual de clasificación (Top 10 soldados por XP). |
/youtube-canal <canal> |
Configura el canal de Discord donde se anunciarán nuevos videos de YouTube. |
/youtube-agregar <usuario> |
Agrega un canal/usuario de YouTube a la lista de monitoreo. |
/youtube-eliminar <usuario> |
Elimina un canal de YouTube de la lista de notificaciones. |
⚙️ Comandos de Administración y Staff
| Comando | Descripción |
|---|---|
/activity |
Consulta y gestiona las actividades rotativas del bot. |
/faction-setup |
Crea y sincroniza automáticamente los roles de todas las facciones en el servidor. |
/rank-setup |
Crea y configura los roles de la escala de rangos en el servidor. |
/reset-rank |
Reinicia la experiencia y rangos de los usuarios (preserva al staff). |
/rules-reset |
Republica el mensaje de reglas y verificación con reacción. |
/welcome <canal> |
Configura el canal donde se enviarán las tarjetas de bienvenida. |
/welcome-preview |
Genera una vista previa de la tarjeta gráfica de bienvenida. |
/twitch-channel [canal] |
Configura el canal para notificaciones de directos en Twitch. |
/twitch-add <usuario> |
Agrega un streamer de Twitch a la lista de monitoreo. |
/twitch-remove <usuario> |
Quita un streamer de Twitch de las notificaciones. |
/twitch-list |
Lista los streamers monitoreados y el canal de clips configurado. |
/twitch-clip <canal> |
Configura el canal dedicado para clips de Twitch. |
/voiceconfig info |
Muestra la configuración activa del sistema de voz (tasas de XP, límites). |
/nanomachine-ban <target> [reason] |
IA Patriot: Ejecuta un baneo con motivo encriptado en Base64. |
/spin-revolver <target> [duration] |
Revolver Ocelot: Aplica un timeout temporal al usuario objetivo. |
📂 Estructura del Proyecto
centaurus/
├── assets/ # Recursos estáticos (fuentes MGS2/Gotham, fondos, badges)
├── src/
│ ├── main.ts # Punto de entrada de la aplicación NestJS
│ ├── app.module.ts # Módulo raíz (configuración, Mongoose y feature modules)
│ ├── health.controller.ts # Endpoints HTTP para healthcheck (/ y /health)
│ ├── common/ # Guards de permisos y filtros de excepciones globales
│ ├── config/ # Configuraciones tipadas (facciones, rangos, voz, actividades)
│ ├── database/ # Repositorios y esquemas Mongoose (Rank, Faction, Resources, etc.)
│ ├── discord/ # Capa Necord (módulos de comandos admin/utility/social y eventos)
│ └── features/ # Módulos de lógica de negocio:
│ ├── activities/ # Rotación de presencia y actividad
│ ├── faction/ # Gestión y progresión de facciones
│ ├── leveling/ # Sistema de XP de texto y voz
│ ├── notifications/ # Notificador de directos (Twitch)
│ ├── permissions/ # Permisos y roles de staff por servidor
│ ├── resources/ # Economía de GMP y Metal Gear Parts
│ ├── social/ # Notificaciones sociales (YouTube RSS)
│ └── welcome/ # Gestión de mensajes de bienvenida
├── env.example # Plantilla de variables de entorno
├── package.json # Definición de dependencias y scripts
└── tsconfig.json # Configuración del compilador TypeScript
🧪 Testing y Calidad
# Ejecutar tests unitarios
bun test
# Ejecutar tests con cobertura
bun run test:cov
# Linter y formateo
bun run lint
bun run format
📜 Licencia y Créditos
- Autor: White Knight 17
- Inspiración: Franquicia Metal Gear Solid © Konami Digital Entertainment
- Licencia: Propietaria. Todos los derechos reservados.