Dokumentacja Bota — Drakon SaaS Control

📐 1. Architektura Frameworka Drakon

Drakon Framework to zaawansowane, bezkompromisowe środowisko dla botów Discord oparte na stosie Discord.js v14, Lavalink v4, Kazagumo, oraz MongoDB Mongoose.

System posiada wbudowany serwer WWW Express z panelem zarządczym w stylu Czerwone Szkło (Glassmorphic Red), wspierającym dynamiczne statystyki w czasie rzeczywistym oraz płynne przełączanie języków serwera (PL, EN, DE).

🎵 2. Ekstremalny System Muzyki (Lavalink v4)

Drakon wykorzystuje wbudowany, automatycznie zarządzany proces Lavalink 4 (Java 21) działający na porcie 10050 z maksymalną jakością kodowania Opus (10/10 High-Fidelity).

Obsługiwane platformy źródłowe:

🔴 YouTube / YouTube Music — zapytania tekstowe i linki bezpośrednie (ytmsearch z 0ms RAM Cache)
💚 Spotify — linki do utworów, albumów i playlist
🍎 Apple Music — linki do playlist i albumów w wysokiej jakości
💜 Twitch — bezpośrednie transmisje na żywo
🔊 SoundCloud — zapytania i linki audio

⚡ 3. Pełny Katalog Komend Bota (61 komend)

Komendy bota podzielone są na czytelne kategorie. Dostępne są zarówno przez prefiks serwera (np. d!play) jak i interakcje Slash (/play). Szczegółową pomoc i przykład użycia uzyskasz komendą d!help <komenda> w Discordzie.

🎵 3.1. Komendy Muzyczne (19 komend)

Komenda	Opis	Składnia Użycia	Przykład
`play`	Odtwarza utwór lub playlistę z autouzupełnianiem na żywo	`d!play <nazwa\|URL>`	`d!play Never Gonna Give You Up`
`pause` / `resume`	Wstrzymuje lub wznawia odtwarzanie muzyki	`d!pause`	`d!pause`
`skip`	Pomija obecnie grany utwór	`d!skip`	`d!skip`
`stop`	Zatrzymuje muzykę i czyści całą kolejkę	`d!stop`	`d!stop`
`queue`	Wyświetla obecną kolejkę utworów	`d!queue [strona]`	`d!queue 2`
`volume`	Ustawia głośność odtwarzania (1-150%)	`d!volume <1-150>`	`d!volume 80`
`loop`	Zmienia tryb zapętlania (track / queue / off)	`d!loop <mode>`	`d!loop track`
`filters`	Stosuje cyfrowe filtry dźwięku (bassboost itp.)	`d!filters <apply\|remove\|clear\|list>`	`d!filters apply bassboost`
`nowplaying`	Wyświetla szczegóły granego utworu	`d!nowplaying`	`d!np`
`previous`	Odtwarza poprzedni utwór z historii	`d!previous`	`d!prev`
`remove`	Usuwa utwór z kolejki po pozycji	`d!remove <pozycja>`	`d!remove 3`
`move`	Przesuwa pozycję utworu w kolejce	`d!move <z> <do>`	`d!move 5 1`
`seek`	Przewija utwór do wskazanego czasu	`d!seek <pozycja>`	`d!seek 1m30s`
`shuffle`	Miesza kolejność utworów w kolejce	`d!shuffle`	`d!shuffle`
`lyrics`	Pobiera tekst piosenki z Genius	`d!lyrics [tytuł]`	`d!lyrics Hotel California`
`autoplay`	Przełącza automatyczne dobieranie utworów	`d!autoplay`	`d!autoplay`
`247`	Utrzymuje bota 24/7 na kanale głosowym	`d!247`	`d!247`
`radio`	Odtwarza stacje radiowe 24/7 (lofi, eska, zet itp.)	`d!radio <stacja>`	`d!radio lofi`
`playlist`	Zarządza prywatnymi i serwerowymi playlistami	`d!playlist <action> [nazwa]`	`d!playlist list`

🛡️ 3.2. Komendy Moderacyjne (9 komend)

Komenda	Opis	Składnia Użycia	Przykład
`ban`	Banuje użytkownika na serwerze	`d!ban <@user\|ID> [powód]`	`d!ban @User Złamanie zasad`
`kick`	Wyrzuca użytkownika z serwera	`d!kick <@user\|ID> [powód]`	`d!kick @User Przeszkadzanie`
`timeout`	Wycisza użytkownika na określony czas w min	`d!timeout <@user> <minuty> [powód]`	`d!timeout @User 15 Spam`
`unmute`	Usuwa wyciszenie/timeout użytkownika	`d!unmute <@user> [powód]`	`d!unmute @User`
`warn`	Nadaje ostrzeżenie dla użytkownika	`d!warn <@user> [powód]`	`d!warn @User Wulgaryzmy`
`warnings`	Wyświetla listę ostrzeżeń użytkownika	`d!warnings [user]`	`d!warnings @User`
`clear`	Masowo usuwa wiadomości z kanału	`d!clear <ilość> [@user]`	`d!clear 20`
`cases`	Przegląda kartotekę kar i spraw moderacji	`d!cases [user]`	`d!cases @User`
`unban`	Odblokowuje zbanowanego użytkownika po ID	`d!unban <userID> [powód]`	`d!unban 123456789012345678`

⚙️ 3.3. Komendy Administracyjne (9 komend)

Komenda	Opis	Składnia Użycia	Przykład
`setprefix`	Zmienia prefiks komend tekstowych	`d!setprefix <prefix>`	`d!setprefix !`
`setlanguage`	Zmienia główny język odpowiedzi (pl, en, de)	`d!setlanguage <pl\|en\|de>`	`d!setlanguage en`
`setwelcome`	Ustawia kanał i treść powitań	`d!setwelcome <enable\|disable> [kanał] [treść]`	`d!setwelcome enable #powitania Witaj!`
`setgoodbye`	Ustawia kanał i treść pożegnań	`d!setgoodbye <enable\|disable> [kanał] [treść]`	`d!setgoodbye enable #pożegnania Żegnaj!`
`setglobalchat`	Rejestruje kanał w sieci Global Chat	`d!setglobalchat <#kanał>`	`d!setglobalchat #global-chat`
`streamer`	Zarządza powiadomieniami o streamach Live	`d!streamer <add\|remove\|list> [nick] [kanał]`	`d!streamer add nick #streamy`
`autovoice`	Konfiguruje automatyczne kanały głosowe Join-To-Create	`d!autovoice action:setup`	`d!autovoice action:setup`
`ticket`	Inicjalizuje system zgłoszeń i paneli pomocy	`d!ticket`	`d!ticket`
`socialalerts`	Ustawia powiadomienia z mediów społecznościowych	`d!socialalerts platform:yt target:ID channel:#yt`	`d!socialalerts platform:youtube target:ID channel:#yt`

ℹ️ 3.4. Komendy Informacyjne (10 komend)

Komenda	Opis	Składnia Użycia	Przykład
`botinfo`	Wyświetla statystyki i architekturę bota	`d!botinfo`	`d!botinfo`
`help`	Wyświetla menu pomocy i szczegóły komend	`d!help [komenda]`	`d!help play`
`serverinfo`	Szczegółowe statystyki serwera Discord	`d!serverinfo`	`d!serverinfo`
`userinfo`	Informacje o użytkowniku i jego rolach	`d!userinfo [@user]`	`d!userinfo @User`
`ping`	Opóźnienie bota i komunikacji WebSocket	`d!ping`	`d!ping`
`rank`	Karta XP i poziomu aktywności użytkownika	`d!rank [@user]`	`d!rank`
`leaderboard`	Ranking najaktywniejszych osób na serwerze	`d!leaderboard`	`d!leaderboard`
`uptime`	Historia czasów działania i statystyki sesji	`d!uptime`	`d!uptime`
`systeminfo`	Telemetria sprzętowa, sieć i obciążenie Host Proceso	`d!systeminfo`	`d!systeminfo`
`voice`	Zarządzanie własnym tymczasowym pokojem głosowym	`d!voice <lock\|limit\|rename> [wartość]`	`d!voice limit 5`

🎮 3.5. Komendy Zabawne i Narzędziowe (9 komend)

Komenda	Opis	Składnia Użycia	Przykład
`8ball`	Zadaj pytanie magicznej kuli 8ball	`d!8ball <pytanie>`	`d!8ball Czy dzisiaj wygram?`
`say`	Wysyła wiadomość z poziomu bota	`d!say [#kanał] <treść>`	`d!say Siema wszystkim!`
`avatar`	Pobiera pełny avatar użytkownika	`d!avatar [@user]`	`d!avatar @User`
`coinflip`	Rzut monetą (Orzeł czy Reszka)	`d!coinflip`	`d!coinflip`
`dice`	Rzut kośćmi do gry	`d!dice [ilość] [ścianki]`	`d!dice 2 6`
`meme`	Losuje śmiesznego mema z Reddit	`d!meme [subreddit]`	`d!meme dankmemes`
`poll`	Tworzy szybką ankietę do głosowania	`d!poll <pytanie> \| [opcja1] \| [opcja2]`	`d!poll Co gramy? \| LoL \| Val`
`rps`	Gra w papier, kamień, nożyce z botem	`d!rps <papier\|kamień\|nożyce>`	`d!rps kamień`
`embed`	Kreator estetycznych kart Embed	`d!embed [#kanał] \| Tytuł \| Treść`	`d!embed Tytuł \| Treść`

👑 3.6. Komendy Właściciela Bota (5 komend)

Komenda	Opis	Składnia Użycia	Przykład
`debug`	Diagnostyka deweloperska stanu bota	`d!debug`	`d!debug`
`eval`	Wykonuje surowy kod JS (Owner Only)	`d!eval <kod>`	`d!eval 2+2`
`reload`	Przeładowuje komendy i moduły w locie	`d!reload [nazwa\|all]`	`d!reload play`
`serverlist`	Lista wszystkich serwerów i zarządca zdalny	`d!serverlist [strona]`	`d!serverlist`
`shutdown`	Zamyka proces bota	`d!shutdown`	`d!shutdown`

🌍 4. System Umiędzynarodowienia (i18n)

Wszystkie komunikaty, błędy oraz cały interfejs Panelu WWW są dynamicznie tłumaczone. Administratorzy serwera mogą w każdej chwili zmienić język za pomocą komendy d!setlanguage lub w ustawieniach serwera w panelu.

🎥 5. Powiadomienia o Streamach Live

Drakon pozwala na dodawanie automatycznych powiadomień dla streamera Twitch. Bot sprawdzając stan transmisji co 2.5 minuty wysyła powiadomienie na wybrany kanał Discord z obsługą własnego wzorca wiadomości oraz powiadomień ról (@everyone, @here lub dedykowanej roli).

📖 Dokumentacja Bota — Drakon Framework