Lista funkcjonalności
Zarządzanie rolami
Zarządzanie rolami jest oparte o tak zwane "bezpieczne role" (safe roles), czyli liste roli, które na danym serwerze są ustawione jako bezpieczne.
Jeśli rola jest ustawiona jako bezpieczna, użytkownik może ją sobie dodać bez pomocy admina.
Listy bezpiecznych roli są indywidualne dla wszystkich serwerów, nie istnieje lista z domyślnymi rolami.
-roles
Wyświetla liste wszystkich bezpiecznych roli na serwerze.
-set role {role} -safe
Dodaje role do listy bezpiecznych roli.
Przykład użycia: -set role testowa safe
-set role {role} -unsafe
Dodaje role jako bezpieczną.
Przykład użycia: -set role testowa unsafe
-add role {role}
Przypisuje role do użytkownika, który wpisał komende.
Przykład użycia: -add role testowa
-remove role {role}
Usuwa role użytkownikowi, który wpisał komende.
Przykład użycia: -remove role testowa
Statystyki
-stats {period}
Generuje wykres statystyk podający dokładność co podanego okresu czasu.
Dostępne okresy:
- hour
- day
- week
- month
Przykład użycia: -stats month
.
Konfigurowalne odpowiedzi
Bot działa w oparciu o templatki, na podstawie których renderujemy odpowiedzi.
Przy określonych wydarzeniach, zwracamy określone odpowiedzi. Jednak to co znajdzie się w tej odpowiedzi, zależy już od indywidualnej konfiguracji serwera.
Odpowiedzi dzielą się na domyślne i skonfigurowane przez serwer (nadpisane przez niego).
-add response -onevent {onEvent} -message {message}
Jeśli serwer nie nadpisał domyślnej odpowiedzi, dodaje jej nadpisanie.
Przykład użycia: -add response -onevent PrintHelp -message "help print2"
-update response -onevent {onEvent} -message {message}
Jeśli serwer nadpisał domyślną odpowiedź, aktualizuje nadpisaną odpowiedź.
Przykład użycia: -update response -onevent PrintHelp -message "help print3"
-remove response -onevent {onEvent}
Jesli serwer nadpisał domyślną odpowiedź, usuwa nadpisanie (teraz będzie korzystać z domyślnej).
Przykład użycia: -remove response -onevent PrintHelp
Parametry:
onEvent
- identyfikator wydarzenia przy którym jest wywoływana komenda.
message
- treść wiadomości, jeśli jest dłuższy niż jedno słowo (zawiera spacje), musi być wewnątrz cudzysłowów.
Lista dostępnych wydarzeń z danymi domyślnymi:
AvailableSafeRoles
domyślna wartość - Dostępne role: {{roles}}
MutedUser
domyślna wartość - Użytkownik {{user}} został zmutowany do {{timeEnd}}UTC
NewUserArrived
domyślna wartość - Cześć {{user}}! Witamy cię na serwerze {{server}}
NotEnoughArguments
domyślna wartość - Podano niewystarczającą liczbę argumentów!
NumberOfMessagesIsHuge
domyślna wartość - Liczba wiadomości w podanym zakresie jest ogromna ({{messagesCount}} wiadomości). Czy na pewno chcesz wszystkie przeczytać? (użyj parametru -force)
PrintHelp
domyślna wartość - `Dostępne komendy: ```{{help}}````
ReadingHistoryDone
domyślna wartość - Zakończono wczytywanie historii wiadomości.
ResponseAlreadyExists
domyślna wartość - Odpowiedź {{onEvent}} już istnieje dla serwera **{{server}}**.
ResponseHasBeenAdded
domyślna wartość - Odpowiedź {{onEvent}} została dodana dla serwera **{{server}}**.
ResponseHasBeenRemoved
domyślna wartość - Odpowiedź {{onEvent}} została usunięta dla serwera **{{server}}**.
ResponseHasBeenUpdated
domyślna wartość - Odpowiedź {{onEvent}} została zaktualizowana dla serwera **{{server}}**.\nStara odpowiedź: *{{oldMessage}}*.\nNowa odpowiedź: *{{newMessage}}*.
ResponseNotFound
domyślna wartość - Odpowiedź {{onEvent}} nie została odnaleziona dla serwera **{{server}}**.
RoleAddedToUser
domyślna wartość - Dodano role: {{role}} użytkownikowi {{user}}
RoleIsInUserAlready
domyślna wartość - Użytkownik {{user}} posiada już role {{role}}
RoleNotFound
domyślna wartość - Nie znaleziono roli {{role}}.
RoleNotFoundInUser
domyślna wartość - Użytkownik {{user}} nie posiada roli {{role}}
RoleNotFoundOrIsNotSafe
domyślna wartość - Nie znaleziono roli {{role}} lub wybrana rola musi być zmieniona ręcznie przez członka administracji
RoleRemovedFromUser
domyślna wartość - Usunięto role {{role}} użytkownikowi {{user}}
RoleSettingsChanged
domyślna wartość - Zmieniono ustawienia roli {{role}} pomyślnie!
SentByDmMessagesOfAskedUser
domyślna wartość - Wysłano {{messagesCount}} wiadomości użytkownika {{user}} w wiadomości prywatnej.
ServerDoesntHaveAnySafeRoles
domyślna wartość - Serwer nie ma żadnych dostępnych bezpiecznych ról (jeśli jesteś adminem, ustaw bezpieczne role za pomocą komendy -set role <nazwa_roli> safe)
SpamAlertRecognized
domyślna wartość - Spam alert! Wykryto spam u użytkownika {{user}} na kanale {{channel}}. Poczekaj chwile zanim coś napiszesz.
SpamAlertUserIsMuted
domyślna wartość - Spam alert! Uzytkownik {{user}} został zmutowany.
SpamAlertUserIsMutedForLong
domyślna wartość - Spam alert! Użytkownik {{user}} został zmutowany na dłużej
TimeCannotBeNegative
domyślna wartość - Czas nie może być ujemny!
TimeIsTooBig
domyślna wartość - Podano za dużą wartość czasu!
TimeNotSpecified
domyślna wartość - Nie określiłeś przedziału czasu!
UnmutedUser
domyślna wartość - Użytkownik {{user}} może pisać ponownie.
UnmutedUserForUser
domyślna wartość - Cześć {{user}}! Już możesz pisać ponownie na serwerze {{server}}
UserDidntMentionAnyUser
domyślna wartość - Nie wskazałeś żadnego użytkownika!
UserDidntWriteAnyMessageInThisTime
domyślna wartość - Użytkownik {{user}} nie napisał żadnej wiadomości w podanym czasie.
UserDoesntHaveAvatar
domyślna wartość - Użytkownik {{user}} nie posiada avatara.
UserIsNotAdmin
domyślna wartość - Nie masz wystarczających uprawnień do wywołania tej komendy.
UserNotFound
domyślna wartość - Użytkownik {{user}} nie istnieje.
Automatyczne wykrywanie spamu
Bot po wykryciu spamu, powiadamia podejrzaną osobę, żeby na chwilę przestała pisać - pozwoli to na rozwianie podejrzeń czy ta osoba jest spamerem.
Jeśli ta osoba będzie pisać dalej (mimo ostrzeżenia), zostanie zmutowana na krótki okres czasu.
Po tym okresie czasu, osoba ta przestaje być zmutowana, ale trafia na listę osób podejrzanych - będąc na tej liście, przy kolejnym zmutowaniu w wyniku spamu, okres zmutowania będzie trwał zauważalnie dłużej niż poprzedni.
Po dłuższym czasie w którym nie wykryto spamu u tej osoby, ta osoba znika z listy osób podejrzanych.
Istnieje również coś takiego jak lista osób zaufanych, czyli osoby które długi czas udzielały się na serwerze, są objęte mniej rygorystycznymi zasadami dotyczącymi spamu (mogą pozwolić sobie na większą częstotliwość wysyłania wiadomości - zakładamy że bezmyślny spamer prędzej sie podda niż zawalczy o dostanie się na tą listę).
Mutowanie
-mute {user} -t {time} -reason {reason}
Mutuje określonego użytkownika, na określony czas, z określonego powodu.
Parametry:
user
- wzmianka użytkownika
time
- czas podany w formacie liczba(h|m|s)
reason
- tekst, jeśli jest dłuższy niż jedno słowo (zawiera spacje), musi być wewnątrz cudzysłowów
Przykłady użycia:
-mute @Testowy123 -t 10h -reason "łamanie regulaminu serwera"
-mute @Testowy123 -t 5m -reason testowy
-mute @UserABC -t 30s -reason "przykładowy powód"
Inne
-avatar
Wyświetla awatar użytkownika, który wpisał komende.
-marchew
Odpowiedź na życie
-init
Inicjalizacja serwera (załadowanie informacji o serwerze do bazy danych bota).
Uruchamia się automatycznie przy starcie bota, jednak jeśli dopiero go dodałeś do serwera - możliwe że jeszcze nie przeszedł inicjalizacji - wtedy warto zrobić ją manualnie.