ReActions

ReActions

ReActions wprowadza system przetwarzania niestandardowych zdarzeń. Pozwala na sprawdzanie określonych warunków i wykonywanie określonych działań. Jeśli wymagane warunki nie będą spełnione, zostaną wykonane inne działania.

Czym jest ReActions

ReActions to narzędzie, które pozwala dodawać nowe funkcje do przedmiotów, przycisków i... zdarzeń. Możesz dodawać nowe akcje, które występują po kliknięciu przycisku lub otwarciu skrzyni. Możesz zmienić stan dźwigni lub teleportować gracza do innej lokalizacji. Możesz sprawdzić, czy gracz znajduje się w regionie i dać mu przedmiot z zaklęciem jako nagrodę za zabicie bossa. Och tak! Możesz także przywołać bossa-moba... ReActions może współdziałać z wtyczkami zewnętrznymi (Vault, Factions, Towny, itp...) aby wprowadzić możliwość niestandardowego wykorzystania ich możliwości lub dać ci bardziej elastyczne i w pełni konfigurowalne ustawienia gracza. Na przykład, możesz naliczyć opłatę za wejście na terytorium lub za otwieranie skrzyni albo za pociąganie dźwigni. Możesz wykonać pewne akcje, gdy gracz zmienia frakcję (dostarczone przez wtyczkę Factions) lub zmusić gracza do dołączenia do miasta (wtyczka Towny).

A także nie musisz uczyć się języka skryptowego. Zajmuje to tylko kilka minut, aby zrozumieć zasadę działania ReActions, a potem ogranicza Cię już tylko Twoja wyobraźnia.

Instrukcje

Szczegółowe instrukcje dostępne tutaj: reactions.fromgate.me

Instrukcja rosyjska (Instrukcja na rosyjskim) jest tutaj: reactions.fromgate.ru

Wersje deweloperskie

Najnowsze wersje deweloperskie dostępne na

• CircleCI 

Pobierz najnowszą wersję

Terminologia

Aby lepiej zrozumieć opis, wyjaśnijmy terminologię:

Subscription - powiązanie aktywatora z dowolnym zdarzeniem w grze (otrzymanie obrażeń, naciśnięcie przycisku, założenie pancerza, kliknięcie prawym przyciskiem myszy z określonym przedmiotem w ręce). Zatem, jeśli aktywator jest subskrybowany na dane zdarzenie, zostaje wywołany po jego wystąpieniu.

Activator - zestaw "zdarzenie-warunek-działanie". Czyli aktywator jest wywoływany przez konkretne zdarzenie (którym jest subskrybowane), sprawdza pewne warunki (flagi) i wykonuje pewne akcje.

Flaga - warunek do sprawdzenia.

Akcja - co powoduje aktywator po sprawdzeniu flag. Akcje są dwóch typów:

• Akcja - wykonywana po pomyślnym zweryfikowaniu flag;
• Reakcja - wykonywana po nieudanej weryfikacji flag (przynajmniej jedna flaga zwróciła false).

Placeholders - użyj ich do określania dynamicznie obliczanych wartości.

Funkcje

• Możliwość sprawdzania wielu warunków (flagi): uprawnienia (lub grupy uprawnień), saldo gracza lub zdefiniowany przedmiot w ekwipunku, itd.
• Wykonywanie różnych akcji: możesz nałożyć efekt eliksiru na gracza, teleportować gracza do wskazanych lokalizacji, wykonywać polecenia wtyczki zewnętrznej, itp.
• Podpinanie aktywatora do pewnego rodzaju zdarzeń: kliknięcie przycisku lub stanie na płytce, wchodzenie lub opuszczanie regionów WorldGuard.
• Wbudowany harmonogram (Timers) który może łączyć aktywator z czasem serwera (może być powtarzany lub jednorazowy) lub z czasem w grze.
• Wsparcie MySQL (za pomocą ReActions możesz uzyskać dostęp do danych Twojego serwera WWW lub dowolnej aplikacji i wtyczek)
• Tworzenie inventory-menu (GUI) i łączenie aktywatorów z slotami wirtualnego ekwipunku.

Co mogę tworzyć za pomocą ReActions?

Oto kilka przykładów zastosowania ReActions, które spotykam na niektórych serwerach:

• System teleportacji, który może pobierać pieniądze lub przedmioty i zależy od uprawnień gracza oraz czasu w grze. Na przykład teleportacja tylko w ciągu dnia, za pomocą jednego bloku diamentu jako zapłaty.
• Prosty sklep administracyjny, który sprzedaje przedmioty. Na przykład możesz sprzedać cały zestaw zbroi diamentowej jednym kliknięciem myszy.
• Obszary radioaktywne - gracz otrzymuje obrażenia w obrębie tej strefy i przez pewien czas po opuszczeniu tej regionu.
• Mosty i bramy.
• Tworzenie własnych poleceń (w tym w twoim rodzimym języku) bez potrzeby instalowania zewnętrznych wtyczek.
• Tworzenie dodatkowych sposobów rozwiązywania questów lub labiryntów. Na przykład gracz z mieczem diamentowym w ręku zostanie teleportowany do specjalnego miejsca, a gracz bez miecza diamentowego trafi do innego miejsca.
• Wykonywanie poleceń wtyczek stron trzecich zapewni mnóstwo zabawy.
• Znam serwer z pewnego rodzaju grą strategiczną. Gracze tam nie mogą budować, ale są regiony, w których gracze mogą kupować budynki dostarczające zasobów (budynki tworzone komendą wtyczki ScLoad, wykonywaną przy użyciu ReActions).
• Tworzenie broni i jetpacków.

Przykłady wideo

Nie ma jeszcze wideo, które pokazywałoby wszystkie funkcje ReActions. Stworzę je, jak tylko będę mógł. Istnieją jednak filmy, które demonstrują niektóre funkcje ReActions:

1. Jak latać po kliknięciu prawym przyciskiem myszy na przedmiot

2. pokazuje dwa typy aktywatorów: rgenter i rgleave, oraz takie funkcje jak efekty eliksirów:

Instrukcje wideo

Możesz zobaczyć kilka tutoriali demonstrujących, jak używać ReActions tutaj.

Dlaczego ReActions?

Czasami dostaję pytanie: dlaczego powinienem używać ReActions zamiast któregokolwiek pluginu skryptowego, który można znaleźć na BukkitDev. Mogę powiedzieć kilka słów na ten temat. Jeśli opanowałeś jakiś język skryptowy dla któregokolwiek pluginu skryptowego, nie mogę Cię namawiać do zmiany. Większość pluginów skryptowych pozwala na te same rzeczy co ReActions. Ale są pewne cechy, na których chciałbym się skupić:

• ReActions jest naprawdę łatwy do rozpoczęcia. Po utworzeniu pierwszego aktywatora będziesz wiedzieć wszystko o tym, jak ReActions działa.
• Staram się, aby ReActions było bliższe użytkownikowi niż deweloperowi: wbudowane zdarzenia Bukkit zwykle nie są odzwierciedlone w ReActions. Na przykład ReActions zawiera aktywator REGION_ENTER zamiast odzwierciedlenia PlayerMoveEvent, gdzie autor skryptu musi sprawdzać regiony wokół gracza.
• Staram się ponownie, aby ReActions było bliższe właścicielowi serwera i planuję dodać obsługę najpopularniejszych wtyczek. Obecnie obsługiwane: WorldGuard, Vault, Craftconomy3, Factions, Towny, PlayEffect i RacesAndClasses.
• Możesz tworzyć aktywatory za pomocą poleceń wtyczki lub ręcznie edytując pliki konfiguracyjne (to jeszcze łatwiejsze).
• ReActions to nie język skryptowy. I użytkownicy dziękują mi za ten fakt, co jest głównym powodem, dla którego kontynuuję prace nad tym.

Polecenia

<param> - wymagany parametr.

[param] – opcjonalny parametr.

[param:<value>] – opcjonalny parametr, w którym, jeśli użyty, upewnij się, że podasz wartość.

[v1 | v2 | v3] – opcjonalny parametr, który zostanie podmieniony na jedną z tych trzech wartości.

Główne polecenie wtyczki to "/react". Alias: /rea, /ra.

• /react help - Ktoś potrzebuje pomocy!..
• /react add <ActivatorType> <ActrName> [Param] - Tworzy nowy aktywator, który subskrybuje zdarzenie określonego typu. Lista typów aktywatorów.
• /react add loc <LocName> - Zapisuje Twoją aktualną pozycję jako nazwaną lokalizację do późniejszego wykorzystania (na przykład do teleportacji).
• /react add <ActrName> f <Flaga> <Param> - Dodaje określony warunek do aktywatora. Lista flag.
• /react add <ActrName> a <Akcja> <Param> - Dodaje akcję do aktywatora (wykonuje się, jeśli wszystkie warunki zwróciły true). Wszystkie akcje są wykonywane w tej samej kolejności, w jakiej zostały dodane. Lista akcji.
• /react add <ActrName> r <Reakcja> <Param> - Dodaje reakcję do aktywatora (wykonuje się, jeśli co najmniej jedna weryfikacja zwróciła false). Wszystkie reakcje są wykonywane w tej samej kolejności, w jakiej zostały dodane. Lista reakcji.
• /react copy [flag | actions | reactions] <SrcActr> <DestActr> - Kopiuje flagi, akcje lub reakcje z <SrcActr> do <DestActr>. Uwaga: jeśli pomijasz opcjonalny parametr (flag|actions|reactions), skopiuje wszystkie.
• /react list [loc | group | type] [Page] - Wyświetla listę lokalizacji, grup lub typów. Uwaga: jeśli pomijasz opcjonalny parametr, wyświetlona zostanie lista wszystkich.
• /react info <ActrName> [f | a | r] - Wyświetla informacje o flagach, akcjach lub reakcjach aktywatora. Uwaga: jeśli pominiesz opcjonalny parametr, wyświetlone zostaną pełne informacje o aktywatorze.
• /react group <ActrName> <GroupName> - Zmienia grupę aktywatora na podaną. Uwaga: jeśli podana grupa nie istnieje, zostanie utworzona.
• /react remove <loc|activator> <ActrName|LocName> - Usuwa aktywator lub lokalizację.
• /react remove <ActrName> <f | a | r> <num> - Usuwa z aktywatora flagę, akcję lub reakcję o podanym numerze. Uwaga: numery można zobaczyć, używając polecenia /react info <ActrName> [f | a | r].
• /react clear <ActrName> <f | a | r> - Usuwa wszystkie flagi, akcje lub reakcje z aktywatora.
• /react debug <true|false|off> - Włącza/wyłącza tryb debug. Tutaj: true – wszystkie testy zwracają true; false – wszystkie testy zwracają false; off - wyłącza tryb debug.
• /react check [radius] - Wyświetla wszystkie zlokalizowane geolokalnie aktywatory w podanym promieniu. Uwaga: jeśli pomijasz opcjonalny parametr, promień ma domyślną wartość – 8 metrów (bloków).
• /react reload - Przeładowuje wtyczkę (wtyczka ponownie odczyta wszystkie pliki tekstowe).

Uprawnienia

• reactions.config - pozwala na tworzenie i konfigurowanie aktywatorów oraz lokalizacji.
• reactions.debug - umożliwia użycie trybu debug.

Więcej informacji o poleceniach i uprawnieniach tutaj

Interakcja z wtyczkami stron trzecich

ReActions jest zgodny z kilkoma innymi wtyczkami. Możesz swobodnie używać (lub nie) dowolnej z tych wtyczek.

• Vault — zarządzanie grupami i ekonomią.
• WorldGuard — wymagany do korzystania z aktywatorów regionów.
• Towny — możesz zmieniać/sprawdzać miasto gracza (Uwaga! Towny znajduje się na zewnętrznej stronie internetowej i nie jest zatwierdzony przez zespół Bukkit. Używaj na własne ryzyko).
• Factions — możesz rejestrować zmiany relacji frakcji, zmieniać frakcję gracza.
• RacesAndClasses — możesz zmieniać/sprawdzać klasę i rasę gracza.
• PlayEffect — możesz odtwarzać efekty cząsteczek.
• Craftconomy3 — zaawansowane funkcje ekonomii, obsługa wielu walut.

bStats i sprawdzanie aktualizacji

ReActions zawiera dwie funkcje, które wykorzystują połączenie z Internetem serwera. Pierwsza to Metrics, które służy do zbierania informacji o wtyczce (wersje wtyczki, Java itp.) Druga to checker aktualizacji, który sprawdza nowe wydania ReActions po uruchomieniu wtyczki i co pół godziny. Ta funkcja korzysta z API udostępnianego przez dev.bukkit.org. Jeśli nie podoba Ci się ta funkcja, możesz ją łatwo wyłączyć. Aby wyłączyć checker aktualizacji, ustaw parametr "version-check" na "false" w pliku config.yml. Aby uzyskać więcej informacji o bStats i dowiedzieć się, jak go wyłączyć, przeczytaj tutaj.

Podoba Ci się ten plugin?

Możesz wesprzeć wydanie przyszłych wersji!