XAxee:

[[Category:Skript]]
'''GUI''' - graficzny interfejs użytkownika (ang. graphical user interface) oparty na ekwipunku (ang. inventory) gracza to osobne okienko, które można zaprogramować na swój sposób. Aby stworzyć własne GUI można pomóc sobie dodatkami np. [https://www.spigotmc.org/resources/skquery-1-9-1-14.36631/ SkQuery] lub [https://forums.skunity.com/resources/tuske-custom-enchantments-gui-manager-and-more.16/ TuSKe] albo skorzystać z samego Skripta.
[[Plik:GUI.png|alt=|brak|ramka|Skript umożliwia tworzenie dowolnych GUI]]

==Tworzenie GUI==
W celu stworzenia GUI trzeba zapisać [[Zdarzenia|zdarzenie]], [[Pętle|pętlę]] lub [[Komendy|komendę]] która wywoła otworzenie się GUI. Wyświetlanie ekwipunku: 
<code>open chest with <integer> rows named "<string>" to <player></code>

*<integer> to liczba rzędów w GUI (może ona być liczbą od 1 do X jednak musimy pamiętać że gui będzie sie zniekształcać przy większej ilości slotów)
*<string> - nazwa GUI
*<player> - gracz, któremu ma się owe GUI wyświetlić

W takim GUI gracz jest zdolny do manipulowania nim, oraz nie ma w nim nic, ponieważ należy zdefiniować to, co ma się w nim znaleźć oraz później dodać eventy, które wykonują kod po kliknięciu slota w inventory.

===Definiowanie slota===
<code>format slot <integer-1> of <player> with <integer-2> of <item> to <effect></code>

*<integer-1> definiuje, na jakim slocie ma zostać wstawiony podany później przedmiot. ''Uwaga: Slot '''0''' jest pierwszym slotem w ekwipunku, a nie 1''
*<player> - gracz, któremu ma się slot wyświetlić
*<integer-2> - liczba danego przedmiotu
*<item> - dany przedmiot/blok, np. ''diamond'', ''barrier'', ''bone''.
*<effect> - tutaj możliwe jest zdefiniowanie czterech efektów:
**'''be unstealable''' zapobiega 'kradzieży' przedmiotu, czyli nie można go wyjąć z GUI
**'''run "<command>" umożliwia wywołanie komendy'''
**'''close''' zamyka GUI
**'''close then run "<command>" zamyka i wywołuje komendę, która jest wykonywana przez konsolę.'''

Sposób pierwszy jest niepolecany ze względu, że nie jest rozbudowany oraz nie umożliwia wywołania wielu efektów na raz, dlatego poleca się

<pre>open chest with <integer> row named "<string>" to <player>
set <player>'s current inventory's slot <integer> to <integer-2> of <item> named "<string>"</pre>, gdzie

*<player> określa gracza
*<integer> jest liczbą całkowitą. W pierwszym przypadku może to być liczba od '''1''' do '''6''', w drugim zależnie od liczby rzędów od '''0''' do '''9*int-1''', w ostatnim od '''0''' do '''64'''
*<string> jest tekstem
*<item> jest przedmiotem w grze

Aby wywołać kod po kliknięciu przedmiotu należy napisać event <code>on inventory click:</code>
<pre>on inventory click:
if inventory name of current inventory of <player> is "<string>":
cancel event
if clicked slot is <integer>:
# kod 1
else if clicked slot is <integer>:
# kod 2</pre>

'''Skript''' sprawdza, czy ekwipunek jest nazwany <string>. Jeżeli ten [[Warunki|warunek]] się spełni, to wtedy skrypt anuluje ten event, przez co gracz nie może wyjąć przedmiotu. Następnie sprawdza, czy gracz nacisnął slot numer <integer>. Jeżeli tak, to zostaje wykonany kod 1.
Aby skuteczniej zabezpieczać serwer od takich przykrości powinno się dopisywać <code>wait <timespan></code>.

Opcje

2019-10-27T22:02:07Z

XAxee: /* Wykorzystanie */

'''Opcje''' służą do łatwego konfigurowania wartości używanych w skrypcie co dodatkowo pomaga w skracaniu kodu.

==Wykorzystanie==
<pre>options:
message1: "Test!"
message1: "Polecamy skript.pl"
message1: "Polecamy wiki.skript.pl"</pre>

Powyżej przykładowa sekcja <code>options</code> z trzema wiadomościami wykorzystanymi w skrypcie poniżej.

<pre>every 1 minute:
set {_x} to random integer between 1 and 3
if {_x} is 1:
broadcast {@message1}
else if {_x} is 2:
broadcast {@message2}
else if {_x} is 3:
broadcast {@message3}</pre>

Ten skrypt losuje liczbę od 1 do 3 co jedną minutę i zależnie od wylosowanej liczby ogłasza wiadomość. Daną opcję należy zapisać w klamrowych nawiasach '''{}''' i przed nazwą opcji wstawić znak małpy '''@'''.
Opcje mogą mieć postać wszystkich typów.

[[Kategoria:Skript]]

2019-08-30T19:38:27Z

XAxee: rozpis.

Skript posiada wbudowane funkcje, ale możemy też tworzyć swoje funkcje, które zwracają jakąś wartość albo takie, które nie zwracają żadnej wartości.
{| class="wikitable"
|+
Funkcja która coś zwraca
!
!
|-
!Wzór
|<code>Nazwa funkcji(Nazwa argumentu 1: Typ argumentu 1, Nazwa argumentu 2: Typ argumentu 2...) :: Typ zwracanej wartości:</code>

<code> kod...</code>

<code> return wartość</code>
|-
|'''Przykład'''
|<code>points(p: player) :: number:</code>
<code>return {points::%{_p}%}</code>
|}
{| class="wikitable"
|+Funkcja która tylko wykonuje kod.
!
!
|-
|'''Wzór'''
|<code>Nazwa funkcji(Nazwa argumentu 1: Typ argumentu 1, Nazwa argumentu 2: Typ argumentu 2...):</code>
<code>kod...</code>
|-
|'''Przykład'''
|<code>addPoints(p: player, n: number):</code>
<code>add {_n} to {points::%{_p}%}</code>
|}
Liste wbudowanych wszystkich funkcji znajdziecie [https://skriptlang.github.io/Skript/functions.html tutaj.]
{| class="wikitable"
|+'''Najprzydatniejsze wbudowane funkcje:'''
!Nazwa i argumenty
!Wydanie skripta
!Opis
!Przykłady / Zwracana wartość
|-
|location(x, y, z, "Nazwa świata"=event-world, yaw=0, pitch=0
|2.2
|Zwraca lokalizacje.
|teleport player to location(10, 50, 12)

set {_l} to location(10, 100, 52, "world", 90, 90)
|-
|floor(number)
|2.2
|Zwraca liczbe zaokrągloną w dół.
|floor(5.99) = 5
floor(3.12) = 3
|-
|max(numbers)
|2.2
|Zwraca największą z podanych liczb.
|max(1, 2, 3, 4, 5) = 5
max(0, 4, 6, 3, 2) = 6
|-
|min(numbers)
|2.2
|Zwraca najmniejszą z podanych liczb.
|min(0, 2, 5, 6, 6) = 0
min(9, 2, 5, 8, 4) = 2
|-
|product(numbers)
|2.2
|Zwraca iloczyn podanych liczb.
|product(1, 7, 2, 2) = 28
product(6, 3, 5, 6) = 540
|-
|round(number)
|2.2
|Zwraca zaokrąglona liczbe.
|round(3.54) = 4
round(3.21) = 3
|-
|sqrt(number)
|2.2
|Zwraca pierwiastek kwadratowy podanej liczby
|sqrt(4) = 2
sqrt(25) = 5

sqrt(2) = 1.4142
|-
|sum(numbers)
|2.2
|Zwraca sume podanych liczb.
|sum(1, 5, 6) = 12
sum(1, 1, 1) = 3
|-
|world(string)
|2.2
|Zwraca świat o podanej nazwie
|set {_flat} to world("flat")
set {_nether} to world("world_nether")
|-
|date(year, month, day, hour=0, minute=0, second=0)
|2.2
|Zwraca stworzoną date z podanych argumentów
|date(2014, 10, 1) # 0:00, 1st October 2014
|}

Funkcje

2019-08-30T18:18:30Z

XAxee: Utworzono nową stronę "funkcje."

funkcje.