Skript/스크립트 작성 도움말/작성 (덤프버전으로 되돌리기)

[[분류:마인크래프트/플러그인/Skript]]
[include(틀:상위 문서, top1=Skript/스크립트 작성 도움말)]
[include(틀:마인크래프트/관련 문서)]
[목차]
== 개요 ==
마인크래프트 [[Skript]] 작성 방법에 대한 문서이다.

== 작성 방법 ==

#(주석)은 뒤에 붙이는 모든 말들을 프로그램에 영향을 끼치지 않게 해 준다.
주석은 코드를 더 쉽게 이해할 수 있게 해주며 협업을 할때 유용하게 사용된다.

예제:
{{{command /kill [<offlineplayer>]:
    trigger:
        kill arg-1 #해당 글과 같이 적힌 것은 프로그램에 아무런 영향을 주지 않는다.
        broadcast "&f%arg-1%님이 관리자에 의해 사망하였습니다." }}}
이벤트 또는 조건문 등등 뒤에 : 가 붙을 경우 다음 줄을 시작할때 탭 또는 스페이스 4번 을 눌러줘야 한다.
한 스크립트에서 탭 또는 스페이스를 같이 사용할 수 없다.

indentation error: expected 2 tabs, but found '->____' [-> = tab, _ = space, ? = other whitespace]
탭 하고 스페이스를 같이 사용하게 되면 위와 같은 에러메시지를 볼 수 있다.

예제:
{{{command /spawn:
    trigger:
        if player is op:
            teleport {loc.spawn} to player
            send "&c스폰으로 이동합니다."
        else:
            send "&c권한이 부족해 명령어를 사용할 수 없습니다."}}}
'''여기서 {loc.spawn}는 변수이므로 해당 명령어를 사용할 거라면 따로 이 변수에 위치값을 넣어 주는 구문을 만들어서 넣어 줘야 한다.'''
{loc.spawn}에 위치값을 넣어 주는 구문은 아래와 같다.

예제:
{{{command /setspawn:
    trigger:
        if player is op:
            set {loc.spawn} to player's location
            send "&c스폰 위치가 새롭게 갱신됐습니다."
        else:
            send "&c권한이 부족해 명령어를 사용할 수 없습니다."}}}
== 작성 환경 ==
[[메모장]]같이 일반적인 텍스트 편집기를 사용해도 되지만 부가적인 기능이 들어있는 텍스트 편집기를 사용하게 되면 작업 능률을 높일 수 있다.

[[Sublime Text]], [[Atom(에디터)|Atom]], [[Notepad++]], [[Visual Studio Code]] 정도가 많이 사용된다.

== 구문 작성 ==
만들고 싶은 구문에 따른 예제와 설명이 있는 문서다. '''자신의 마음대로 응용해 보기 전에 먼저 예제를 따라서 써 적용해 본 후 응용해 보는 걸 추천한다.'''

=== 커맨드 ===
스크립트에서 가장 기초적인 구문이자 스크립트를 배우거나 할 때 가장 먼저 접하게 되는 '기본'이다.

예제:
{{{command /command:
    trigger:}}}
'''command'''와 '''trigger'''는 한 세트라고 볼 수 있다. '''trigger:''' 구문이 없다면 커맨드 구문이 작동하지 않는다.

위 예제와 같이 작성할 경우 '''/command''' 명령어를 입력했을 때 구문이 작동되도록 할 수 있다.

=== 텍스트 출력 ===
인게임 채팅창으로 텍스트를 출력하는 기능이다.[* 색상도 입힐 수 있다.]

'''send'''와 '''message'''로 출력할 수 있다.[* 차이는 없으므로 편한 걸 쓰면 된다.]

예제:
{{{command /text:
    trigger:
        send "Hello."}}}
위 예제처럼 구문을 작성하고 적용하면 '''/text''' 명령어를 쳤을 때 '''Hello.'''라는 텍스트가 출력되는 걸 볼 수 있을 것이다. 텍스트 출력은 주로 시스템 메시지로 많이 쓰인다.

예제:
{{{command /pl:
    trigger:
        if player is not op:
            send "[System] 권한이 없습니다."
            exit}}}
해당 예제를 적용시킬 경우 오피 권한이 없는 플레이어는 '''/pl''' 명령어를 입력 시 '''권한이 없다'''는 메시지가 뜨며 플러그인 목록을 확인할 수 없게 된다.

여기서 '''if player is not op'''는 '''플레이어가 오피 권한을 갖고 있는가?'''를 감지하는 구문이며, '''exit'''는 저 메시지를 출력한 뒤 플러그인 목록이 출력되지 않도록 구문을 강제 종료하는 기능이라고 보면 된다.

'''if'''에 대해서는 후술.

=== if / else ===
뒤에 어떤 조건이 오느냐에 따라 정말 광활하게 쓰이는 구문. '''만약''' 이라는 뜻을 가진 영문과 같이 '''뒤에 오는 조건을 만족하냐 만족하지 못하느냐를 감지한다.'''

else는 '''아니라면'''이라는 뜻을 가졌다. '''위에서 사용된 if문과 반대의 상황이라면'''이라고 생각하면 편하다.
else를 사용하려면 같은 세로줄에 무조건 한 번은 if문이 쓰여야 하며, 이때 쓰인 else는 해당 if문과 반대의 상황일 때 구문이 작동되도록 한다.
텍스트로만 보면 이해하기 어려우니 아래 예제들을 보며 익혀 보자.

예제:
{{{command /text:
    trigger:
        if player is op:
            send "당신은 오피입니다."
        else:
            send "당신은 오피가 아닙니다."}}}
구문을 이렇게 작성할 경우 '''/text''' 명령어를 쳤을 때, 그 사람이 오피라면 '''당신은 오피입니다.'''라는 텍스트가, 오피가 아니라면 '''당신은 오피가 아닙니다.'''라는 텍스트가 뜰 것이다.

'''if player is op.''' 영어에 대해 문외한이 아닌 한 대충 해석할 수 있을 것이다. '''만약 플레이어가 오피라면?'''이라는 조건이다.

즉
{{{if player is op:
    send "당신은 오피입니다."}}}
이 구문을 해석하면, '''만약 플레이어가 오피라면 "당신은 오피입니다."라는 텍스트를 출력한다.'''라고 볼 수 있다.

'''else'''는 앞서 말했듯이 간단한 뜻을 가졌다. '''아니라면'''이라는 조건이다.

앞서 쓰인 조건이 '''만약 플레이어가 오피라면'''이므로, 후에 쓰인 '''else'''는 '''아니라면'''. 즉, '''플레이어가 오피가 아니라면'''이라는 뜻을 갖게 된다.

{{{if player is op:
    send "당신은 오피입니다."
else:
    send "당신은 오피가 아닙니다.}}}
'''만약 플레이어가 오피라면 "당신은 오피입니다."라는 텍스트를 출력한다. 아니라면(플레이어가 오피가 아니라면), "당신은 오피가 아닙니다."라는 텍스트를 출력한다.'''

if 뒤에 올 수 있는 조건은 정말 많다. '''player is op(플레이어가 오피인가)''', '''gamemode of player is survival(플레이어의 게임모드가 서바이벌 상태인가)''', '''player has 1 of diamond(플레이어가 1개의 다이아몬드를 보유하고 있는가)'''등과 같이 플레이어의 상태를 감지하는 조건부터 시작하여, '''{A} is 3(A라는 이름의 변숫값이 3인가)''', '''{A} > 5(A라는 이름의 변숫값이 5보다 큰가)''' 등 변수와도 많이 쓰인다. 변수의 자세한 쓰임은 후술.

마지막으로 조금 심화된 예제를 하나 만들어 보겠다. 이해를 위해 각주가 없는 버전과 있는 버전 둘 다 제시하겠다.

예제(각주X):
{{{command /trade:
    trigger:
        if gamemode of player is survival:
            if player has 1 of diamond:
                remove 1 of diamond from inventory of player
                give 10 of iron to player
                send "거래 완료."
            else:
                send "&c다이아몬드를 갖고 있지 않습니다."
        else:
            send "&c게임모드가 서바이벌이 아닙니다."}}}
예제(각주O)
{{{command /trade: #/trade라는 명령어를 입력했을 때.
    trigger:
        if gamemode of player is survival: #만약 플레이어의 게임모드가 서바이벌이라면
            if player has 1 of diamond: #만약 다이아몬드 1개를 보유하고 있다면
                remove 1 of diamond from inventory of player #플레이어의 인벤토리로부터 다이아몬드 1개를 없앤다.
                give 10 of iron to player #플레이어에게 철괴 10개를 지급한다.
                send "거래 완료." #텍스트를 출력한다.
            else: #아니라면(다이아몬드를 보유하고 있지 않다면)
                send "&c다이아몬드를 갖고 있지 않습니다." #텍스트를 출력한다.
        else: #아니라면 (플레이어의 게임모드가 서바이벌이 아니라면)
            send "&c게임모드가 서바이벌이 아닙니다." #텍스트를 출력한다.}}}

해당 예제와 같이 구문을 작성한다면,
/trade 명령어를 통해 '''다이아몬드를 보유하고 있는 서바이벌 모드의 유저만 철괴로 교환이 되도록'''할 수 있다.
해당 예제에서 쓰인 다른 구문들은 후술.

여담으로 구문을 보다 간편화하기 위해 '''else if''' 구문을 사용할 수 있다. 해당 예제와 같이 if문이 여러 번 쓰였을 경우 유용한 구문이다.[* 특히 해당 예제처럼 계단식으로 돼 있는 구문이 보기 힘든 사람들에게 애용된다.]

'''else if''' 구문을 사용하여 위 예제를 보다 간편하게 바꿔보자.
예제:
{{{command /trade:
    trigger:
        if gamemode of player is not survival:
            send "&c게임모드가 서바이벌이 아닙니다.
        else if player has not 1 of diamond:
            send "&c다이아몬드를 갖고 있지 않습니다."
        else:
            remove 1 of diamond from inventory of player
            give 10 of iron to player
            send "거래 완료."}}}
보다시피 '''else if'''는 구문을 보다 간결하게 만들어 준다.
다만 '''else if'''로 구문을 간결하게 줄이려면 구문을 조금 수정해야 할 필요가 있다. 예를 들어 위 예제에서도 원래는 '''만약 플레이어가 서바이벌 모드라면'''을 감지했던 '''if gamemode of player is survival''' 구문이 '''만약 플레이어가 서바이벌 모드가 아니라면'''을 감지하는 '''if gamemode of player is [not] survival'''로 바뀌었다. 아래 다이아몬드 보유 여부를 감지하는 '''has''' 역시 '''has [not]'''으로 바뀐 걸 볼 수 있다.
Skript/스크립트 작성 도움말/작성 (덤프버전으로 되돌리기)

캡챠
