Один Discord-бот вместо пяти
VorqulBOT родился из практического раздражения: склеивать одного бота для модерации, второго для уровней, третьего для тикетов. Этот делает всё - self-hosted, модульный, без пейволла на базовые функции.
- Discord bot
- TypeScript
- discord.js 14
- Self-hosted
- 9 languages
VorqulBOT (Vorqul DS BOT) - модульный универсальный Discord-бот на TypeScript и discord.js 14. Версия 3.0 - это перестройка проекта, который я написал много лет назад и вернул к жизни: 82 слэш-команда с примерно 180 подкомандами, 44 переключаемых модуля в 6 группах, 9 языков. Он работает на вашем Linux-сервере или VPS либо на Pterodactyl с приложенным egg, а данные хранит в JSON-файлах или MySQL/MariaDB. Необязательный дашборд на Next.js настраивает все серверы с ботом из одного входа, а Server Health Score сводит активность, удержание и онбординг к одному числу. Релизы можно скачать с 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
Старый проект, который я вернул к жизни
Этот бот не новый. Первую версию я написал много лет назад для своих игровых сообществ, а потом забросил, как это обычно бывает с побочными проектами: сломанные зависимости, дашборд, который больше не собирался, половина команд молча падала.
В 2026 году я к нему вернулся, выбросил всё мёртвое, остальное переписал на TypeScript и discord.js 14 и построил сверху нормальный дашборд на Next.js. Версия 3.0 - это и есть та перестройка: 82 слэш-команда, 44 переключаемых модуля и восемь языков, и всё это действительно работает.
Как это выглядит
Два скриншота с работающей копии - стартовая страница и один из экранов настройки.
Где он работает
Он работает на вашей машине, а не на чужом сервисе. Способа два, и оба намеренно скучные.
Linux-сервер или VPS
Клонируйте репозиторий, скопируйте .env.example в .env, впишите токен и запустите npm start. Node.js 18 или новее, рекомендую 22 LTS. Юнит systemd не даст ему упасть насовсем.
Pterodactyl
Импортируйте приложенный egg, загрузите файлы по SFTP, укажите токен в переменных Startup и нажмите start. Первый запуск сам ставит зависимости и компилирует код. Лаунчер Node или Python - смотря какой egg.
Хранилище на выбор
JSON-файлы не требуют настройки и используются по умолчанию, MySQL или MariaDB для большого сервера. Меняется одна строка в .env.
Скачайте и запустите
Релизы лежат на GitHub. Возьмите последний, пройдите по INSTALL.md - и минут через десять у вас своя копия. Запуск на своей инфраструктуре бесплатен; перепродавать и хостить для других нельзя.
Server Health Score
Большинство ботов показывают статистику. Этот говорит, что она значит. Server Health Score сжимает активность, удержание и отток участников в одно число - вы узнаете, растёт ли сообщество, стоит на месте или тихо истекает, раньше, чем это станет болезненно очевидно.
Как считается оценкаУ каждой составляющей своя оценка 0-100, больше - лучше. Веса: активность 25 %, удержание 25 %, вовлечённость 20 %, рост 15 %, низкая токсичность 15 %.
Что он умеет
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.
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.
Опциональный дашборд
Веб-дашборд со входом через Discord: сервер выбирается из списка и там же настраивается. Один дашборд обслуживает все серверы, где стоит бот, - переключение без повторного входа. Включаете модули, настраиваете AutoMod, рисуете приветственные карточки с живым предпросмотром, собираете эмбеды, смотрите аналитику и журнал аудита, управляете API-ключами и резервными копиями. Он необязателен: всё настраивается и прямо из Discord. Интерфейс на девяти языках.
- Discord OAuth2 login
- Server selector
- Module management
- AutoMod configuration
- Welcome card builder
- Embed builder
- Analytics
- Audit log
- API keys
- Backups
Почему именно он
Всё в одном, self-hosted
Никаких месячных платежей третьим сторонам, никакого пейволла, полный контроль над данными.
Настоящая модульность
Один общий реестр модулей используют и бот, и дашборд - переключатель в UI не может существовать без того, чтобы бот его читал. Всё лишнее отключается.
Система плагинов
Drop-in плагины со своими командами и событиями, hot-loadable, без изменений ядра. Достаточно manifest.json и index.js.
Гибкая база данных
JSON без настройки или MySQL/MariaDB для больших развёртываний.
Простое развёртывание
Pterodactyl egg с автоустановкой при первом запуске, классически через npm на VPS или Python-лаунчер.
Обратная совместимость
Старые текстовые команды вроде !daily работают через prefix bridge рядом со slash-командами.