feat: improve Discord player controls and docs

README.md

@@ -28,6 +28,36 @@ uploady w katalogach `uploads/<guild_id>/`.
 Ostatnia kolejka jest zapisywana w `config/queues/<guild_id>.json` przy zatrzymaniu
 lub rozłączeniu i może zostać przywrócona z widoku kolejki.
 
+## Komendy Discorda
+
+Wszystkie komendy działają w kontekście bieżącego serwera. Discord pokazuje wybór
+utworów przez autocomplete, a kanały przez natywne selektory — nie trzeba wpisywać
+indeksów ręcznie.
+
+| Komenda | Działanie |
+| --- | --- |
+| `/player` | Publiczny panel odtwarzacza z przyciskami sterowania |
+| `/play query` | Dodaje utwór, link lub zapytanie wyszukiwania |
+| `/playfile filename` | Odtwarza plik z biblioteki serwera |
+| `/replay track_id` | Ponownie odtwarza utwór z historii |
+| `/queue` | Pokazuje kolejkę w embedzie |
+| `/history` | Pokazuje historię odtwarzania |
+| `/restorequeue` | Przywraca ostatnią zapisaną kolejkę |
+| `/jump track_id` | Rozpoczyna wybrany utwór z kolejki |
+| `/remove track_id` | Usuwa wybrany utwór z kolejki |
+| `/trackplays track_id count` | Ustawia liczbę odtworzeń utworu |
+| `/pause`, `/resume` | Wstrzymuje lub wznawia odtwarzanie |
+| `/skip` | Pomija bieżący utwór |
+| `/stop` | Zatrzymuje odtwarzanie i czyści kolejkę |
+| `/volume volume` | Ustawia głośność w zakresie 1–100 |
+| `/nowplaying` | Pokazuje bieżący utwór |
+| `/loop` | Przełącza tryb zapętlania |
+| `/loopplaylist` | Włącza lub wyłącza zapętlanie kolejki |
+| `/defaultplays count` | Ustawia domyślną liczbę odtworzeń dla nowych utworów |
+| `/connect channel` | Łączy bota z wybranym kanałem głosowym |
+| `/notificationchannel channel` | Ustawia kanał powiadomień |
+| `/leave` | Rozłącza bota z kanału głosowego |
+
 ## Testy
 
 ```bash