Skript: Różnice pomiędzy wersjami

Z wiki.skript.pl
Przejdź do nawigacji Przejdź do wyszukiwania
(Znaczniki: Z internetu mobilnego, Z wersji mobilnej www, VisualEditor)
m
 
(Nie pokazano 11 wersji utworzonych przez 5 użytkowników)
Linia 1: Linia 1:
−
'''Skript''' jest pluginem dla silników opartych o Bukkit API. Ta wtyczka pozwala graczom na tworzenie różnorodnych rzeczy i zdarzeń, od kilkuset zdarzeń po wiele typów i wyrażeń. Plugin został napisany specjalnie dla graczy, którzy chcą dodawać coś autorskiego nie umiejąc Javy. Język Skripta 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].
−
Dla Skripta można tworzyć '''dodatki'''. Istnieje wiele dodatków, które dodają bardzo dużo nowych wyrażeń, efektów, zdarzeń lub typów. Autorzy bardzo chętnie je tworzą i publikują.
 
  
−
{{Main|Kategoria:Dodatki}}
+
== 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 [[:Kategoria:Dodatki|tutaj]].
  
−
==Skrypty==
+
== Początek ==
−
Aby stworzyć swój pierwszy skrypt, otwórz klienta FTP i zainstaluj wtyczkę [https://github.com/SkriptLang Skript] (najnowsze wersje). Po wgraniu wtyczki należy zrestartować serwer, i sprawdzić czy plugin jest kompatybilny z serwerem. Kiedy wszystko działa, to:
+
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 help''' - informacje o wtyczce i komendy
+
== Dokumentacja i inne strony ==
−
*'''/skript disable''' - pozwala na wyłączenie skryptów/określonego
+
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.
−
*'''/skript enable''' - włączanie skryptów/konkretnego
 
−
*'''/skript update''' - sprawdza wersję Skripta.
 
−
*'''/skript reload''' - jest to najważniejsza z komend, która odświeża skrypt, więc można je tworzyć podczas grania na bieżąco i co chwilę sprawdzać jego działanie.
 
  
−
Aby napisać swój pierwszy skrypt powinienieś otworzyć dowolny edytor tekstu ''(np. Windowsowy notatnik)'' lub ''Notepad++''.
+
* [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==
−
Przed napisaniem skryptu zapoznaj się z:
+
Przed napisaniem skryptu zapoznaj się z tematami, takimi jak:
  
 
*[[Zdarzenia]]
 
*[[Zdarzenia]]
Linia 27: Linia 47:
 
*[[Zmienne]]
 
*[[Zmienne]]
  
−
Te artykuły dokładnie opisują podstawowe elementy tego języka.
+
== Błędy ==
−
Pierwszym skryptem może być np. komenda.
+
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.
−
<pre>command /hello:
 
−
    permission: sk.hello
 
−
    permission message: Nie masz permisji!
 
−
    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.
+
<center>'''Najczęstsze błędy'''</center>
−
*'''permission: sk.hello"''' jest opcjonalne, ale Skript sprawdza, czy gracz posiada permisję (potrzebny '''PermissionsEx'''
+
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
−
*'''permission message: Nie masz permisji!''' opisuje wiadomość, która się pojawi graczowi na czacie, jeżeli <u>nie posiada on</u> permisji.
+
!Błąd
−
*'''aliases: /hi''' - w tym przypadku można dodatkowo wpisać ''/hi'' i się wykona komenda ''/hello''.
+
!Opis i wyjaśnienie
−
*'''trigger:''' tutaj jest potrzebne, jak do każdej innej komendy. Trigger opisuje, co ma zrobić gra po wpisaniu komendy.
+
|-
−
*'''send "Hello world!" to player''' - send: wysyła, "Hello world!" jest stringiem, tekstem, w cudzysłowiu, można wstawić tu dowolną wartość, natomiast ''to player'' oznacza, że wiadomość ma być wysłana do nas. Jak później bardziej poznacie wtyczkę to się okaże, że można wstawiać w miejsce ''player'' różne [[typy]].
+
|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 [[tekst]]ach ważne jest prawidłowe ich użycie. Aby Skript wziął cudzysłów za tekst należy go wpisać dwukrotnie - <code>"" #To jest tekst!</code>
 +
|-
 +
|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.
 +
|}
  
−
To była komenda. Podsumowując:
+
Jeżeli naprawdę Skript cię wycieńcza z błędami - koniecznie odwiedź nasze [https://skript.pl/ forum].
−
<pre><komenda/periodical/zdarzenie>:
 
−
    <effect>:
 
−
        <kod></pre>
 
  
−
(Periodical jest jedną z [[pętle|pętel]].)
+
[[Kategoria:Skript]]

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”