Jeden Discord bot místo pěti
VorqulBOT vznikl z praktické frustrace: lepit dohromady jednoho bota na moderaci, druhého na levely, třetího na tickety. Tenhle umí všechno - self-hosted, modulární, bez paywallu na základní funkce.
- Discord bot
- TypeScript
- discord.js 14
- Self-hosted
- 9 languages
VorqulBOT (Vorqul DS BOT) je modulární all-in-one Discord bot napsaný v TypeScriptu na discord.js 14. Verze 3.0 je přestavba projektu, který jsem napsal před lety a oživil: 82 slash příkazů s přibližně 180 podpříkazy, 44 zapínatelných modulů v 6 skupinách, 9 jazyků. Běží na vlastním Linux serveru či VPS nebo na Pterodactylu přes přiložený egg a data ukládá do JSON souborů nebo MySQL/MariaDB. Volitelný Next.js dashboard nastavuje z jednoho přihlášení všechny servery, na kterých bot je, a Server Health Score převádí aktivitu, retenci a onboarding na jedno číslo. Vydání lze stáhnout 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
Starý projekt, který jsem oživil
Tenhle bot není nový. První verzi jsem napsal před lety pro své herní komunity a pak ho nechal ležet tak, jak to s vedlejšími projekty bývá - rozbité závislosti, dashboard, který už nešel sestavit, polovina příkazů tiše padala.
V roce 2026 jsem se k němu vrátil, vyhodil z něj všechno mrtvé, zbytek přepsal do TypeScriptu na discord.js 14 a postavil nad tím pořádný Next.js dashboard. Verze 3.0 je právě ta přestavba: 82 slash příkazů, 44 zapínatelných modulů a devět jazyků, a všechno opravdu funguje.
Jak to vypadá
Dva screenshoty z běžící instance - úvodní stránka a jedna z konfiguračních obrazovek.
Kde běží
Běží na vašem stroji, ne na cizí službě. Jsou na to dva způsoby a oba jsou záměrně nudné.
Linux server nebo VPS
Naklonujte repozitář, zkopírujte .env.example na .env, doplňte token a spusťte npm start. Node.js 18 nebo novější, doporučuji 22 LTS. Systemd unit se postará o to, aby běžel dál.
Pterodactyl
Naimportujte přiložený egg, nahrajte soubory přes SFTP, dejte token do Startup proměnných a stiskněte start. První start si sám doinstaluje závislosti a zkompiluje kód. Node nebo Python launcher, podle toho, co egg používá.
Úložiště podle vás
JSON soubory nepotřebují žádné nastavení a jsou výchozí, MySQL nebo MariaDB na velký server. Mění se jeden řádek v .env.
Stáhněte si ho a spusťte
Vydání jsou na GitHubu. Stáhněte si nejnovější, projděte si INSTALL.md a za nějakých deset minut máte vlastní instanci. Provoz na vlastní infrastruktuře je zdarma; dál ho prodávat ani hostovat pro jiné nesmíte.
Server Health Score
Většina botů ukazuje statistiky. Tenhle říká, co znamenají. Server Health Score zhustí aktivitu, retenci a zapojení nových členů do jednoho čísla - takže víš, jestli komunita roste, stagnuje nebo tiše krvácí, dřív než to bude bolestivě zjevné.
Jak skóre fungujeKaždá složka má vlastní skóre 0-100, vyšší je lepší. Váhy: aktivita 25 %, retence 25 %, zapojení 20 %, růst 15 %, nízká toxicita 15 %.
Co všechno umí
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.
Volitelný dashboard
Webový dashboard s přihlášením přes Discord, kde si server vyberete z rozbalovacího seznamu a nastavíte ho. Jeden dashboard obslouží všechny servery, na kterých bota máte - přepínáte mezi nimi bez odhlašování. Zapínáte moduly, nastavujete AutoMod, kreslíte uvítací karty s živým náhledem, skládáte embedy, čtete analytiku a audit log, spravujete API klíče a zálohy. Je volitelný, všechno se dá nastavit i přímo z Discordu. Rozhraní v devíti jazycích.
- Discord OAuth2 login
- Server selector
- Module management
- AutoMod configuration
- Welcome card builder
- Embed builder
- Analytics
- Audit log
- API keys
- Backups
Proč právě tenhle
Vše v jednom, self-hosted
Žádné měsíční poplatky třetím stranám, žádný paywall, plná kontrola nad daty.
Skutečná modularita
Jeden sdílený registr modulů používá bot i dashboard - přepínač v UI nemůže existovat, aniž by ho bot četl. Vše nepotřebné lze vypnout.
Plugin systém
Drop-in pluginy s vlastními příkazy a eventy, hot-loadable, bez zásahu do jádra. Stačí manifest.json a index.js.
Flexibilní databáze
JSON bez setupu, MySQL/MariaDB pro velká nasazení.
Jednoduché nasazení
Pterodactyl egg s automatickou instalací při prvním bootu, klasicky přes npm na VPS, nebo Python launcher.
Zpětná kompatibilita
Staré textové příkazy jako !daily fungují přes prefix bridge vedle slash commands.