Najczęstsze pytania
Ogólne
Czym jest MadaraBot?
MadaraBot to wielofunkcyjny bot Discord do moderacji, muzyki, poziomów XP, ekonomii, ticketów, powitań i zarządzania społecznością. Większość funkcji konfigurujesz w panelu webowym bez pisania kodu.
Czy bot jest darmowy?
Tak. Plan Free obejmuje moderację, muzykę, poziomy, ekonomię, powitania, auto-role, tickety, konkursy i panel webowy. Plan Plus dodaje m.in. branding bota, powiadomienia z YouTube/Twitch i rozszerzone tickety — szczegóły na stronie Plus.
Na ilu serwerach mogę używać bota?
MadaraBot może być na wielu serwerach jednocześnie. Konfiguracja jest osobna dla każdego serwera (guild) — ustawienia z jednego Discorda nie przenoszą się na inny.
Czy bot jest bezpieczny?
Bot działa wyłącznie w zakresie uprawnień, które mu nadasz przy zaproszeniu. Nie sprzedajemy danych użytkowników. Szczegóły przetwarzania danych opisuje polityka prywatności.
Instalacja i zaproszenie
Jak dodać bota na serwer?
Kliknij „Dodaj bota na serwer" lub „Konfiguracja bota" na stronie głównej. Zaloguj się do Discorda, wybierz serwer i zaakceptuj wymagane uprawnienia. Po dołączeniu bota komendy slash pojawią się w ciągu kilku minut.
Jakie uprawnienia są potrzebne?
Zalecane: zarządzanie kanałami, rolami i wiadomościami, wyrzucanie i banowanie członków, moderowanie członków, łączenie z kanałami głosowymi i mówienie. Bez nich część funkcji (np. mute, czyszczenie wiadomości, muzyka) może nie działać.
Dlaczego nie widzę komend slash?
Poczekaj 1–5 minut po dodaniu bota. Upewnij się, że masz uprawnienia do używania aplikacji na serwerze. Jeśli nadal ich nie ma — wyrzuć i dodaj bota ponownie lub napisz na formularz kontaktowy.
Bot nie dołącza do kanału głosowego (muzyka)
Użytkownik wywołujący komendę muzyczną musi być na kanale głosowym. Bot automatycznie dołącza do tego samego kanału. Sprawdź, czy bot ma uprawnienia „Łączenie" i „Mówienie" na kanale głosowym.
Panel webowy
Czy potrzebuję konta Discord do panelu?
Tak. Logujesz się przez Discord OAuth (przycisk „Zaloguj przez Discord"). To standardowe i bezpieczne logowanie — hasła Discorda nie przechowujemy.
Kto ma dostęp do panelu?
Domyślnie właściciel bota (skonfigurowany w .env) oraz osoby dodane jako administratorzy panelu. W panelu widzisz tylko serwery, na których masz uprawnienia do zarządzania i gdzie jest bot.
Jak włączyć lub wyłączyć moduły?
W panelu wybierz serwer z listy, przejdź do sekcji modułów (moderacja, muzyka, ekonomia itd.) i włącz/wyłącz przełączniki. Wyłączony moduł blokuje powiązane komendy slash na tym serwerze.
Czy zmiany w panelu działają od razu?
Większość ustawień zapisuje się natychmiast po kliknięciu „Zapisz zmiany". Niektóre elementy (np. panele selfrole już wysłane na kanał) wymagają ponownej publikacji lub restartu konkretnej funkcji.
Muzyka
Jak odtwarzać muzykę?
Dołącz do kanału głosowego i użyj /play z linkiem YouTube lub nazwą utworu. Bot dołączy do Twojego kanału i zacznie odtwarzać. Kolejka: /queue, aktualny utwór: /nowplaying.
Jakie źródła audio są obsługiwane?
Głównie YouTube (link lub wyszukiwanie po nazwie). Upewnij się, że moduł muzyki jest włączony w panelu dla danego serwera.
Jakie są komendy muzyczne?
/play, /pause, /resume, /skip, /stop, /queue, /nowplaying, /volume (0–100). Wymagają modułu muzyki i obecności na kanale głosowym.
Muzyka się zacina lub bot się rozłącza
Sprawdź stabilność internetu serwera Discord i obciążenie VPS bota. Zbyt duża kolejka lub wiele serwerów jednocześnie mogą wpływać na jakość. Zgłoś problem przez kontakt z opisem serwera i godziny wystąpienia.
Moderacja i bezpieczeństwo
Jakie komendy moderacyjne oferuje bot?
/kick, /ban, /mute, /unmute, /clear (1–100 wiadomości), /warn, /warnings. Wymagają odpowiednich uprawnień Discorda u moderatora.
Czy jest automatyczna moderacja?
Tak — w panelu możesz skonfigurować filtry (np. wulgaryzmy, spam, linki), automatyczne kary i logi na wybrany kanał. Dokładne reguły zależą od ustawień Twojego serwera.
Jak działa system ostrzeżeń?
Moderator używa /warn z powodem. Ostrzeżenia są zapisywane i można je podejrzeć przez /warnings. W panelu możesz ustawić progi (np. automatyczny mute po X warnach).
Gdzie są logi moderacji?
W panelu wskaż kanał logów. Bot wysyła tam informacje o kickach, banach, mute, warnach i wybranych zdarzeniach — zależnie od konfiguracji.
Poziomy i ekonomia
Jak działa system poziomów (XP)?
Użytkownicy zdobywają XP za aktywność (wiadomości na tekstowych kanałach, czas na kanałach głosowych — według ustawień). /rank pokazuje poziom, /leaderboard — ranking serwera.
Jak ustawić XP ręcznie?
Administratorzy mogą użyć /setxp z wybraną wartością XP dla użytkownika. W panelu dostosujesz też mnożniki, cooldowny i nagrody za poziomy.
Jak działa ekonomia?
Wirtualna waluta serwera: /balance, /work, /pay, /deposit, /withdraw, /shop, /buy-item, gry (/blackjack, /cock-fight) i inne. Moduł ekonomii można wyłączyć w panelu.
Czy poziomy i ekonomia mogą współpracować?
Tak. W panelu możesz przyznawać pieniądze, role lub przedmioty przy osiągnięciu określonego poziomu — to łączy engagement z nagrodami.
Tickety, role i społeczność
Jak skonfigurować tickety wsparcia?
W panelu ustaw kategorię i role obsługi. Na kanale użyj /ticket panel, aby wysłać przycisk otwierania ticketu. Zamknięcie: /ticket close w kanale ticketu. Plus oferuje transkrypty i rozszerzenia.
Czym są auto-role i selfrole?
Auto-role — role nadawane automatycznie po dołączeniu do serwera (panel → powitania/auto-role). Selfrole — panele z przyciskami (/selfrole create, /selfrole add, /selfrole publish).
Jak działają powitania?
W panelu ustaw kanał powitalny, treść wiadomości (embed lub tekst) i opcjonalnie obrazek. Wymaga włączonych intentów Server Members w Discord Developer Portal.
Jak uruchomić konkurs (giveaway)?
/giveaway start z nagrodą i czasem (np. 2h, 1d). Użytkownicy klikają przycisk, aby wziąć udział. /giveaway end kończy wcześniej, /giveaway list pokazuje aktywne.
Co to są automatyczne kanały głosowe?
Użytkownik wchodzi na kanał „generator" — bot tworzy prywatny kanał głosowy. Gdy kanał opróżni się, bot go usuwa. Konfiguracja w panelu w sekcji kanałów głosowych.
MadaraBot Plus
Czym jest plan Plus?
Plus to płatna licencja przypisana do jednego serwera Discord. Obejmuje m.in. branding bota (nick, avatar, status), powiadomienia YouTube/Twitch, rozszerzone tickety, formularze i priorytetowe wsparcie.
Jak aktywować Plus?
Wejdź na /plus, wybierz okres rozliczenia i serwer, a następnie dokończ zamówienie. Po płatności licencja aktywuje się na wskazanym guild ID. Pomoc: formularz kontaktowy.
Czy Plus działa na wielu serwerach?
Jedna licencja Plus = jeden serwer. Dla kolejnych serwerów potrzebujesz osobnej licencji lub skontaktuj się z nami w sprawie pakietu.
Co obejmuje branding bota (Plus)?
W panelu Plus ustawisz wyświetlaną nazwę bota, avatar, status (online/idle/dnd), typ aktywności i tekst „słucha / gra / ogląda". Zmiany dotyczą tylko serwera z aktywną licencją Plus.
Problemy techniczne
Jakie intenty Discord muszę włączyć?
W Discord Developer Portal włącz dla aplikacji bota: Server Members Intent, Message Content Intent (dla XP z wiadomości, filtrów i powitań). Bez nich bot działa w trybie ograniczonym.
Bot pokazuje się jako offline
Sprawdź status na stronie głównej (stopka). Możliwy restart hostingu lub problem z tokenem. Jeśli trwa dłużej niż 15 minut — zgłoś przez kontakt z numerem zgłoszenia.
Jak zgłosić błąd lub zaproponować funkcję?
Użyj formularza kontaktowego na stronie głównej. Podaj: opis problemu, ID serwera (guild), krok po kroku odtworzenia i zrzut ekranu, jeśli możesz.
Jak usunąć dane serwera / RODO?
Wyrzuć bota z serwera — konfiguracja przestaje być używana. W sprawach RODO (dostęp, usunięcie, sprostowanie) napisz przez kontakt z tematem „RODO" lub zobacz politykę prywatności.
Nadal potrzebujesz pomocy?