MatchDay Manager — instrukcja dla użytkowników Discorda

Ten dokument opisuje obsługę bota na serwerze Discord. Jest przeznaczony do publikacji w dokumentacji serwera — nie zawiera instrukcji instalacji ani konfiguracji backendu.

Role i dostęp

Administrator serwera konfiguruje role komendą:

/event-series-role manager_role:@Manager player_role:@Gracz

Manager może tworzyć i usuwać serie wydarzeń, zamykać zapisy, edytować wydarzenia i przygotowywać składy.
Gracz może głosować w ankietach wydarzeń. Każdy użytkownik może zmieniać lub cofnąć tylko własny głos.
Role muszą być różne. Nie można wybrać roli @everyone.
Administrator Discorda również potrzebuje roli Managera do funkcji managerskich. Wyjątkiem jest konfiguracja ról.

Tworzenie wydarzeń

Wydarzenie jednorazowe

Użyj /event-create. Możesz podać parametry w komendzie albo uruchomić ją bez parametrów, aby otworzyć formularz.

Formularz zawiera:

datę wydarzenia YYYY-MM-DD,
tytuł,
godzinę HH:MM,
kanał ogłoszeń — w formularzu wpisz ID kanału albo wzmiankę w formacie <#ID>; przy parametrach komendy wybierz kanał z listy,
opcjonalną godzinę końca zapisów HH:MM.

Opis jest pusty, a strefą czasową jest Europe/Warsaw. Kanał składu jest opcjonalny przy podawaniu parametrów bezpośrednio; domyślnie bot publikuje skład na kanale ogłoszenia. Wydarzenie jednorazowe nie jest automatycznie powtarzane.

Cykliczna seria

Użyj /event-series-create. Możesz podać parametry w komendzie albo uruchomić ją bez parametrów, aby otworzyć formularz. Formularz przyjmuje dni tygodnia, tytuł, godzinę, kanał ogłoszeń (ID lub wzmiankę <#ID>) i opcjonalną godzinę końca zapisów. Parametr notify_players włącza lub wyłącza prywatne przypomnienia dla graczy; domyślnie są wyłączone.

Jeśli przypomnienia są włączone, bot o 09:00 i 12:00 w strefie czasowej wydarzenia wysyła DM użytkownikom z przypisaną rolą Gracza, którzy nie oddali jeszcze żadnego głosu na to wydarzenie. Dowolny status — obecny, spóźniony lub nieobecny — oznacza odpowiedź i wyłącza przypomnienie dla tej osoby. Każda pora jest podejmowana najwyżej raz na użytkownika i wydarzenie. Jeśli użytkownik nie przyjmuje wiadomości prywatnych od bota, przypomnienie nie zostanie dostarczone.

Dni tygodnia mają numerację ISO:

Numer	Dzień
1	poniedziałek
2	wtorek
3	środa
4	czwartek
5	piątek
6	sobota
7	niedziela

Przykłady cyklu: 1-7 (codziennie), 1-3 (poniedziałek–środa), 1,3,5 (poniedziałek, środa i piątek). Godzina zapisów nie może być późniejsza niż godzina wydarzenia. Seria używa strefy Europe/Warsaw, jeśli nie podano innej.

Bot publikuje nadchodzące wydarzenia serii w ruchomym oknie siedmiu dni. Zmiana harmonogramu nie edytuje ogłoszeń, które zostały już opublikowane.

Edycja i usuwanie serii

/event-series-edit zmienia konfigurację serii. Podaj nowy cykl, tytuł, godzinę i kanał ogłoszeń; kanał składu jest opcjonalny. Parametr notify_players pozwala zmienić ustawienie przypomnień.
/event-series-remove confirm:Tak usuwa serię, jej przyszłe wydarzenia i ogłoszenia. Wydarzenia jednorazowe oraz wydarzenia z przeszłości pozostają.

Jeśli kanał składu nie zostanie wskazany przy tworzeniu lub edycji serii, bot użyje kanału ogłoszeń.

Tło grafiki składu

Manager może ustawić lub zastąpić tło dla serii komendą /event-series-background:

wybierz image, aby załączyć obraz z urządzenia; albo
podaj image_url z bezpośrednim linkiem HTTPS do obrazu z załącznika Discorda.

Obsługiwane są obrazy PNG, JPEG i WebP do 8 MB. Obrazy są zapisywane w katalogu ./lineup-assets na hoście/VM i zachowują się po restarcie kontenerów. Pliki są rozdzielone podkatalogami według ID serwera Discord. Jedno tło obowiązuje dla grafik wydarzeń tej serii. Jeśli tło nie zostało ustawione, grafika użyje domyślnego boiska.

Wygenerowana grafika zawiera logo bota w lewym górnym rogu, napis „Lineup FMM” obok oraz wyśrodkowaną, opcjonalną nazwę drużyny poniżej. Murawa w perspektywie i gracze zajmują dolne trzy czwarte grafiki. Większe ikony piłkarzy i pogrubione nazwy graczy są rozmieszczone według wybranej formacji; nazwy pozycji nie są drukowane. Grafikę zapisuje się jako lineup-<event_id>.jpg w katalogu serwera, a następnie publikuje na kanale pod listą składu. Kliknięcie Publish Lineup otwiera formularz, w którym manager może podać nazwę drużyny lub zostawić pole puste. Po publikacji panel kreatora zostaje zamknięty. Katalog lineup-assets należy uwzględnić w kopiach zapasowych.

Lista aktywnych wydarzeń

/event-list pokazuje prywatną listę nadchodzących, opublikowanych wydarzeń, pogrupowaną na wydarzenia cykliczne i jednorazowe. Wszystkie wydarzenia cykliczne są zebrane w jednej sekcji — komenda /event-series-remove confirm:Tak usuwa całą serię, jej przyszłe wydarzenia i ogłoszenia. Wydarzenia jednorazowe są wyraźnie oddzielone i nie są usuwane tą komendą. Tytuł każdego wydarzenia prowadzi do jego ogłoszenia. Lista pokazuje do 12 najbliższych pozycji.

Zapisy na wydarzenie

W ogłoszeniu wydarzenia dostępne są trzy przyciski:

✅ — zapisuję się,
⏰ — zapisuję się jako osoba spóźniona,
🚫 — zgłaszam nieobecność.

Do głosowania wymagana jest rola Gracza. Ponowne kliknięcie własnego statusu usuwa głos; kliknięcie innego przycisku zmienia odpowiedź. Lista zapisanych, spóźnionych i nieobecnych jest aktualizowana w ogłoszeniu. Głos 🚫 nie oznacza zapisu na mecz i nie pojawia się na liście graczy do składu.

Jeśli wydarzenie ma termin zapisów, bot blokuje głosowanie po wskazanej godzinie. Manager może też ręcznie zamknąć zapisy wcześniej.

Zarządzanie wydarzeniem

W ogłoszeniu managera znajdują się przyciski:

Edit — zmienia tytuł, opis i termin zapisów. Puste pole terminu usuwa termin. Dla wydarzeń z serii tytuł i opis mogą stanowić wyjątek dla danego dnia tygodnia.
Finish — ręcznie zamyka zapisy.
Unfinish — ponownie otwiera zapisy zamknięte ręcznie. Nie omija automatycznego terminu zapisów.
Lineup — otwiera kreator składu; jest dostępny po zamknięciu zapisów.

Zmiany w przyciskach Edit, Finish i Lineup wymagają roli Managera.

Przygotowanie i publikacja składu

Po zamknięciu zapisów wybierz Lineup.
Wybierz formację 11-osobową. Przy edycji istniejącego składu wybór tej samej formacji zachowuje przypisania; zmiana formacji czyści je.
Przypisz do pozycji zapisanych lub spóźnionych graczy. Tego samego gracza nie można przypisać do dwóch pozycji.
Wybierz Pusty, jeśli pozycja ma pozostać wolna, albo Testy, aby zarezerwować ją dla zawodnika testowego spoza grupy.
Panel pokazuje pełny podgląd 11 pozycji. Selektory edycji wyświetlają do 4 pozycji naraz — użyj przycisków nawigacji, aby przejść między stronami.
Cancel zamyka kreator bez zapisywania i publikowania zmian. Publish Lineup zapisuje skład i publikuje tekstową listę, a bezpośrednio pod nią grafikę na kanale składu. Po publikacji panel kreatora zostaje zamknięty, a przycisk Lineup w ogłoszeniu zmienia się na Locked. Kliknięcie Locked ponownie poprosi o potwierdzenie przed otwarciem kreatora i ponowną publikacją.

Jeśli manager nie skonfigurował osobnego kanału składu, bot publikuje listę i grafikę na kanale ogłoszenia. Gracze w opublikowanym składzie są oznaczeni wzmiankami Discorda, ale bot nie wysyła im powiadomień. Bot musi mieć na tym kanale uprawnienie Załączanie plików.