공통 시나리오 조회
공통 시나리오 조회는 시나리오 텍스트, 명령 매개변수, 조건 판정 안에서 게임 데이터를 임시로 가져올 때 사용합니다. 조회는 숫자나 텍스트를 반환할 수 있으며, 게임은 해당 부분을 실행할 때 먼저 조회 명령을 결과로 치환한 뒤 뒤의 텍스트나 명령을 계속 처리합니다.
일반적인 용도는 다음과 같습니다.
- 대화에 플레이어의 금전, 장소 이름, 캐릭터 이름을 표시합니다.
IF,SELECT같은 조건에서 수치가 요구 조건을 만족하는지 판단합니다.- 한 조회 결과를 뒤 명령에 전달합니다. 예를 들어 캐릭터 ID를 먼저 조회한 뒤 그 ID로 캐릭터 이름을 조회할 수 있습니다.
기본 형식
“기본 형식” 섹션새 문서에서는 $ 형식을 우선 사용합니다.
[$QUERY:매개변수1:매개변수2$]이전 문서의 % 형식도 계속 호환됩니다.
[%QUERY:매개변수1:매개변수2%]두 형식의 의미는 같고 감싸는 기호만 다릅니다. 조회 안의 콜론 :은 매개변수를 나눕니다. $, :, [, ], &, | 같은 기호는 영어 반각 기호를 사용하세요.
자리표시자 읽기
“자리표시자 읽기” 섹션색인의 사용법에는 대문자 자리표시자가 나옵니다. 그대로 복사하는 고정 텍스트가 아니라 무엇을 채워야 하는지 알려 주는 표기입니다.
QUERY:player_money,tagrole같은 조회 이름.INFO또는 필드명:name,level,campid같은 조회 대상 정보.ID: 캐릭터 ID, 장소 ID, 퀘스트 ID 같은 설정 또는 런타임 오브젝트 ID.INDEX: 0부터 시작하는 번호.TAG_KEY: 설정표의 사용자 지정 TAG 필드명.VAR_ID: 사용자 지정 변수 ID.SUBARG:SET_SUBARG로 미리 저장한 임시 치환 결과.
예시:
[$player_money$][$tagrole:name$][$tagrole:name:ROLE_ID$][$tagrole:tag=TAG_KEY$]첫 줄은 플레이어 금전을 직접 조회합니다. 둘째 줄은 현재 시나리오 문맥의 대상 캐릭터 이름을 조회합니다. 셋째 줄은 지정 캐릭터를 조회합니다. 넷째 줄은 캐릭터 설정의 특정 TAG 값을 조회합니다.
중첩 조회
“중첩 조회” 섹션조회 명령은 다른 조회 안에 직접 중첩하지 않는 편이 좋습니다. 안쪽 조회 결과를 먼저 SUBARG로 저장한 뒤, 다음 명령에서 SUBARG를 사용하세요.
SET_SUBARG*[$str_val:enemy$]SETSTRVAR*[$tagrole:name:SUBARG$]여러 단계의 중첩도 가장 안쪽부터 차례대로 나누면 확인하기 쉽고, 괄호와 구분자가 많아져 스크립트가 읽기 어려워지는 문제를 줄일 수 있습니다.
조건과 함께 사용
“조건과 함께 사용” 섹션조회 결과는 조건 표현식에 자주 들어갑니다.
IF*[$player_money$][>=]100이는 플레이어의 금전이 100 이상일 때 IF 안의 명령을 계속 실행한다는 뜻입니다. 조건 표현식의 전체 형식은 조건과 수치 표현식을 참고하세요.
조회 색인
“조회 색인” 섹션공통 시나리오 조회를 불러오는 중...