Discord Bot

Na naszych sesjach, które rozgrywamy poprzez Discorda, początkowo korzystaliśmy z jednego z prostych botów discordowych do rzutów. Dość szybko jednak okazało się, że nasze sesje spowalniały poprzez obliczenia, które musieliśmy robić. Dlatego też, wpadliśmy na pomysł stworzenia własnego bota, który obliczałby za nas poziomy sukcesu i tym podobne. Znacznie przyspiesza to prowadzenie sesji.

• roll - {liczba_kości}d{liczba_ścianek} - rzuca podaną kością podaną ilość razy. Komenda w skrócie to /r. Np. /roll 2d10 rzuci dwiema kośćmi o 10 ściankach Argumenty:

  • equation - {liczba_kości}d{liczba_ścianek} - liczba kości to domyślnie 1. Equation (równanie) wspiera proste operacje matematyczne jak mnożenie, dodawani czy odejmowanie. Np. 2d20 + 20

  • alias - pozwala użytkownikowi nadać nazwę rzutowi, aby pomóc w rozróżnianiu wielu rzutów. Alias zostanie wypisany po userze Np. komenda z equation 2d20 + 20 i alias Example zwróci @User(Example): 42 ((4+18) + 20)

  • hidden - pozwala użytkownikowi ukryć wartość rzutu. Wynik rzutu będzie jawny. Dla w pełni ukrytych rzutów można stworzyć osobny kanał lub napisać wiadomość prywatną do bota.

• test - komenda wykonuje test umiejętności o podanej wartości. Komenda w skrócie to /t. Zwraca (alias): wynik rzutu - failed/passed (liczba SL) częśćf ciała. Po wykonaniu testu pojawia się przycisk na 30 sekund, który pozwala na przerzucenie testu. Każdy test może być przerzucony dwa razy. Argumenty:

  • skill_level - wartość testowana. Skill_level wspiera proste operacje matematyczne jak mnożenie, dodawani czy odejmowanie. Np. 2d20 + 20

  • alias - pozwala użytkownikowi nadać nazwę testowi, aby pomóc w rozróżnianiu wielu testów Alias zostanie wypisany po userze Np. komenda z equation 40 + 20 and alias Example zwróci @User(Example): 81 - failed (-2SL) left hand

  • hidden - pozwala użytkownikowi ukryć wartość testu. Wynik testu w SL będzie jawny. Dla w pełni ukrytych testów można stworzyć osobny kanał lub napisać wiadomość prywatną do bota.

  • success_sl - poziomy sukcesu, które będą dodane jeśli test zostanie zdany.

  • additional_sl - poziomy sukcesu, które powinny zostać dodane lub odjęte od SL niezależnie od wyniku testu.

  • send_result_to - użytkownik do którego wynik testu zostanie wysłany w prywatnej wiadomości. Może być używane np do testów, których wynik powinien widzieć tylko MG.

• fight - komenda używana do testów przeciwstawnych np. testów walki. Komenda powinna zostać najpierw wywołana przez atakującego, następnie przez broniącego się przed atakiem. Komenda w skrócie to /f. Pierwszy test zwróci odpowiedź: @User(alias) attacks roll_result(SL amount) Waiting for opponent.... Drugi test zwróci @User(alias) defends rol_result(SL amount). Następnie bot zwróci: @Zwycięzca(Alias zwycięzcy) won by SL difference over @Pokonany(Alias pokonanego). Po wykonaniu testu przeciwstawnego będą dostępne dwa przyciski do przerzutu. Dla każdego uczestnika testu po jednym przycisku. Każdy test może być przerzucony dwukrotnie,. Argumenty:

  • skill_level - wartość testowana. Skill_level wspiera proste operacje matematyczne jak mnożenie, dodawani czy odejmowanie. Np. 2d20 + 20

  • alias - pozwala użytkownikowi nadać nazwę testowi, aby pomóc w rozróżnianiu wielu testów Alias zostanie wypisany po userze.

  • hidden - pozwala użytkownikowi ukryć wartość testu. Wynik testu w SL będzie jawny.

  • success_sl - poziomy sukcesu, które będą dodane jeśli test zostanie zdany.

  • additional_sl - poziomy sukcesu, które powinny zostać dodane lub odjęte od SL niezależnie od wyniku testu.

• mode - komenda służąca to zmiany sposob liczenia PS podczas /test i /fight. Domyślnie STANDARD. Argumenty:

  • mode - pozwala użytkownikowi wybrać sposób liczenia PS. Pozostawienie tego argumentu pustego zmieni sposób liczenia na kolejny,

• help - zwraca szczegółowe informacje na temat komend bota. Może zostać użyte bez parametrów, aby otrzymać krótkie opisy wszystkich dostępnych komend lub z parametrem, aby otrzymać szczegółowy opis jednej komendy. Argumenty:

  • command - komenda, której szczegółowy opis otrzyma wywołujący ją. Np. /help help