Skip to content
VORQUL
VorqulBOT / Discord bot

One Discord bot instead of five

I got tired of gluing together one bot for moderation, another for levels and a third for tickets. VorqulBOT does all of it, runs on your own hardware, stays modular and keeps the basics free.

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

VorqulBOT (Vorqul DS BOT) is a modular all-in-one Discord bot written in TypeScript on discord.js 14. Version 3.0 is a rebuild of a project I wrote years ago and brought back: 83 slash commands with roughly 180 subcommands, 44 toggleable modules in 6 groups, 9 languages. It runs on your own Linux server or VPS, or on Pterodactyl with the included egg, and stores data in JSON files or MySQL/MariaDB. An optional Next.js dashboard configures every server the bot is on from a single login, and the Server Health Score turns activity, retention and onboarding into one number. Releases are downloadable from 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
83 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
01Screenshots

What it looks like

Two screenshots from a live instance: the landing page and one of the configuration screens.

The bot landing page: version, command and module count, and the way into the dashboard.
The bot landing page: version, command and module count, and the way into the dashboard.
The embed builder in the dashboard, with the module list for the selected server down the left side.
The embed builder in the dashboard, with the module list for the selected server down the left side.
02Background

An old project, brought back

This bot is old. I wrote the first version years ago for my own gaming communities, then let it rot the way side projects do: broken dependencies, a dashboard that no longer built, half the commands failing silently.

In 2026 I went back, tore out what was dead, rewrote the rest in TypeScript on discord.js 14, and put a proper Next.js dashboard on top. Version 3.0 is that rebuild: 83 slash commands, 44 toggleable modules and nine languages, all of it working.

03Signature feature

Server Health Score

Most bots show you statistics and stop there. The Server Health Score condenses activity, retention and newcomer onboarding into one number, so you can tell whether your community is growing, flatlining or quietly bleeding out before it becomes obvious the hard way.

How the score works
84 Healthy
Activity 91
Retention 78
Engagement 84
Growth 76
Low toxicity 88

Each component has its own 0-100 score, higher is better. Weights: activity 25%, retention 25%, engagement 20%, growth 15%, low toxicity 15%.

04Modules

What it does

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.

05In 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 and 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.

06Dashboard

Optional dashboard

The web dashboard signs you in with Discord, and you pick a server from a dropdown to configure it. One dashboard handles every server the bot is on, and you switch between them without logging out. Toggle modules, set up AutoMod, design welcome cards with a live preview, build embeds, read analytics and the audit log, manage API keys and backups. All of it is optional, because everything can also be done from Discord. The interface comes in nine languages.

  • Optional password gate
  • Discord OAuth2 login
  • Server selector
  • Bot status with ping, uptime, memory and CPU
  • Module management
  • AutoMod configuration
  • Welcome card builder
  • Embed builder
  • Feeds, Socials and Reminders
  • Analytics
  • Audit log
  • API keys
  • Plugins and Premium
  • Backups
07Deployment

Where it runs

It runs on your machine instead of somebody else's service. There are two ways to set that up, and both are boring on purpose.

01

Linux server or VPS

Clone it, copy .env.example to .env, fill in the token, run npm start. Node.js 18 or newer, 22 LTS recommended. A systemd unit keeps it up.

02

Pterodactyl

Import the included egg, upload the files over SFTP, put your token in the Startup variables and press start. The first boot installs dependencies and compiles on its own. Node or Python launcher, whichever your egg uses.

03

Your choice of storage

JSON files need no setup and are the default. Use MySQL or MariaDB for a big server. Switching is one line in .env.

Download and run it

Releases are published on GitHub. Grab the latest, follow INSTALL.md, and you have your own instance running in about ten minutes. It is free to run on your own infrastructure, and you may not resell it or host it for other people.

08Rationale

Why this one

01

All-in-one, self-hosted

No monthly fees to third parties, no paywall, full control over your data.

02

Truly modular

One shared module registry drives both bot and dashboard, so a toggle in the UI cannot exist without the bot honoring it. Turn off anything your server does not need.

03

Plugin system

Drop-in plugins with their own commands and events, hot-loadable, no core changes. A manifest.json and an index.js is all it takes.

04

Flexible storage

JSON for zero setup, MySQL/MariaDB for large deployments.

05

Easy deployment

Pterodactyl egg with auto-install on first boot, classic npm on a VPS, or the Python launcher.

06

Backwards compatible

Old text commands like !daily still work through the prefix bridge, alongside slash commands.

09FAQ

Frequently asked questions