PROYECTO EN PRODUCCIÓN · 2025 — 2026 (ACTUALIDAD)

Nexo Bot

Bot de comunidad en TypeScript con tipado estricto y una web conectada en directo: apelaciones propias con login de Discord, panel de staff por rangos, casino multijugador, eventos en tu hora local y toda la actividad del servidor.

TypeScript Node.js 22 LTS discord.js v14 SQLite Embebido Docker Container Web nexo.davito.dev Discord OAuth2 En producción 24/7

Qué es

Nexo es un servidor de Discord (voz activa, social, gaming, anime, gatos). El bot cubre VoiceMaster, economía nexocoin, bandas y policía, asaltos cooperativos, un juego de Pokémon, perfil con reputación, misiones, RPG, counting y tickets con Neko.

La restricción a un guild no es un “todo”. Es un producto cerrado: slash commands se despliegan solo ahí (src/index.ts) y GuildCreate en otro ID llama a guild.leave().

Cómo está montado

src/index.tsboot
→
handlerscommands + events
→
modules/*motores
↔
SQLite WALschema.ts
→
dist/node 22

Un contenedor. TypeScript se compila a dist/ (Dockerfile multi-stage). Los slash viven en src/commands/ agrupados por área; la lógica gorda está en src/modules/. Los events de discord.js son finos: delegan en los motores (XP, automod, VoiceMaster, invites…).

Al apagar (SIGTERM) se reembolsan mesas de casino abiertas (economy/tables.ts) y se destruye el cliente con gracia de 25 s en Compose.

La web: nexo.davito.dev

Cloudflareproxy + TLS
→
nginxreverse proxy
→
node:httpmismo proceso que el bot
↔
SQLite + discord.jssin API intermedia

La web vive dentro del propio proceso del bot (src/web/): comparte la base de datos, el motor de economía y la sesión de Discord, así que lo que pasa en el servidor se ve al momento y lo que se hace en la web cuenta en Discord. Sin frameworks: un router propio sobre node:http y una SPA en JavaScript sin dependencias, con el mismo diseño que davito.dev (Archivo, IBM Plex Mono, tema claro y oscuro).

Todo lo que toca Discord pasa por una interfaz Bridge. En producción la implementa el cliente real; en pruebas, uno simulado (web/dev.ts) que levanta la web contra una copia de la base sin abrir otra sesión del bot.

Apelaciones propias

Sustituyen al formulario de Dyno. Login con Discord OAuth2 (el token se revoca nada más leer la identidad), así que también apelan los baneados. Hilo de mensajes con el staff y aviso en el canal de apelaciones; la decisión desbanea, quita el aislamiento o retira la advertencia en Discord.

Panel de staff por rangos

Vigilancia, moderación, administración y owner ven cosas distintas, con las mismas reglas que /mod: expedientes, apelaciones, tickets con transcripciones aisladas en sandbox, economía e interruptor del casino. Las sanciones se siguen poniendo desde Discord.

Baneos externos

Detecta los baneos hechos fuera del bot (a mano o con otros bots) y recupera quién los hizo: del registro de auditoría de Discord, del propio motivo (formato de Dyno o «Baneado por») o de los eventos GuildBanAdd en directo.

Casino multijugador

Cohete compartido inspirado en el globo: arranca en ×0,25, si explota antes de ×1 devuelve lo acumulado y el punto de explosión no sale del servidor hasta que ocurre. Además Minas, Plinko, Dados y Slots con tiradas automáticas. RNG con crypto.randomInt y retorno verificado del 90 % en los exclusivos.

Eventos en tu hora

Lee los eventos programados de Discord con su regla de repetición, calcula las próximas fechas manteniendo la hora de España aunque cambie el horario y cada visitante las ve en su zona horaria, con cuenta atrás y exportación .ics.

El servidor por dentro

Equipo, tickets, voz, bumps, contador, encuestas, sorteos, cumpleaños, parejas, starboard, bandas, trono, Pokémon y bolsa con datos reales; perfil con Pokédex, misiones, pase y logros; 12 rankings.

Seguridad: sesiones con token aleatorio guardado como hash, cookies HttpOnly/SameSite, cabecera anti-CSRF obligatoria, CSP estricta con nonce (compatible con el script de Cloudflare), límites por IP y por usuario y validación de cada campo en el servidor. El resultado de cada ronda del casino se decide en el servidor; el navegador solo lo anima.

Módulos

Web (nexo.davito.dev)

Apelaciones, panel de staff, casino, eventos y estadísticas del servidor. Detalle en la sección Web.

Moderación

moderation/actions.ts casos warn/kick/ban/timeout/softban con permisos por rango (vigilante, moderador, administración). El MD de baneo enlaza a las apelaciones de la web. Masivos hasta 15 objetivos.

AutoMod

Spam por ventana, invites, enlaces, caps, bad words. Hits en tabla automod_hits.

VoiceMaster

Hub ➕ crear sala. Panel: lock, hide, rename, límite, claim, transfer, kick. Tabla temp_voices.

Niveles

XP de voz y actividad para el pase de temporada y los rankings. El nivel general del servidor lo lleva otro bot, así que ese módulo está apagado.

Tickets

Categorías, claim, cierre, transcripciones HTML. Neko responde hasta que staff reclama el ticket.

Backup

ZIP con roles, canales, emojis, bans, casos, niveles, tickets y mensajes. Restore con mapeo de IDs.

Economía

nexocoin: work/daily/crime, tienda, P2P, subastas, trading, minería, propiedades, préstamos, impuestos semanales. Cada movimiento se registra (transactionLogger.ts).

Asaltos y bandas

/asalto cooperativo: roles, objetivos, QTE, HUD Canvas, reliquias y eventos. /banda crea sindicatos, territorios y tributo. /policia es el otro lado.

Pokémon

/pokemon captura, equipo, Pokédex, gimnasios, duelos, intercambio y evolución. Sustituye a las mascotas sueltas.

Perfil y comunidad

/perfil con tarjeta y tema. /rep da reputación. Siguen cumpleaños, matrimonios, counting, bumps e invites.

Logs

/logs asigna canales. Deletes, edits, voz, audit log, tickets y boosts van a cada tipo.

Welcome / boosts

Tarjetas Canvas (welcome, level-up, boost). Tracker de Server Boosts para sorteos ponderados.

Giveaways

Requisitos de rol, nivel o booster. Entradas extra por boosts e invites.

IA de soporte (Neko)

modules/ai/client.ts arma una cola de intentos y se queda con el primero que responde. Si un proveedor da 429, lo enfría (cooldown) y sigue. Orden:

Groq → Gemini (varias claves) → OpenRouter → Cohere → Cloudflare Workers AI → OpenAI. Admite además un modelo local compatible con OpenAI (Ollama) en cabeza de la cola si se configura.

La memoria del ticket (ai/memory.ts) guarda un resumen y hechos en SQLite para no reenviar todo el hilo. El prompt de normas se carga con /ticket ia prompt:.

Sitios del código que importan

Eventos delgados, motores gordos. messageCreate.ts no es un switch de mil líneas: llama a automod, XP, counting, bump y chatbot. Eso se deja testear y no se mezcla con los slash.

Schema explícito. database/schema.ts declara decenas de tablas (casos, tickets, economía, RPG, pets, misiones, counting…). WAL y foreign keys. No es un JSON suelto.

Canvas de marca. Welcome, level-up y boost usan las PNG de assets/images/ y fuentes Inter. El logo de esta ficha es media/nexo.png.

Operación

Un compose: docker compose up -d --build. Datos en ./data, backups en ./backups. Token, claves de IA y el secreto OAuth de la web en .env (Zod al cargar). La web escucha solo en 127.0.0.1:8097 y nginx la publica tras Cloudflare. Un script de despliegue hace copia de la base, guarda un punto de retorno, reconstruye y solo recarga nginx si la configuración valida. npm run smoke crea el esquema desde cero y carga los 89 comandos sin conectar a Discord.