Dokumentacja

Krótki przewodnik po konfiguracji, komendach i najważniejszych funkcjach Unixa.

Start

Szybki start z Unixem

Jeśli chcesz przejść od zera do działającego bota bez zgadywania, zacznij od tych trzech kroków. To najkrótsza ścieżka do uruchomienia podstawowej moderacji i komend użytkowych.

Najkrótsza ścieżka wdrożenia

1. Dodaj bota

Użyj oficjalnego linku zaproszenia i upewnij się, że podczas autoryzacji bot dostaje uprawnienia potrzebne do moderacji, wiadomości, kanałów i ról.

2. Sprawdź podstawy

Po dodaniu uruchom komendy typu /ping, /info i /konfiguracja, żeby potwierdzić, że bot odpowiada i ma poprawne scope aplikacji.

3. Ustaw serwer

Skonfiguruj role, kanały i podstawowe moduły. Najpierw ustaw porządek uprawnień, dopiero później aktywuj akcje automatyczne.

Przykład startowy
Składnia

Jak czytać zapis komend

W dokumentacji i na stronie komend Unix używa jednego spójnego formatu. To pozwala szybko odróżnić nazwę komendy, argumenty wymagane, opcjonalne oraz pola zależne od konkretnej akcji.

Spójny zapis w całym serwisie
Nazwa komendy /ban
Argument wymagany @użytkownik
Argument opcjonalny [powód]
Akcja lub tryb komendy [akcja]
Najlepsza praktyka: najpierw przeczytaj wymagane argumenty, potem sprawdź ograniczenia uprawnień i dopiero uruchamiaj komendę. W wielu przypadkach problem nie wynika z błędnej składni, tylko z braku uprawnień bota albo użytkownika.
Konfiguracja

Jak ustawić serwer pod Unixa

Dobrze ustawiona kolejność ról i dostępów rozwiązuje większość problemów jeszcze przed pierwszą komendą moderacyjną.

Najczęstszy punkt błędów

Pozycja roli bota

Rola Unix musi być wystarczająco wysoko, jeśli bot ma zarządzać rolami, mute’ować użytkowników albo zmieniać ich nicki.

Kanały i widoczność

Bot musi widzieć kanał, czytać wiadomości i mieć możliwość wysyłania odpowiedzi. Bez tego komenda może się wykonać częściowo albo wcale nie zwrócić komunikatu.

Dobre pierwsze komendy
Role

Uprawnienia, dostęp i odpowiedzialność

Unix nie obchodzi ograniczeń Discorda. Jeśli komenda dotyka moderacji, kanałów lub ról, serwer musi jawnie pozwalać na tę operację.

Discord zawsze ma ostatnie słowo
Moderacja Banowanie, wyrzucanie, timeout i warny wymagają odpowiednich permissionów po stronie Discorda.
Zarządzanie kanałami Komendy typu /lock, /unlock, /slowmode i część sticky message opierają się na permissionach kanału.
Role i nicki Jeśli bot nie może ruszyć roli lub pseudonimu, najczęściej jego rola stoi za nisko w hierarchii.
Premium

Co odblokowuje Premium

Premium odblokowuje dodatkowe funkcje i większe limity. W panelu użytkownika oraz panelu administracyjnym możesz sprawdzić bieżący status, typ konta i zakres aktywnych możliwości.

Dodatkowe możliwości i limity

Dostęp do funkcji Premium

Część komend ma warianty lub tryby dostępne wyłącznie dla kont z aktywnym Premium. Na stronie komend są one oznaczane osobnym badge.

Limity embedów i konta

Unix rozróżnia limity zależnie od typu konta. Jeśli pracujesz na panelu lub systemie embedów, sprawdzaj aktualny limit przypisany do roli.

Jeśli widzisz funkcję oznaczoną jako Premium, ale nie działa mimo aktywnego konta, sprawdź najpierw, czy zalogowane konto Discord jest tym samym, do którego przypisano status Premium w bazie.
Diagnostyka

Najczęstsze problemy i szybkie decyzje

Zanim zgłosisz błąd, przejdź przez te punkty. W praktyce rozwiązują większość problemów z działaniem komend i widocznością bota na serwerze.

Checklista przed zgłoszeniem
Bot nie odpowiada Sprawdź scope zaproszenia, uprawnienia do kanału i czy Discord zdążył zsynchronizować komendy aplikacji.
Komenda działa częściowo Zazwyczaj brakuje jednego, konkretnego permissionu: kanały, role, timeout albo wiadomości.
Funkcja panelu nie działa Zweryfikuj, czy jesteś zalogowany na właściwe konto i czy twoja rola ma aktywny dostęp do danej sekcji.
Nic nie pasuje do wyszukiwania. Spróbuj wpisać inną frazę, na przykład: Premium, konfiguracja albo uprawnienia.
Skopiowano do schowka
Postaw kawę dla Fotograf Janek Król / Jakrlx na buycoffee.to