VotifierScripts

VotifierScripts to wtyczka nasłuchuje głosów z Votifier i umożliwia uruchamianie kodu JavaScript gdy głos zostanie odebrany (otwierając nieskończone możliwości!) Ten JavaScript został wzmocniony potęgą buscript, który daje dostęp do wielu funkcji globalnych, aby zapewnić łatwe w użyciu doświadczenie skryptowe. Nie wymaga doświadczenia w programowaniu, ale w takim przypadku możesz uznać tę wtyczkę za trudniejszą w użyciu niż większość.

Ta wtyczka wymaga Votifier, ale już zawiera w pakiecie buscript.

Najnowsze buildy deweloperskie zawsze można znaleźć na http://ci.onarandombox.com/job/VotifierScripts/

Polecenia

Obecnie dostępne jest tylko jedno polecenie

  /vstest <player> [service [address [timestamp]]]

To polecenie testuje skrypt, który uruchamiany jest po otrzymaniu głosu.

Uprawnienie: votifierscripts.test

<player> jest używany do wskazania celu dla twojego skryptu. Ogólnie rzecz biorąc, powinien to być ktoś online, jeśli zamierzasz z niego korzystać.

Polecenie testowe będzie zawsze ponownie ładować plik vote-script.txt, więc nie ma potrzeby robienia nic specjalnego, jeśli modyfikujesz skrypt.

Pozostałe trzy argumenty są opcjonalne, ale każdy z nich wymaga użycia poprzedniego, więc aby użyć znacznik czasu musisz podać wszystkie cztery. Pomoże to dokładniej przetestować skrypt głosowy.

Skrypty

Skrypty to pliki tekstowe zawierające kod JavaScript. Może to brzmieć przerażająco dla osób nieznających programowania, ale na szczęście VotifierScripts oferuje kilka łatwych w użyciu metod tworzenia podstawowych skryptów.

Główny skrypt wywoływany, gdy Votifier otrzymuje głos, znajduje się w plugins/VotifierScripts/vote-script.txt. Zauważysz, że skrypt ten początkowo zawiera prosty wbudowany przykład. Śmiało go zmodyfikuj!

Wszystkie skrypty, które uruchamia główny skrypt, muszą znajdować się w plugin/VotifierScripts/scripts i mogą mieć dowolną nazwę lub rozszerzenie pliku.

Funkcje skryptów

• Łatwe w użyciu funkcje globalne, w tym uruchamianie poleceń, nadawanie wiadomości, zarządzanie uprawnieniami i więcej.
• Każdy łańcuch znaków używany w tych funkcjach globalnych ma dostęp do "%target%" który reprezentuje aktualny cel skryptu. Przykład: broadcast("Hello, %target%")
• Możliwość uruchamiania innego skryptu w późniejszym czasie z 100% niezawodnością, nawet jeśli serwer ulegnie awarii!
• Definiuje globalną zmienną target więc można wykonywać bardziej zaawansowane rzeczy na celu skryptu.
• Globalna zmienna server jest również dostępna, co daje bezpośredni dostęp do zmiennej serwera Bukkit tak, jakbyś pracował(a) z poziomu wtyczki!
  
  

Szczegółowe funkcje skryptów

Globalne funkcje i zmienne

Dodatkowe Globalne funkcje i zmienne specyficzne dla VotifierScripts

Przykładowe skrypty

Prosty przykład rozgłaszania/komendy

vote-script.txt

  broadcast("Hej wszystkim, %target% to fajny gość!")
  command("op %target%")

To prosty skrypt, który wszystkim na serwerze mówi, kim jest cel (w tym przypadku dumptruckman) — fajny gość — a następnie nadaje mu uprawnienie operatora.

Przykład czasowego uprawnienia

vote-script.txt

  message("%target%", "You have just been given flight in the creative world for 30 minutes!")
  addPerm("creative", "%target%", "flight.permission")
  runLater("remove-perm.txt", "30m", "%target%")

Uwaga te dwa skrypty wymagają Vault oraz kompatybilnego z Vault menedżera uprawnień, który pozwala im działać nawet gdy gracz nie jest online.

Możliwe jest również użycie funkcji command() do uruchamiania własnych poleceń uprawnień bez używania Vault.

Również uwaga "flight.permission" nie jest prawdziwym uprawnieniem. Twoje faktyczne uprawnienie umożliwiające latanie może się różnić (lub w ogóle nie istnieć!).

Kliknij tutaj po więcej przykładowych skryptów

Kliknij tutaj po żądania skryptów

Dla deweloperów

Kod źródłowy: https://github.com/dumptruckman/VotifierScripts
Repozytorium Maven: http://repo.onarandombox.com/content/groups/public/
Informacje pom Maven:

  <groupId>com.dumptruckman.minecraft</groupId>
  <artifactId>votifierscripts</artifactId>
  <version>1.0-SNAPSHOT</version>

Możesz dodać własną funkcjonalność do skryptów, jeśli sobie to życzysz. Oto jak podłączyć się do VotifierScripts:

  Plugin plugin = Bukkit.getPluginManager().getPlugin("VotifierScripts");
  if (plugin != null) {
    Buscript buscript = ((VotifierScripts) plugin).getScriptAPI();
    // Do stuff with buscript object, see documentation below
  }

Więcej informacji o bibliotekach buscript znajdziesz na: http://dev.bukkit.org/server-mods/buscript/