Preskočiť na obsah
VORQUL
VorqulBOT / Discord bot

Jeden Discord bot namiesto piatich

VorqulBOT vznikol z praktickej frustrácie: zliepať jedného bota na moderáciu, druhého na levely, tretieho na tickety. Tento robí všetko - self-hosted, modulárny, bez paywallu na základné funkcie.

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

VorqulBOT (Vorqul DS BOT) je modulárny all-in-one Discord bot napísaný v TypeScripte na discord.js 14. Verzia 3.0 je prestavba projektu, ktorý som napísal pred rokmi a oživil: 82 slash príkazov s približne 180 podpríkazmi, 44 zapínateľných modulov v 6 skupinách, 9 jazykov. Beží na vlastnom Linux serveri či VPS alebo na Pterodactyle cez priložený egg a dáta ukladá do JSON súborov alebo MySQL/MariaDB. Voliteľný Next.js dashboard nastavuje z jedného prihlásenia všetky servery, na ktorých bot je, a Server Health Score prevádza aktivitu, retenciu a onboarding na jedno číslo. Vydania sa dajú stiahnuť z GitHubu.

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

Starý projekt, ktorý som oživil

Tento bot nie je nový. Prvú verziu som napísal pred rokmi pre svoje herné komunity a potom ho nechal ležať tak, ako to s vedľajšími projektmi býva - rozbité závislosti, dashboard, ktorý sa už nedal zostaviť, polovica príkazov ticho padala.

V roku 2026 som sa k nemu vrátil, vyhodil z neho všetko mŕtve, zvyšok prepísal do TypeScriptu na discord.js 14 a postavil nad tým poriadny Next.js dashboard. Verzia 3.0 je práve tá prestavba: 82 slash príkazov, 44 zapínateľných modulov a deväť jazykov, a všetko naozaj funguje.

02Screenshots

Ako to vyzerá

Dva screenshoty z bežiacej inštancie - úvodná stránka a jedna z konfiguračných obrazoviek.

Úvodná stránka bota: verzia, počet príkazov a modulov a vstup do dashboardu.
Úvodná stránka bota: verzia, počet príkazov a modulov a vstup do dashboardu.
Embed builder v dashboarde, vľavo zoznam modulov pre vybraný server.
Embed builder v dashboarde, vľavo zoznam modulov pre vybraný server.
03Deployment

Kde beží

Beží na vašom stroji, nie na cudzej službe. Sú na to dva spôsoby a oba sú zámerne nudné.

01

Linux server alebo VPS

Naklonujte repozitár, skopírujte .env.example na .env, doplňte token a spustite npm start. Node.js 18 alebo novší, odporúčam 22 LTS. Systemd unit sa postará o to, aby bežal ďalej.

02

Pterodactyl

Naimportujte priložený egg, nahrajte súbory cez SFTP, dajte token do Startup premenných a stlačte start. Prvý štart si sám doinštaluje závislosti a skompiluje kód. Node alebo Python launcher, podľa toho, čo egg používa.

03

Úložisko podľa vás

JSON súbory nepotrebujú žiadne nastavenie a sú predvolené, MySQL alebo MariaDB na veľký server. Mení sa jeden riadok v .env.

Stiahnite si ho a spustite

Vydania sú na GitHube. Stiahnite si najnovšie, prejdite si INSTALL.md a za nejakých desať minút máte vlastnú inštanciu. Prevádzka na vlastnej infraštruktúre je zadarmo; ďalej ho predávať ani hostovať pre iných nesmiete.

04Signature feature

Server Health Score

Väčšina botov ukazuje štatistiky. Tento hovorí, čo znamenajú. Server Health Score zhustí aktivitu, retenciu a zapojenie nových členov do jedného čísla - takže vieš, či komunita rastie, stagnuje alebo ticho krváca, skôr než to bude bolestivo zjavné.

Ako skóre funguje
84 Zdravý
Aktivita 91
Retencia 78
Zapojenie 84
Rast 76
Nízka toxicita 88

Každá zložka má vlastné skóre 0-100, vyššie je lepšie. Váhy: aktivita 25 %, retencia 25 %, zapojenie 20 %, rast 15 %, nízka toxicita 15 %.

05Modules

Čo všetko vie

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

Voliteľný dashboard

Webový dashboard s prihlásením cez Discord, kde si server vyberiete z rozbaľovacieho zoznamu a nastavíte ho. Jeden dashboard obslúži všetky servery, na ktorých bota máte - prepínate medzi nimi bez odhlasovania. Zapínate moduly, nastavujete AutoMod, kreslíte uvítacie karty so živým náhľadom, skladáte embedy, čítate analytiku a audit log, spravujete API kľúče a zálohy. Je voliteľný, všetko sa dá nastaviť aj priamo z Discordu. Rozhranie v ôsmich jazykoch.

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

Prečo práve tento

01

Všetko v jednom, self-hosted

Žiadne mesačné poplatky tretím stranám, žiadny paywall, plná kontrola nad dátami.

02

Skutočná modulárnosť

Jeden zdieľaný register modulov používa bot aj dashboard - prepínač v UI nemôže existovať bez toho, aby ho bot čítal. Všetko nepotrebné sa dá vypnúť.

03

Plugin systém

Drop-in pluginy s vlastnými príkazmi a eventami, hot-loadable, bez zásahu do jadra. Stačí manifest.json a index.js.

04

Flexibilná databáza

JSON bez setupu, MySQL/MariaDB pre veľké nasadenia.

05

Jednoduché nasadenie

Pterodactyl egg s automatickou inštaláciou pri prvom boote, klasicky cez npm na VPS, alebo Python launcher.

06

Spätná kompatibilita

Staré textové príkazy ako !daily fungujú cez prefix bridge popri slash commands.

09FAQ

Časté otázky