rTriggers

MotD, wskazówki, nekrologi, makra, personalizacja Wiadomości wyzwalane po logowaniu, rozłączeniu, timerach, poleceniach, śmierci i innych.

Spersonalizuj wiadomości za pomocą podstawień tagów.

Funkcje

• Wyzwalaj wiadomości lub polecenia po logowaniu, rozłączeniu, timerach, a także po śmierci gracza i użyciu poleceń.
• Zdecyduj dokładnie, kto może wyzwolić wiadomość, i kto ją dostaje. Wymień graczy indywidualnie lub według grupy (za pomocą Permissions).
• Podziały linii w obrębie wyrazów, kontynuacje kolorów (dzięki zmodyfikowanemu kodowi vMinecraft!)
• Spersonalizowane wiadomości w stylu wypełniania luk (wstaw tutaj imię wyzwalacza lub odbiorcy, IP itp.).

Format wiadomości

Przykładowy plik właściwości znajduje się w sekcji 4.0. rTriggers stworzy plik właściwości w plugins/rTriggers/rTriggers.properties, gdzie plugins znajduje się w folderze Twojego serwera.

Plik właściwości składa się z listy Twoich wiadomości. Każda wiadomość ma format podobny do następującego:

 triggerers=recipients:options:message

Wyzwalacze informują rTriggers, które grupy lub pseudo-grupy mogą wywołać tę wiadomość. Odbiorcy to ci, którzy rzeczywiście widzą wiadomość, gdy wyzwalacz ją uruchomi. Opcje określają, kiedy i w jaki sposób wyzwalacz może wywołać wiadomość (jak podczas logowania, śmierci czy użycia określonego polecenia). Sama wiadomość to właściwa treść, która zostanie wysłana.

Można określić wiele rzeczy w polach triggerers, recipients i options, używając przecinków (bez spacji). Co dane pole robi, opisano w sekcji poniżej.

Legenda

Jeżeli wokół czegoś znajdują się <<>>, musisz to uwzględnić! bold: nazwa opcji/grupy/czegokolwiek italics: Opcjonalna część tagu. Możesz ją pominąć (także pomiń znak | na początku). underlined: Zastąp to czymś (np. liczbą lub nazwą grupy). Konieczne, chyba że to jest kursywą.

Triggerers and Recipients

Wyzwalacze mówią rTriggers, kto może wywołać tę wiadomość. Odbiorcy informują, kto ją widzi, gdy wyzwalacz ją uruchomi. Pozostawienie pola odbiorców pustym spowoduje, że odbiorca będzie tym samym, co wyzwalacz. groupname: Członkowie tej grupy wyzwalają wiadomość (lub ją otrzymują, jeśli znajdują się w polu odbiorców).

• <<everyone>>: Wszyscy!
• <<hasperm|permissionnode>>: Osoby z podanym uprawnieniem wyzwalają/otrzymują tę wiadomość.
• <<player|playername>>: Zastąp 'playername' nazwą gracza, którego chcesz wyznaczyć jako wyzwalacz (lub odbiorca).
• <<command-triggerer>> i <<command-recipient>: Sprawia, że gracz użyje wiadomości tak, jakby była poleceniem.
• <<command-console>>: Sprawia, że serwerowa konsola użyje wiadomości tak, jakby była poleceniem.
• <<say-triggerer>> i <<say-triggerer>>: Sprawia, że gracz powie wiadomość.
• <<timer|interval>>: (Tylko wyzwalacz) Powtórzy tę wiadomość (zastąp 'interval' ile razy chcesz powtarzać wiadomość w sekundach). Używaj z listami, aby tworzyć wskazówki!
• <<t|minutes>>: Ta wiadomość będzie powtarzana co godzinę w tej minucie (<<t|30>> następuje o 1:30, 2:30, itp.)
• <<server>>: (Tylko odbiorca) Wiadomość jest wysyłana do serwera.
• <<triggerer>>: (Tylko odbiorca) Osoba, która wywołała wiadomość.
• <<twitter>>: (Odbiorca) Wysyła wiadomość na Twittera (Wymagane ServerEvents!!!)
• <<near-triggerer|dist>>: (Odbiorca) Wszyscy w odległości dist x dist od wyzwalacza dostają wiadomość. Zastąp 'distance' aktualnym obszarem.
• not|groupname and not|<<player|playername>> and not|<<triggerer>> and not|<<hasperm|permission>>: (Tylko odbiorca, z wyjątkiem hasperm) Działają jak wersje bez 'not|' z przodu, z tym wyjątkiem że zapewniają, iż wiadomość NIE zostanie wysłana do tej osoby/tych osób.
• <<craftirc|tagname>>: (Odbiorca) Zastąp 'tagname' nazwą taga, do którego CraftIRC ma wysłać wiadomość.

Opcje

Opcje mówią rTriggers, kiedy wiadomość powinna zostać wyzwolona i jak. Puste pole jest równoznaczne z użyciem opcji onlogin.

• onlogin|override - Wyzwala po zalogowaniu wyzwalacza. Nadpisanie zastępuje domyślną wiadomość pustą linią.
• ondisconnect|override - Wyzwala po wylogowaniu wyzwalacza. Nadpisanie zastępuje oryginalną wiadomość o rozłączeniu pustą linią.
• oncommand|commandname|override|number - Wyzwala, gdy wyzwalacz użyje określonej komendy. Nadpisanie nie pozwala, aby komenda przenosiła się do innych wtyczek (usuwa komunikaty „nieznane polecenie!”). Liczba określa liczbę wymaganych argumentów.
• onconsole działa jak zdarzenie oncommand, z tą różnicą, że nie można ich nadpisywać. Not yet, anyway.
• onload|pluginname - Za każdym razem, gdy w CraftBukkit załadowany zostanie wtyczka o nazwie pluginname. Używaj z <<customtrigger>> jako wyzwalaczem.
• onkick - Wyzwala, gdy wyzwalacz zostanie wyrzucony z serwera.
• ondeath|natural|deathcause - Wyzwala, gdy wyzwalacz umrze. Jeśli deathcause jest określona, wyzwolenie zajdzie tylko w tej przyczynie śmierci. Dozwolone przyczyny śmierci to: "contact", "entity_attack", "fall", "fire", "fire_tick", "lava", "drowning", "block_explosion", "entity_explosion", "suffocation", "custom", "lightning" i "something." Jeśli użyta zostanie opcja natural, nie zostanie wyzwolone, jeśli gracz zginął przez gracza lub od moba.
• ondeath|playerkill - Wyzwala, gdy wyzwalacz zostanie zabity przez innego gracza.
• delay|seconds - Sprawia, że wiadomość poczeka kilka sekund po wyzwoleniu, zanim nastąpi
• limit|seconds|pertrigger - Powoduje, że wiadomość nie wyzwala się szybciej niż określono. Jeśli określono pertrigger, ograniczenie dotyczy pojedynczego gracza, a nie wszystkich.

Wiadomości i znaczniki zastępcze

To jest to, co chcesz, aby rTriggers powiedział lub zrobił. Możesz dostosować to za pomocą znaczników zastępujących, które rTriggers znajdzie i zastąpi odpowiednimi informacjami. Oto lista znaczników zastępczych:

• <<triggerer>> - Imię osoby, która uruchomiła wiadomość (po zalogowaniu, wyrzuceniu itp).
• <<recipient>> - Imię osoby, do której wiadomość jest wysyłana (często może to być ten sam co triggerer).
• <<recipient-displayname>> i <<triggerer-displayname>> - Nazwa wyświetlana (w przeciwieństwie do surowej nazwy).
• <<player-list>> - Lista wszystkich graczy online.
• <<color>> - Zastąpione przez §. Następnie podaj numer w systemie szesnastkowym, aby uzyskać kolor! (0-9 lub A-F)
• <<triggerer-balance>> i <<recipient-balance>> - Stan konta gracza w iConomy.
• <<death-cause>> - (tylko ondeath!) Powód śmierci.
• <<killer>> - (tylko ondeath!) Sprawca (nazwa gracza, nazwa stworzenia itp.)
• <<kick-reason>> - (tylko onkick!) Powód wyrzucenia gracza. oncommand only!
• <<param#>> - Zastąp # numerem parametru, np. <<param1>>, itp. Zastąpione przez to, co gracz wpisuje w polecenie.
• <<param#+>> i <<param#->> - Zastąpione przez wszystkie parametry aż do danego numeru / zaczynające się od danego numeru.
• <<params>> - Zastąpione przez wszystkie parametry wprowadzone do polecenia
• <<list|listname|rand>> - Zastąpione przez element z listy o nazwie "listname". Jeśli podano rand, zostanie wybrany losowy element z listy. Jeśli nie, wybierze kolejny element z listy. Kolejność określana jest kolejnością w pliku.
• <<triggerer-ip>> i <<recipient-ip>> - Adres IP gracza.
• <<triggerer-locale>> i <<recipient-locale>> - Lokalizacja gracza.
• <<triggerer-country>> i <<recipient-country>> - Kraj gracza.
• <<time>>, <<hour>>, i <<minute>>: To, co pewnie myślisz, że robią.
• <<everyone>> i <<hasperm|permission>> wiadomość zostanie powtórzona raz dla każdego gracza online/posiadającego to uprawnienie, z tym zastąpieniem tagów
  • Możesz używać ich wielokrotnie w jednej wiadomości, i użyć różnych ich typów w jednej wiadomości.
  • Jeśli użyjesz tego samego tagu wiele razy, uruchomi się on tylko raz dla każdego gracza, do którego ma zastosowanie. Oznacza to, że jeśli ktoś wykona "/tell <> Hello there, <>!" to powie on wszystkim po imieniu, nie wyliczając każdemu gracza wszystkich graczy.
  • Jeśli użyjesz różnych tagów, przejdzie przez każdą prawidłową kombinację, która spełnia te tagi.

Format listy

Te wpisy trafiają do tego samego pliku co wiadomości.

<<list|Bob>>=This text goes in the 'Bob' list.
<<list|Bob>>=This is also in the 'Bob' list.
<<list|haha>>=This is in a separate list called  'haha'

Zastąp "listname" dowolną nazwą. Możesz tu użyć znaczników zastępczych, jeśli chcesz.

Jeśli użyjesz albo znacznika zastępczego <<list|listname|rand>> albo <<list|listname>> zostanie zastąpiony przez element z listy o nazwie "listname." Jeśli podano 'rand', element ten zostanie losowo wybrany z listy. Jeśli nie, zostanie wybrany kolejny element na liście. Kolejność określa kolejność dodawania go do pliku.

Przykład

#################
# MOTD Example:
# Basic MotD for humans group
humans=::§b Hey <<triggerer>>!@ Type /rules for a list of rules.

#  News that shows when players log in.
#  Also shows up when players type /news.
# Use $ to continue on the next line, and @ to insert a linebreak.
<<everyone>>=:onlogin,oncommand|/news|override:<<color>>b Here's our latest events:$
@Nothing at all, really!

# Tells anyone in the 'humans' or 'gods' group who's online when they log in.
humans,gods=::<<player-list>>

#Displays rules when people use the /rules command
<<everyone>>=<<triggerer>>:oncommand|/rules|override:1) Don't break things.$
@2) Have fun.$
@3) RESPECT MAH AUTHORATAH!

# Announces the login and disconnect of anyone in the 'gods' group to the server
gods=<<everyone>>:onlogin,ondisconnect:<<recipient>> pay heed, and hail <<triggerer>>, your god!

####################
# Tips/Timer Example

# This one does it sequentially
<<timer|300>>=<<everyone>>::<<list|TipList>>
# This version will pick a random tip
<<timer|300>>=<<everyone>>::<<list|Burn|rand>>

# Here are your tips
<<list|TipList>>=This tip comes first.
<<list|TipList>>=You see this tip 5 minutes (300 seconds) later.
<<list|TipList>>=This one comes 5 minutes after the one above!

# This timer makes the server use the backup command every 10 minutes!
<<timer|600>>=<<command-console>>::backup

##############
# Commands/Aliases example

# Will announce whenever someone /tps to someone.
<<everyone>>=<<everyone>>:oncommand|/tp:<<triggerer>> tp'd to <<param1>>!

#    Map multiple commands to one!
# /suitup <target>
# Gives the target player a full suit of iron armor and then teleports you to the target.
gods=<<command-triggerer>>:oncommand|/suitup:give <<param1>> ironchestplate 1$
@give <<param1>> ironpants 1$
@give <<param1>> ironboots 1$
@give <<param1>> ironhelmet 1$
@tp <<param1>>

##############
#Death Related stuff

# Will announce the weakness of a god when he or she dies.
god=<<everyone>>:ondeath:Even a god like <<triggerer>> can die...

# Will randomly select something in the list "Burn" whenever someone burns to death.
<<everyone>>=<<everyone>>:ondeath|fire:<<list|Burn|rand>>
<<list|Burn>>=Let it burn!  Just like <<triggerer>>.
<<list|Burn>>=Would you like your <<triggerer>> medium or well done?