⌨️ 사용법
BetonQuestAddon의 여러 목적(Objectives), 이벤트(Events), 조건(Conditions)에 공통적으로 적용되는 매개변수와 형식 규칙에 대해 설명합니다.
문서 표기법
세부 기능을 살펴보기 전에, 이 문서에서 구문이 어떻게 표기되는지 확인해 주세요.
| 표기 | 의미 | 설명 |
|---|---|---|
<value> | 필수 | 기능이 작동하기 위해 반드시 제공해야 하는 매개변수입니다. |
[value] | 선택 | 기본값이 존재하며, 생략할 수 있는 매개변수입니다. |
다중 ID (Multiple IDs)
대부분의 목적(Objective) id 매개변수는 쉼표(,)로 구분된 리스트를 통해 여러 항목 입력을 지원합니다. 이를 통해 하나의 목적 내에서 여러 종류의 아이템, 블록 또는 엔티티를 추적할 수 있습니다.
형식 및 제약 사항
- 형식:
A,B,C - 제약 사항: ID는 **공백 없이 쉼표(,)**로만 구분해야 합니다.
- 예시:
stone,dirt,grass_block(올바름) vsstone, dirt(잘못됨 - 공백 포함)
취소된 액션 (Cancelled Actions)
목적 구문에 isCancelled 매개변수가 포함되어 있다면, 다른 플러그인에 의해 차단된 액션(예: WorldGuard 보호 구역에서 블록 파괴 시도)을 추적할 수 있습니다.
| 값 | 설명 |
|---|---|
isCancelled:false | (기본값) 성공적으로 완료된 액션만 추적합니다. |
isCancelled:true | 다른 플러그인에 의해 이벤트가 취소/방지되었더라도 액션을 추적합니다. |
활용 사례
성공적인 결과보다는 시도(attempt) 자체를 기반으로 목적을 트리거하고 싶을 때 **isCancelled:true**를 사용하세요.
예시: block stone amount:1 isCancelled:true
위치 목적 문제 해결 [location]
위치 확인이 올바르게 트리거되지 않는다면, **블록(Blocks)**과 **가구(Furniture/Entities)**가 사용하는 좌표계의 차이 때문일 가능성이 높습니다.
대상 유형에 따라 정확하게 감지되기 위한 특정 형식이 필요합니다.
| 유형 | 형식 | 예시 |
|---|---|---|
| 일반 블록 | **정수(Integer)**를 사용해야 합니다. | 10;64;10;world |
| 가구 (엔티티) | .5 소수점(중앙 오프셋)이 필요합니다. | 10.5;64;10.5;world |