Saltar al contenido
VORQUL
VorqulBOT / bot de Discord

Un bot de Discord en lugar de cinco

VorqulBOT nació de una frustración práctica: pegar un bot para moderación, otro para niveles, un tercero para tickets. Este lo hace todo - self-hosted, modular, sin paywall en lo básico.

  • Discord bot
  • TypeScript
  • discord.js 14
  • Self-hosted
  • 9 languages

VorqulBOT (Vorqul DS BOT) es un bot de Discord modular y todo en uno escrito en TypeScript sobre discord.js 14. La versión 3.0 es la reconstrucción de un proyecto que escribí hace años y recuperé: 82 comandos de barra con unos 180 subcomandos, 44 módulos activables en 6 grupos, 9 idiomas. Se ejecuta en tu propio servidor Linux o VPS, o en Pterodactyl con el egg incluido, y guarda los datos en archivos JSON o en MySQL/MariaDB. Un panel opcional en Next.js configura desde un solo inicio de sesión todos los servidores donde esté el bot, y el Server Health Score convierte actividad, retención y bienvenida en un único número. Las versiones se descargan desde GitHub.

Type
Discord bot
Version
3.0
Language
TypeScript
Library
discord.js 14
Runtime
Node.js 18+, 22 LTS recommended
Deployment
Linux server, VPS or Pterodactyl
Commands
82 slash commands
Modules
44 toggleable
Interface languages
9
Launchers
Node, Python, Pterodactyl egg
Dashboard
Next.js, multi-server, optional
Storage
JSON files, MySQL/MariaDB
Price
Free
01Background

Un proyecto viejo, recuperado

Este bot no es nuevo. Escribí la primera versión hace años para mis propias comunidades de juego y luego lo dejé pudrirse como suele pasar con los proyectos paralelos: dependencias rotas, un panel que ya no compilaba, la mitad de los comandos fallando en silencio.

En 2026 volví a él, saqué todo lo muerto, reescribí el resto en TypeScript sobre discord.js 14 y le puse encima un panel en Next.js como es debido. La versión 3.0 es esa reconstrucción: 82 comandos de barra, 44 módulos activables y nueve idiomas, y todo funciona de verdad.

02Screenshots

Qué aspecto tiene

Dos capturas de una instancia en funcionamiento: la página de inicio y una de las pantallas de configuración.

Página de inicio del bot: versión, número de comandos y módulos, y la entrada al panel.
Página de inicio del bot: versión, número de comandos y módulos, y la entrada al panel.
El constructor de embeds en el panel, con la lista de módulos del servidor seleccionado a la izquierda.
El constructor de embeds en el panel, con la lista de módulos del servidor seleccionado a la izquierda.
03Deployment

Dónde se ejecuta

Se ejecuta en tu máquina, no en el servicio de otro. Hay dos formas de hacerlo y las dos son aburridas a propósito.

01

Servidor Linux o VPS

Clona el repositorio, copia .env.example a .env, pon el token y ejecuta npm start. Node.js 18 o superior, mejor 22 LTS. Una unidad de systemd se encarga de mantenerlo vivo.

02

Pterodactyl

Importa el egg incluido, sube los archivos por SFTP, pon tu token en las variables de Startup y pulsa start. El primer arranque instala dependencias y compila solo. Lanzador Node o Python, según el egg.

03

El almacenamiento que prefieras

Los archivos JSON no necesitan configuración y son la opción por defecto; MySQL o MariaDB para un servidor grande. Se cambia una línea en .env.

Descárgalo y ejecútalo

Las versiones se publican en GitHub. Coge la última, sigue INSTALL.md y en unos diez minutos tienes tu propia instancia. Ejecutarlo en tu infraestructura es gratis; no puedes revenderlo ni alojarlo para terceros.

04Signature feature

Server Health Score

La mayoría de los bots muestran estadísticas. Este te dice qué significan. El Server Health Score condensa actividad, retención y bajas de miembros en un solo número - sabrás si tu comunidad crece, se estanca o se desangra en silencio, antes de que sea dolorosamente obvio.

Cómo funciona la puntuación
84 Saludable
Actividad 91
Retención 78
Participación 84
Crecimiento 76
Baja toxicidad 88

Cada componente tiene su propia puntuación de 0 a 100 y más alto es mejor. Pesos: actividad 25%, retención 25%, participación 20%, crecimiento 15%, baja toxicidad 15%.

05Modules

Qué puede hacer

Grouped by what they do, not by a marketing count. Open a category to see the modules inside it.

Reference

Every module name above is the key the bot and the dashboard both read. The terms behind them are defined once in the glossary, and the questions about price, requirements and limits are answered on a single page.

06In depth

Written up properly, one topic at a time

VorqulBOT

Moderation

VorqulBOT moderation: 33 commands covering ban, kick, warn, timeout, jail, shadow-mute, voice mute and timed roles, with numbered case history, warning escalation, an altcheck heuristic, appeals and full logging. Self-hosted, TypeScript.

VorqulBOT

AutoMod

VorqulBOT AutoMod runs 15 filters: spam, links, invites, caps, mentions, repeats, emoji, spoilers, zalgo, phishing, fake nitro, crypto scams, ghost pings, mass mentions and custom regex, with role and channel exemptions and an escalation ladder.

VorqulBOT

Anti-Raid

VorqulBOT counts joins per interval and reacts with a lockdown, kick or ban, gates accounts under a minimum age, and limits how many channels, roles, bans, kicks or webhooks any account can touch in a window.

VorqulBOT

Server Health Score

The VorqulBOT Server Health Score weighs activity, retention, engagement, growth and toxicity from the last seven days into a single 0-100 number, so community managers can see whether a Discord server is growing or quietly declining.

VorqulBOT

Tickets

VorqulBOT ticket system: a panel with a button that opens a private channel, claim, reopen and close controls, plain-text transcripts posted to a channel you choose, and a separate application flow with accept and deny commands. Self-hosted, no external service.

VorqulBOT

Leveling

VorqulBOT leveling: random XP per message with a cooldown, optional voice XP per minute, a server-wide multiplier, no-XP channels and roles, reward roles that stack or replace, and /rank and /leaderboard. Self-hosted with your own data.

VorqulBOT

Economy

VorqulBOT economy: a server currency with wallet and bank, daily streaks, work, pay, a shop, a player marketplace, casino games with bet limits, lootboxes, spins, robbery and group heists - all under /economy, all configurable.

VorqulBOT

Plugins

VorqulBOT plugins are drop-in folders with a manifest.json and a JavaScript entry point that default-exports a plugin object. They bring their own slash commands and events and need no changes to the bot core.

07Dashboard

Dashboard opcional

Un panel web con inicio de sesión de Discord donde eliges el servidor en un desplegable y lo configuras. Un único panel gestiona todos los servidores en los que tengas el bot: cambias entre ellos sin cerrar sesión. Activas módulos, configuras AutoMod, diseñas tarjetas de bienvenida con vista previa en vivo, montas embeds, consultas analíticas y el registro de auditoría, gestionas claves de API y copias de seguridad. Es opcional: todo se puede configurar también desde Discord. Interfaz en nueve idiomas.

  • Discord OAuth2 login
  • Server selector
  • Module management
  • AutoMod configuration
  • Welcome card builder
  • Embed builder
  • Analytics
  • Audit log
  • API keys
  • Backups
08Rationale

Por qué este

01

Todo en uno, self-hosted

Sin cuotas mensuales a terceros, sin paywall, control total de tus datos.

02

Modularidad real

Un único registro de módulos compartido alimenta bot y dashboard - un interruptor en la UI no puede existir sin que el bot lo lea. Apaga todo lo que tu servidor no necesite.

03

Sistema de plugins

Plugins drop-in con sus propios comandos y eventos, hot-loadable, sin tocar el núcleo. Basta un manifest.json y un index.js.

04

Base de datos flexible

JSON sin configuración, o MySQL/MariaDB para despliegues grandes.

05

Despliegue sencillo

Egg de Pterodactyl con instalación automática en el primer arranque, npm clásico en un VPS, o el launcher en Python.

06

Compatibilidad hacia atrás

Los comandos de texto antiguos como !daily siguen funcionando vía prefix bridge junto a los slash commands.

09FAQ

Preguntas frecuentes