Basic Syntax_kr - TriggerReactor/TriggerReactor GitHub Wiki

ℹ️ | 트리거리액터를 최신 버전으로 유지하세요. 이 문서에 기술된 내용 중 일부는 버전에 따라 작동하지 않을 수도 있으며, 이에 대한 기능 지원을 받을 수 없습니다.

이 문서에서는 트리거리액터만의 기본적인 구문 작성에 대한 몇 가지 특성을 설명합니다. 트리거리액터는 /trg run <스크립트> 라는 명령어가 존재합니다. 이 명령어를 사용하면 스크립트 파일을 따로 작성하지 않아도 <스크립트> 부분이 어떻게 인게임에서 동작하는지 확인할 수 있습니다.

예를 들어 /trg run #MESSAGE "안녕하세요" 명령어를 사용하면 채팅창에 안녕하세요가 출력되게 됩니다. 아래 서술할 문법 예제들은 예시 구문이 동봉되어 있으니 /trg run 명령어로 직접 실행하면서 학습하시는 것을 추천드립니다. 예제의 대부분은 #MESSAGE 실행자를 사용하므로 배우는데 큰 어려움은 없을 것입니다.

만약 궁금한 점이 있거나 이해가 되지 않는 부분이 있다면, 공식 디스코드 서버에 참가해 기술 지원을 받을 수도 있습니다.

트리거리액터에서 코드는 왼쪽에서 오른쪽으로 읽은 다음, 위에서 아래로 읽습니다.

#MESSAGE "안녕하세요!"

이 코드는 안녕하세요!를 출력합니다.

코드에서 오류 없이 완전하게 실행할 수 있는 부분을 **구문(Statement)**이라고 부릅니다. 구문은 세미콜론(;)이나 새로운 줄(엔터)로 구분할 수 있습니다. 예를 들어 극단적인 예시이지만 아래는 오류 없이 완벽하게 동작합니다:

#MESSAGE "안녕"; #MESSAGE "안녕2"
#MESSAGE "안녕3"

이 코드는 3개의 구문으로 구성되어 있으며, 안녕, 안녕2 및 안녕3을 출력합니다.

만약 위의 예시에서 첫 번째 줄에 세미콜론이 없다면 어떤 일이 일어날까요? 한 번 첫 번째 줄에서 세미콜론을 제거해 봅시다!

#MESSAGE "안녕" #MESSAGE "안녕2"

트리거리액터는 이 줄을 하나의 구문으로 처리하려고 시도할 것이고, 오류가 발생합니다. 왜냐하면 MESSAGE 실행자가 이 구문을 어떻게 처리해야할 지 모르게 때문입니다. MESSAGE와 같은 실행자들은 인자(Argument)를 콤마(,)로 구분해야 하고, 또 인자로 다른 실행자를 값으로 두는 경우를 허용하지 않습니다. 따라서 트리거리액터는 위 구문을 해석할 수 없게 되어 이후 구문을 실행하는 대신 오류를 출력하고 실행을 중지합니다.

이번엔 이 오류를 적절하게 해결해 봅시다. 다음 두 가지 중 하나를 사용해 구문을 나누어 트리거리액터가 올바르게 처리할 수 있도록 할 수 있습니다:

// 세미콜론(;)을 사용하는 경우
#MESSAGE "안녕"; #MESSAGE "안녕2"

// 새로운 줄(엔터)을 사용하는 경우
#MESSAGE "안녕"
#MESSAGE "안녕2"

앞에 제시된 예시에서 설명을 할 때 앞에 //가 있는 라인을 볼 수 있는데, 이같이 코드 진행에 영향을 주지 않고 단지 코드를 열람할 수 있는 사람이 해당 부분의 기능을 이해하거나 전달해야 할 내용이 있을 때, 코드 안에 메모처럼 입력해 놓는 것을 주석이라고 합니다. 예를 들어,

#MESSAGE "&c&l당신은 충분한 돈을 가지고 있지 않습니다" // 빨간색, 굵은 글씨로 처리했으므로 유저의 눈에 띌 것이다.

위 구문에서는 한 줄의 주석이 포함되어 있습니다. 실행 가능한 코드가 포함되어 있더라도 현재 라인의 끝까지 '//'(주석) 기호 이후로 있는 텍스트는 무시됩니다.

한 줄의 텍스트로 부족한 큰 주석을 필요로 할 경우, 다음과 같은 다중 라인 주석을 사용할 수도 있습니다.

/**
 * Grief Protection v0.3
 *
 * 이 구문의 소유권은 ABC에게 있습니다.
 * 구성 옵션을 보려면, /gpconfig 명령어를 확인하세요.
 *
 * @example
 * ```trg
 * IMPORT io.github.wysohn.triggerreactor.example.griefprotection.GriefProtectionConstants AS GPConstants
 * #MESSAGE GPConstants.VERSION // GP 버전 출력
 * ```
 *
 * @author TriggerReactor
 * @license Apache-2.0 OR CC-BY-4.0
 * @since 2022-09-25
 */

여러 줄의 내용도 다중 라인 주석(/......./)이 있으므로 내용에 실행 코드를 가지고 있다고 하더라도 무시됩니다.

알고 계시겠지만, 트리거리액터는 마인크래프트 플러그인 중 하나이기 때문에 Java를 기반으로 만들어져 있습니다. 우리가 주로 Java에서 사용하는 자료형으로는 문자열, 정수, 실수, 불 대수가 있으며, 트리거리액터도 이를 똑같이 사용합니다. 차이점으로는, Java는 자료형을 필수적으로 작성해야 하지만 트리거리액터는 스스로 타입을 추론해주기 때문에 자료형을 작성할 필요가 없습니다. 심지어 자료형을 작성하려고 하면 오류가 발생할 겁니다!

문자열은 가나다라와 같이 4자 가, 나, 다, 라; 즉 각각의 문자를 하나로 연결해 놓은 하나의 값 타입입니다. 따라서 한 문자가 아닌 절, 구와 같은 다중의 문자가 포함된 메시지를 사용자에게 보내려면 문자열 타입을 주로 사용해야 합니다.

간단합니다. 문자열 타입의 값으로 정의할 문장의 시작과 끝에 " (쌍따옴표)을 붙이면, 그 사이에 있는 문장을 문자열로 정의할 수 있습니다.

예를 들어 반갑습니다, 여러분.이라는 문장을 문자열 타입으로 정의하려면, 문장의 시작과 끝에 " (쌍따옴표)를 붙임으로써 문자열로 정의할 수 있습니다:

"반갑습니다, 여러분."

하지만 이 코드처럼 문자열만으로는 오류가 발생할 것입니다. 어디에 문자열을 보내야할 지 트리거리액터는 모르기 때문이죠! 한 번 문자열 값을 갖는 변수를 정의해보도록 합시다:

일반적으로 +(더하기 기호)는 '무엇인가를 추가한다'를 의미합니다. 즉, 문자열 + 문자열 은 두 문자열을 붙인다는 의미로도 해석될 수 있습니다. 이러한 특성을 이용해 문자열 값을 갖는 변수와 일반적인 문자열 값을 합쳐 하나의 문자열로 표현할 수 있습니다. 한 번 예제를 통해 확인해 볼까요?

#MESSAGE "주목! " + $playername + "님이 두둥등장했어요!"

이 코드는 주목! Sayakie님이 두둥등장했어요!라고 출력할 것입니다. 여기서 $playername은 트리거를 실행한 플레이어의 닉네임을 반환하는 자리표시자입니다. 그렇다면 이 트리거를 실행한 플레이어의 닉네임이 Sayakie이겠군요!

그렇지만 이렇게 표현하면 나중에 코드를 읽거나 리뷰할 때 어려움이 있을 수 있습니다. 트리거리액터는 이러한 문제점을 해결하기 위해 문자열 안에서 자리표시자를 정의할 수 있도록 했습니다!

ℹ️ 참고 | 문자열 내 자리표시자 사용은 v3.2 버전 이후에서만 작동합니다.

#MESSAGE "주목! $playername님이 두둥등장했어요!"

어때요? 한결 더 보기 쉬워졌네요!

만약 쌍따옴표(")를 문자열 정의 표시가 아닌 단지 문자열 내에서 사용할 문자로서 사용하고 싶다면, 쌍따옴표 바로 앞에 \\를 붙여 이스케이프시킬 수 있습니다.

예를 들어, 만약 you can "do" that 을 출력하고 싶다면,

#MESSAGE "you can \"do\" this"

위와 같이 입력할 수 있습니다.

또한 문자열 내에서 \n 을 사용함으로써 띄어쓰기를 구현할 수 있습니다.

#MESSAGE "3번 테이블에\n봉골레 파스타 하나"

또한 \\를 이스케이프 문자가 아닌 일반적인 문자로 사용하고 싶다면 \\\\라고 입력해야 합니다. (앞의 \가 뒤의 \를 이스케이프 시킴으로써 \가 됩니다.)

#MESSAGE "C:\\\\users"

프로그래밍에서, 정수 라는 건 양수, 음수 또는 0(표현 범위: -2,147,483,648 ~ 2,147,438,647)을 표현하는 대표적인 타입입니다. 이를 통해 1 + 1 = 2와 같은 값을 통한 계산이 가능해집니다. 이러한 정수를 선언하는 방법은 정말 간단합니다.

그냥 있는 그대로 넣으세요.

int = 1

A = 22
str = "제 나이는 "
#MESSAGE str + A

위 구문은 제 나이는 22 라고 출력할 것입니다.

문자열 정의에서 말씀드린 바와 같이, 트리거 리액터의 + 는 더한다 라는 뜻을 가집니다. 즉 두 값이 더해지면서, +를 기준으로 왼쪽 또는 오른쪽에 위치한 값이 문자열 타입인 경우, 문자열 타입이 아닌 값은 자동으로 문자열 타입으로 변환된 후, 기존 문자열과 병합됩니다.

먼저 'IMPORT java.lang.String'을 통해 String클래스를 import해야 합니다. 그런 다음 String.valueOf(int)를 사용하여 int값을 String으로 변환해줄 수 있습니다. 다음에서 제시되는 코드는 꽤나 복잡해보일 수도 있지만, 이해하면 간단합니다.

IMPORT java.lang.String
A = 22
str = "저의 나이는 "
strA = String.valueOf(A)
#MESSAGE str + strA

위 구문이 실행되면 "저의 나이는 22" 라는 문장이 출력될 것 입니다. 이는 valueOf() 메소드는 String클래스의 정적(static)메소드로 인자값으로 제공된 정수, 실수 등을 문자열 값으로 정의되도록 만듭니다.

불 대수 타입은 이진, 즉** 0과 1또는 참과 거짓을 논하는 타입**입니다.

예제:

bool = false
IF bool == false
    #MESSAGE "반가워"
ELSE
    #MESSAGE "잘가"
ENDIF

제시된 구문은 반가워라고 출력할 것입니다, bool false 값을 가진 불 대수 타입의 변수로 정의되었기 때문입니다.