Standard Skript Code Conventions r3

O co chodzi?
SSCC "Standard Skript Code Conventions" jest zestawem reguł pisania skryptów stworzonym przez destroyer'a4017.
Określa on styl kodowania, który zapewnia kompatybilność z innymi skryptami, łatwość utrzymania/modyfikowania kodu oraz sprawia, że skrypt jest prosty do odczytania.

Nazwy plików
Nazwy plików kończących się na ".sk" nie powinny zawierać następujących znaków:

• #
• `
• $
• %
• {
• }
• (spacji)


 

Jeśli w nazwie chcesz zawrzeć wersję skryptu powinna ona znaleźć się na końcu, za nazwą skryptu: skrewards-v1.2.3.sk

Nazwy zmiennych
Poniższe zasady odnoszą się tylko do zmiennych globalnych, nie do lokalnych (zaczynających się od _).

Nazwy zmiennych powinny być zapisane według konwencji camelCase, gdzie nie występują spacje oraz pierwsza litera każdego słowa (wyłączając pierwsze) zaczyna się z wielkiej litery.

Zmienne tworzone przez skrypt powinny być definiowane w sposób {<nazwa skryptu>::<nazwa zmiennej>}, co ułatwia usuwanie danych danego skryptu albo aktualizowanie zmiennych z wcześniejszej wersji skryptu, na przykład:

# Zamiast takiej zmiennej
{current.reward}
# Użyj następującego wzoru
{skrewards::currentReward}

Zmienne dynamiczne oraz listy powinny być stopniowane, co jest bardziej obiektowym podejściem i umożliwia zapętlanie danych.

# Zamiast takich zmiennych
{reward.level.modifier.1}
{reward.level.modifier.2}
{reward.level.modifier.3}
{rewardstatus.%player%}
{info.%player%.mined.diamonds}
{info.%player%.mined.emeralds}
# Użyj następujących wzorów
{skrewards::rewardLevelModifier::1}
{skrewards::rewardLevelModifier::2}
{skrewards::rewardLevelModifier:: 3}
{skrewards::rewardStatus::%player%}

{skrewards::info::%player%::minedDiamonds}
{skrewards::info::%player%::minedEmeralds}
# Lub
{skrewards::info::%player%::mined::diamonds}
{skrewards::info::%player%::mined::emeralds}

Jeśli piszesz API,  powinieneś wpisać dane do zarezerwowanych nazw zmiennych {<nazwa skryptu>::api::<output ID>}. Jeśli używasz skQuery, możesz zapisywać dane do tych zmiennych gdy podprogram/funkcja jest wykonywany/a. W zwykłym Skript powinieneś zdeklarować komendy możliwe do użycia tylko z konsoli, które wpisują dane do tych zmiennych. Schemat ten pozwala twórcom skryptów tworząc własny skrypt pozyskiwać informacje z innych. Jeśli Twój skrypt jest BIBLIOTEKĄ, której jedynym celem jest udostępnienie funkcji, należy wtedy pominąć fragment ::api i używać {<nazwa skryptu>::<output ID>}. Zmienne API powinny być usunięte zawsze gdy serwer jest wyłączany.

Porządkowanie kodu
Stworzony kod musi być uporządkowany w określony sposób. Nie powinieneś wpisywać zdarzeń i komend w losowej kolejności; muszą być czytelnie oddzielone. Każdy z elementów może być pominięty, o ile są one w odpowiedniej kolejności.

• script options (jeśli używasz skQuery)
• aliasy [aliases:]
• zmienne  [variables:]
• opcje  [options:]
• podprogramy/funkcje (jeśli używasz skQuery)
• nowe komendy  [command /komenda:]
• on script load:
• on script unload:
• okresowe zdarzenia (np. every 10 seconds, at 10:00)
• inne zdarzenia


 

Zdarzenia i Warunki
Zdarzenia zawsze powinny zaczynać się od słówka "on", mimo, że będą działać bez niego. Kiedy tylko to możliwe, powinieneś unikać używania selektorów w linii definiującej zdarzenie, np.:
 

on right click with porkchop:
on left click on tnt:
on damage of cow:

Należy uogólnić takie zdarzenia i skorzystać z warunków:

on right click:
    if tool of player is porkchop:
# dalszy kod
on left click:
    if clicked block is tnt:
# dalszy kod
on damage:
    if victim is a cow:
# dalszy kod

Stosując warunki, NIGDY nie powtórzysz tego samego zdarzenia kilka razy w jednym skrypcie.
 
Warunki powinny ZAWSZE zaczynać się od słówka "if" i kończyć dwukropkiem. NIGDY nie używaj warunków bez wprowadzenia dalszego kodu do ich wnętrza. To pozwoli twórcom skryptów w łatwy sposób dodać kod przed i po warunku albo dodać "else:".

# Zamiast
on damage:
    if victim is a player:
        {skrewards::info::%victim%::isInvincible} is true
        cancel event
        set {skrewards::info::%victim%::isInvincible} to false
# Użyj takich warunków
on damage:
    if victim is a player:
        if {skrewards::info::%victim%::isInvincible} is true:
            cancel event
            set {skrewards::info::%victim%::isInvincible} to false

Specyfikacja Lambdy
Lambdy są nową funkcją skQuery i mogą być używane we wszystkich wersjach powyżej 1.17.0. Pozwalają sporą ilość kodu skompresować do kilku linii. 
Lambdy, tak długo jak długo będą używane rozsądnie, będą spełniać wymagania SSCC. Lambdy mogą być brane pod uwagę jeśli:

• [*]Użyte są zamiast funkcji do wykonania POJEDYNCZEGO zadania [*]Użyte są do zaciemnienia kodu przez stworzenie bardzo skompresowanego kodu [*]Lepiej opisują ciąg zadań


 

- - -

Jeśli stosujesz się do tych zasad, umieść w publikacji swojego skryptu plakietkę: 
Kod z linkiem do oryginalnego tematu:

[url=http://dev.bukkit.org/bukkit-plugins/skript/forum/tutorials/69108/][img=https://i.imgur.com/BZ8lAno.png][/url] 

Kod z linkiem do tego tematu:

[url=http://skript.pl/index.php/topic/1877-][img=https://i.imgur.com/BZ8lAno.png][/url]

Źródło: http://dev.bukkit.org/bukkit-plugins/skript/forum/tutorials/69108