No description
  • TypeScript 99%
  • Dockerfile 0.7%
  • JavaScript 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
White Knight 26d7e939ff
All checks were successful
CI / Lint, format & unit tests (push) Successful in 20s
CI / E2E tests (push) Successful in 15s
/ release (push) Successful in 3s
CI / Build (push) Successful in 8s
docs(ci): agregar contrato del workflow de release para agentes
2026-10-17 22:36:29 -03:00
.forgejo/workflows docs(ci): agregar contrato del workflow de release para agentes 2026-10-17 22:36:29 -03:00
assets fix(canvas): render color emojis via bundled subset font 2026-10-05 15:18:21 -03:00
mejoras docs(docker): document compose testing flow and lazydocker usage 2026-10-17 21:42:38 -03:00
odd/tasks docs(canvas): note emoji fallback fix 2026-10-05 15:18:45 -03:00
openspec docs(canvas): add docker and render optimization notes 2026-10-05 12:08:01 -03:00
openwiki fix: Wikiopen 2026-10-01 16:39:29 -03:00
propuestas docs: propuesta principal 2026-10-01 16:05:37 -03:00
src fix(canvas): render color emojis via bundled subset font 2026-10-05 15:18:21 -03:00
test core: Centaurus bot 2026-09-21 16:28:40 -03:00
.dockerignore feat: Se agrego la funcionalidad de docker. Ya se puede correr por docker si el usuario lo requiere 2026-10-02 16:10:18 -03:00
.gitignore build(docker): optimize multi-stage image 2026-10-05 11:55:34 -03:00
AGENTS.md core: Centaurus bot 2026-09-21 16:28:40 -03:00
bun.lock refactor(canvas): migrate render backend to @napi-rs/canvas 2026-10-05 11:59:51 -03:00
bunfig.toml core: Centaurus bot 2026-09-21 16:28:40 -03:00
CHANGELOG.md chore(version): 1.8.2 2026-10-17 21:56:19 -03:00
CHANGELOG.md.bak chore: normalizar CHANGELOG.md para cocogitto 2026-09-22 17:49:07 -03:00
CLAUDE.md core: Centaurus bot 2026-09-21 16:28:40 -03:00
cog.toml feat: agregar release automático con cocogitto 2026-09-21 20:41:31 -03:00
docker-compose.yml chore(docker): add compose file for local bot testing 2026-10-17 21:42:38 -03:00
Dockerfile build(docker): switch runtime base to alpine 2026-10-05 12:02:36 -03:00
env.example core: Centaurus bot 2026-09-21 16:28:40 -03:00
eslint.config.mjs core: Centaurus bot 2026-09-21 16:28:40 -03:00
nest-cli.json core: Centaurus bot 2026-09-21 16:28:40 -03:00
package.json refactor(canvas): migrate render backend to @napi-rs/canvas 2026-10-05 11:59:51 -03:00
README.md core: Centaurus bot 2026-09-21 16:28:40 -03:00
release-please-config.json core: Centaurus bot 2026-09-21 16:28:40 -03:00
tsconfig.build.json core: Centaurus bot 2026-09-21 16:28:40 -03:00
tsconfig.json core: Centaurus bot 2026-09-21 16:28:40 -03:00

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 + canvacard con 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 >= 18 como fallback) — ver bunfig.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.