Skript: Różnice pomiędzy wersjami

Z wiki.skript.pl
Przejdź do nawigacji Przejdź do wyszukiwania
m
 
(Nie pokazano 1 pośredniej wersji utworzonej przez tego samego użytkownika)
Linia 1: Linia 1:
−
'''Skript''' to plugin przeznaczony dla silników serwerowych opartych na Bukkicie. Wtyczka ta umożliwia tworzenie oraz uruchamianie różnorodnych instrukcji i czynności na odpowiednie zdarzenia, od kilkuset zdarzeń po wiele typów i wyrażeń. Plugin został napisany specjalnie dla użytkowników, którzy chcą dodawać coś autorskiego nie umiejąc Javy. Język Skript opiera się na podstawowym języku angielskim i jest prosty w użyciu.
+
'''Skript''' jest pluginem głównie przeznaczonym dla amatorskich administratorów serwerów, którzy mogą modyfikować swoje serwery bez posiadania znajomości języków programowania, m.in [https://pl.wikipedia.org/wiki/Java '''Java'''], [https://pl.wikipedia.org/wiki/Python '''Python'''] lub [https://pl.wikipedia.org/wiki/C++ '''C++'''], a dokładniej pisząc skrypty używając prostego języka angielskiego. Najbardziej podstawowym wymaganiem do użycia tej wtyczki jest silnik [https://www.spigotmc.org/ '''Spigot'''] i jego forki: [https://papermc.io/ '''PaperSpigot'''], [https://github.com/Spottedleaf/Tuinity '''Tuinity'''] itd.
  
−
==Dodatki==
+
Autorem pierwowzoru jest Njol, szwajcarski programista Java, natomiast obecnie używany i ciągle aktualizowany jest fork autorstwa ShaneBee i bensku. Najnowsze aktualizacje są publikowane [https://github.com/SkriptLang/Skript/releases tutaj].
−
Skript pozwala na tworzenie '''dodatków'''. Istnieje wiele wtyczek, które dodają bardzo dużo nowych wyrażeń, efektów, zdarzeń lub typów. Autorzy bardzo chętnie je tworzą i publikują. Oficjalną kategorię z dodatkami na naszej wiki możesz znaleźć [[:Kategoria:Dodatki|tutaj]].
 
  
−
==Skrypty==
+
== Dodatki ==
−
Aby stworzyć swój pierwszy skrypt, otwórz miejsce z plikami serwerowymi i zainstaluj wtyczkę [https://github.com/SkriptLang/Skript/releases Skript] w katalogu <code>plugin</code>. Po wgraniu wtyczki należy zrestartować serwer i sprawdzić czy plugin jest kompatybilny z wersją silnika serwera. Oprócz samego uruchamiania skryptów, Skript umożliwia nam manipulację między nimi oraz między samym pluginem poprzez komendy. Możemy uruchomić takie instrukcje jak:
+
Dodatki ''(ang. addony)'' dodają nowe składnie, które z kolei ułatwiają pracę i umożliwiają modyfikację wielu nowych aspektów serwera. Takich pluginów jest wiele, a jej niepełną listę znaleźć można [[:Kategoria:Dodatki|tutaj]].
  
−
*'''/skript help''' - wyświetla informacje o wtyczce i jej komendy.
+
== Początek ==
−
*'''/skript disable [all/nazwa]''' - pozwala na wyłączenie skryptu (wszystkich lub konkretnego).
+
Aby zacząć przygodę ze swoimi skryptami, wpierw zainstaluj najnowszy plik z [https://github.com/SkriptLang/Skript/releases tej strony], zależnie, czy skrypty testujesz na serwerze technicznym, lub chcesz z jego pomocą otworzyć publiczny serwer. Stabilna wersja pliku, czyli taka, która nie zawiera błędów jest oznaczona tagiem ''Latest Release''. Pobrany plik .jar wgraj do folderu <code>/plugins</code>, a następnie zrestartuj serwer. Po zrestartowaniu serwera we wcześniej wspomnianym katalogu powinien pojawić się folder <code>Skript</code>, w związku z tym w nim paczka plików. Nas, jako początkowych skrypterów powinien interesować katalog o nazwie <code>scripts</code>. W tym folderze pisze się i wgrywa swoje skrypty, czyli dokumenty tekstowe z rozszerzeniem '''.sk'''. Od administratorów wymaga się podstawowej wiedzy języka angielskiego i umiejętności korzystania z dokumentacji.
−
*'''/skript enable [all/nazwa]''' - pozwala na włączenie skryptu (wszystkich lub konkretnego).
 
−
*'''/skript update''' - sprawdza wersję Skripta.
 
−
*'''/skript reload [all/nazwa]''' - pozwala ponownie wczytać skrypt (lub wszystkie skrypty), więc można je tworzyć podczas gry na bieżąco i co chwilę sprawdzać ich działanie.
 
  
−
Aby napisać swój pierwszy skrypt powinieneś otworzyć dowolny edytor tekstu ''(np. Windowsowy notatnik, Sublime Text, Brackets'' bądź ''Notepad++)''.
+
== Dokumentacja i inne strony ==
 +
Dokumentacje opisują wszystkie zdarzenia, efekty, wyrażenia i warunki zawarte w teoretycznie każdym dodatku, w tym samego Skript'a w sposób przejrzysty dla każdego użytkownika, m.in. jak to u siebie zaimplementować, jakich dodatków się wymaga i również jest parę przykładów użycia.
 +
 
 +
* [https://docs.skunity.com/ skUnity Documentation]
 +
* [https://skripthub.net/docs/ SkriptHub Documentation]
 +
* [https://parser.skunity.com/ skUnity Parser] – internetowy edytor tekstowy, który sprawdza prawidłowość napisanego kodu, liczy ilość komend, funkcji i zmiennych.
 +
 
 +
== Komendy ==
 +
 
 +
*''/skript help'' - komendy i informacje o pluginie.
 +
*''/skript disable [all/nazwa]'' - wyłączenie poszczególnych/wszystkich skryptów.
 +
*''/skript enable [all/nazwa]'' - włączenie poszczególnych/wszystkich skryptów.
 +
*''/skript update'' - sprawdza, czy wersja Skripta jest najnowsza.
 +
*''/skript reload [all/nazwa]'' - Wczytywanie skryptów komendą. Ułatwia to manipulację i szybkie edytowanie skryptów.
 +
 
 +
== Konfiguracja ==
 +
Konfiguracja wtyczki Skript pozwala na modyfikację pluginem. Przykładowe wartości, które można zmienić według swoich potrzeb, to
 +
 
 +
'''enable effect commands''' - domyślna wartość: '''false''', wartość: '''boolean''', opis: wszystkie wiadomości wprowadzone na serwerze z prefiksem '!' zostaną zinterpretowane jako efekty i zostaną wykonane. Nierozsądni gracze mogą nadużyć komend i uszkodzić serwer/świat, np. <code>!create explosion of force 10000</code> spowoduje crash serwera i nieodwracalne zmiany na świecie spowodowane olbrzymią eksplozją.
 +
Przykłady użycia komend:
 +
<pre>
 +
!heal player - leczenie gracza
 +
!feed player - najedzenie gracza
 +
!broadcast "&4Ogłoszenie" - wysyłanie wiadomości o podanej treści do każdego gracza i konsoli
 +
!set time to 6:00 - komenda domyślnie jest wykonywana w świecie gracza, w tym przypadku czas na świecie zmieni się na godzinę 6:00</pre><br>
 +
'''allow ops to use effect commands''' - domyślna wartość: '''false''', wartość: '''boolean''', opis: czy operatorzy mają dostęp do używania komend podanych wyżej. Jeśli wartość wynosi ''false'' jedynie gracze z permisją <code>skript.effectcommands</code> mogliby wykonać te czynności.<br>
 +
'''date format''' - domyślna wartość: '''default''', wartość: '''tekst''', opis: W pliku konfiguracyjnym zakomentowano sposób zmieniania tej wartości. ''date format'' używa się później w ekspresji <code>now</code>. Dla przykładu: <code>dd/MM/yyyy</code> pokaże 24.12.2020. Więcej informacji można znaleźć [http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html tutaj].
  
 
==Pisanie skryptu==
 
==Pisanie skryptu==
Linia 25: Linia 47:
 
*[[Zmienne]]
 
*[[Zmienne]]
  
−
Te artykuły dokładnie opisują podstawowe elementy tego języka. Pierwszym skryptem może być np. komenda.
+
== Błędy ==
−
 
+
Podczas wczytywaniu skryptu może wystąpić błąd, który zostanie wyświetlony na czacie. Najczęściej, błędy wynikają z błędu w kodzie, niezainstalowanego dodatku, lub niekompatybilnej wersji.
−
===Komendy===
 
−
Komendy to instrukcje wykonywane przez dowolnego adresata wypisującego w polu chatu określony łańcuch znaków poprzedzony znakiem "/" (w Minecrafcie).<pre>command /hello:
 
−
    permission: sk.hello
 
−
    permission message: Nie masz uprawnień!
 
−
    aliases: /hi
 
−
    trigger:
 
−
        send "Hello world!" to player</pre>
 
−
Po krótce:
 
−
 
 
−
*'''command /hello''' opisuje budowę komendy. Po wpisaniu komendy "hello" ma się wykonać poniższy kod.
 
−
*'''permission: sk.hello"''' jest opcjonalne, ale Skript sprawdza, czy gracz posiada uprawnienia.
 
−
*'''permission message: Nie masz uprawnień!''' opisuje wiadomość, która się pojawi graczowi na czacie, jeżeli <u>nie posiada on</u> określonych uprawnień.
 
−
*'''aliases: /hi''' - w tym przypadku dodajemy komende zastępczą /hi.
 
−
*'''trigger:''' ten operator jest wymagany przy pisaniu każdej komendy. Trigger opisuje, co ma zrobić gra po wpisaniu komendy.
 
−
*'''send "Hello world!" to player''' - ''send'' jest operacją, która określa instrukcję wysyłania wiadomości. "Hello world!" jest przykładowym łańcuchem znaków - w tym miejscu powinniśmy napisać wiadomość, którą chcemy wysłać dla danego odbiorcy. ''to player'' natomiast oznacza, że wiadomość ma być wysłana do nas. W późniejszym czasie, po większym rozeznaniu się z wtyczką poznacie więcej [[typy|typów]] odbiorców wiadomości.
 
−
 
 
−
Podsumowując:
 
−
<pre><komenda/periodical/zdarzenie>:
 
−
    <effect>:
 
−
        <kod></pre>
 
−
 
 
−
''(Periodical jest jedną z [[pętle|pętli]].)''
 
−
 
 
−
===Zdarzenia===
 
−
Zdarzenia to kod wywoływany podczas wykonanej czynności. Czynnością takową może być na przykład rozpoczęcie jedzenia bądź zadanie obrażenia. W Skripcie wyróżniamy wiele zdarzeń (Wszystkie można znaleźć [[Zdarzenia|tutaj]]).
 
−
 
 
−
<pre>on mine of stone:
 
−
    if player's tool is diamond pickaxe of unbreaking 10 named "Kilof Mocy" with lore "Linia 1","Linia 2","Linia 3":
 
−
        chance of 15%:
 
−
            drop 1 nether star of unbreaking 10 named "&cGwiazda Piekła" at event-block</pre>
 
−
 
 
−
*'''on mine of stone''' uruchamia instrukcje wskazane poniżej podczas, gdy gracz zacznie kopać kamień.
 
−
*'''if player's tool is diamond pickaxe''' sprawdza, czy narzędziem w ręce gracza jest diamentowy kilof.
 
−
*'''of unbreaking 10''' sprawdza, czy ten kilof ma Niezniszczalność X (w miejscu ''unbreaking 10'' można wpisać wszystkie [[typy]] zaklęć).
 
−
*'''named "Kilof Mocy" with lore "Linia 1","Linia 2","Linia 3"''' sprawdza, czy kilof jest nazwany ''Kilof Mocy'' i czy ma on opis (lore). Tutaj można dodać wiele linijek, wystarczy że po pierwszej "linii" opisu dopiszemy przecinek. Cudzysłowiem rozpoczynamy drugą linię.
 
−
*'''chance of 15%''' {{Main|Losowość}}
 
−
*'''drop 1 nether star''' nakazuje wyrzucić jedną gwiazdę netheru (ang. ''nether star'').
 
−
*'''event-block''' - miejsce zdarzenia (miejsce wykopanego kamienia). W zdarzeniach można używać terminów event-() aby określić miejsce zdarzenia. np. <code>on death of cow: drop 1 of milk bucket at event-entity</code>
 
−
 
 
−
==Wgrywanie skryptu==
 
−
Napisany skrypt należy zapisać w rozszerzeniu .sk i wgrać do folderu <code>Skript/scripts</code>, który znajduje się w katalogu <code>plugins</code>katalogu naszego serwera. Przykładowe skrypty można usunąć, ale warto się również z nich nauczyć pewnych [[efekt]]ów lub wyrażeń.
 
−
 
 
−
Wchodząc do gry wpisujemy komendę /sk reload <nazwa skryptu>, która umożliwi nam przeładowanie naszego skryptu.
 
−
 
 
−
==[https://skript.pl/temat/2594-jak-rozumieć-błędy/ Jak rozumieć błędy?]==
 
−
 
 
−
Aby pierw zrozumieć błędy, należy ze zrozumieniem przeczytać wyswietlony przez plugin Skript błąd. Plugin zawsze podaje, w jakiej linii kodu wystąpił błąd, więc należy się tam udać i wyszukać źle napisany fragment skryptu.
 
−
Dodatkowo trzeba się upewnić, czy poprawnie efekt/wyrażenie/zdarzenie zostało zapisane. Poniższy przykład ilustruje mnogość zapisanych warunków, które odegrają taką samą instrukcję.
 
−
 
 
−
<pre>on step over dirt:
 
−
on step on dirt:
 
−
on steping on dirt:
 
−
on steping over dirt:
 
−
step over dirt:
 
−
step on dirt:
 
−
steping over dirt:
 
−
steping on dirt:
 
−
on walk over dirt:
 
−
on walk on dirt:
 
−
on walking on dirt:
 
−
on walking over dirt:
 
−
walk over dirt:
 
−
walk on dirt:
 
−
walking over dirt:
 
−
walking on dirt:</pre>
 
−
Jednym z cięższych błędów do naprawienia jest błąd rozpoczynający się frazą <code>can't understand this condition/effect</code>. Wynika to z tego faktu, że jak sam Skript nam mówi, <u>nie rozumie</u> efektu/warunku w danej linii. Przed wyszukaniem fragmentu kodu z błędem warto pierw sprawdzić, czy w katalogu <code>plugins</code> posiadamy odpowiedni dodatek, do którego próbujemy się odwołać. Jeżeli posiadamy odpowiedni addon w naszym katalogu - należy sprawdzić, czy jest on kompatybilny z wersją serwera. Jeżeli mimo wszystko uważamy, że dodatek posiada wersję wspierającą naszą edycję silnika, należy upewnić się, czy nasz serwer odpowiednio wczytał addon komendą <code>/plugins</code> na serwerze.
 
  
 
<center>'''Najczęstsze błędy'''</center>
 
<center>'''Najczęstsze błędy'''</center>

Aktualna wersja na dzień 12:12, 26 sie 2020

Skript jest pluginem głównie przeznaczonym dla amatorskich administratorów serwerów, którzy mogą modyfikować swoje serwery bez posiadania znajomości języków programowania, m.in Java, Python lub C++, a dokładniej pisząc skrypty używając prostego języka angielskiego. Najbardziej podstawowym wymaganiem do użycia tej wtyczki jest silnik Spigot i jego forki: PaperSpigot, Tuinity itd.

Autorem pierwowzoru jest Njol, szwajcarski programista Java, natomiast obecnie używany i ciągle aktualizowany jest fork autorstwa ShaneBee i bensku. Najnowsze aktualizacje są publikowane tutaj.

Dodatki

Dodatki (ang. addony) dodają nowe składnie, które z kolei ułatwiają pracę i umożliwiają modyfikację wielu nowych aspektów serwera. Takich pluginów jest wiele, a jej niepełną listę znaleźć można tutaj.

Początek

Aby zacząć przygodę ze swoimi skryptami, wpierw zainstaluj najnowszy plik z tej strony, zależnie, czy skrypty testujesz na serwerze technicznym, lub chcesz z jego pomocą otworzyć publiczny serwer. Stabilna wersja pliku, czyli taka, która nie zawiera błędów jest oznaczona tagiem Latest Release. Pobrany plik .jar wgraj do folderu /plugins, a następnie zrestartuj serwer. Po zrestartowaniu serwera we wcześniej wspomnianym katalogu powinien pojawić się folder Skript, w związku z tym w nim paczka plików. Nas, jako początkowych skrypterów powinien interesować katalog o nazwie scripts. W tym folderze pisze się i wgrywa swoje skrypty, czyli dokumenty tekstowe z rozszerzeniem .sk. Od administratorów wymaga się podstawowej wiedzy języka angielskiego i umiejętności korzystania z dokumentacji.

Dokumentacja i inne strony

Dokumentacje opisują wszystkie zdarzenia, efekty, wyrażenia i warunki zawarte w teoretycznie każdym dodatku, w tym samego Skript'a w sposób przejrzysty dla każdego użytkownika, m.in. jak to u siebie zaimplementować, jakich dodatków się wymaga i również jest parę przykładów użycia.

Komendy

  • /skript help - komendy i informacje o pluginie.
  • /skript disable [all/nazwa] - wyłączenie poszczególnych/wszystkich skryptów.
  • /skript enable [all/nazwa] - włączenie poszczególnych/wszystkich skryptów.
  • /skript update - sprawdza, czy wersja Skripta jest najnowsza.
  • /skript reload [all/nazwa] - Wczytywanie skryptów komendą. Ułatwia to manipulację i szybkie edytowanie skryptów.

Konfiguracja

Konfiguracja wtyczki Skript pozwala na modyfikację pluginem. Przykładowe wartości, które można zmienić według swoich potrzeb, to

enable effect commands - domyślna wartość: false, wartość: boolean, opis: wszystkie wiadomości wprowadzone na serwerze z prefiksem '!' zostaną zinterpretowane jako efekty i zostaną wykonane. Nierozsądni gracze mogą nadużyć komend i uszkodzić serwer/świat, np. !create explosion of force 10000 spowoduje crash serwera i nieodwracalne zmiany na świecie spowodowane olbrzymią eksplozją. Przykłady użycia komend: 

!heal player - leczenie gracza
!feed player - najedzenie gracza
!broadcast "&4Ogłoszenie" - wysyłanie wiadomości o podanej treści do każdego gracza i konsoli
!set time to 6:00 - komenda domyślnie jest wykonywana w świecie gracza, w tym przypadku czas na świecie zmieni się na godzinę 6:00


allow ops to use effect commands - domyślna wartość: false, wartość: boolean, opis: czy operatorzy mają dostęp do używania komend podanych wyżej. Jeśli wartość wynosi false jedynie gracze z permisją skript.effectcommands mogliby wykonać te czynności.
date format - domyślna wartość: default, wartość: tekst, opis: W pliku konfiguracyjnym zakomentowano sposób zmieniania tej wartości. date format używa się później w ekspresji now. Dla przykładu: dd/MM/yyyy pokaże 24.12.2020. Więcej informacji można znaleźć tutaj.

Pisanie skryptu

Przed napisaniem skryptu zapoznaj się z tematami, takimi jak:

Błędy

Podczas wczytywaniu skryptu może wystąpić błąd, który zostanie wyświetlony na czacie. Najczęściej, błędy wynikają z błędu w kodzie, niezainstalowanego dodatku, lub niekompatybilnej wersji.

Najczęstsze błędy
Błąd Opis i wyjaśnienie
can't understand this condition/effect Skript nie może zrozumieć warunku/efektu. Warto zobaczyć, czy posiadamy dodatek bądź czy fragment kodu jest poprawny.
indentation error Błąd z wcięciami w kodzie. Wcięcia są bardzo ważne w pluginie Skript - podczas wczytywania kodu Skript sprawdza każde wcięcie.
invalid use of quotes Złe użycie cudzysłowia. W tekstach ważne jest prawidłowe ich użycie. Aby Skript wziął cudzysłów za tekst należy go wpisać dwukrotnie - "" #To jest tekst!
the percent sign is used for expressions (e.g. %player%). To insert a '%' type it twice: %% Procenty w tekście. Aby były wzięte za tekst należy je wstawić dwa razy. Tak samo jak z cudzysłowiem.
can't understand expression Skript nie rozumie wyrażenia.

Jeżeli naprawdę Skript cię wycieńcza z błędami - koniecznie odwiedź nasze forum.

Źródło: „https://wiki.skript.pl/index.php?title=Skript&oldid=532”