아이템 생성

모든 아이템 컨픽은 item 폴더 내에 존재하는 파일에서 생성됩니다. 파일의 이름은 상관없으며 정리를 위해 카테고리별로 나누는 방향으로 관리하고 있습니다.

카테고리 방향성

분류가 애매하거나 아직 분류 전인 아이템은 default.yml 에 존재합니다. 
다른 아이템은 컨텐츠 대분류에 맞추어 파일을 새로 만들 수 있습니다.

machine.yml -> machine(기계) 컨텐츠 관련 모든 아이템

사실 정리가 완벽하다 보기는 어렵기 때문에, 모든 파일을 한번 훑어보며 무엇이 어디 있는지 확인하여 친숙화 하는 과정이 필요합니다.

기본 설명

아이템을 구성하는데 반드시 필요한 것을 제외하고 대부분 항목은 optional 입니다. 

material, name, lore 은 항상 필요합니다. 
하지만 특정 항목을 추가하기로 했다면 필수인 항목도 있고 optional 항목도 있을 수 있습니다.

예를 들어 cooldown 을 추가한 경우 type 과 duration 은 필요하지만 global 항목은 Optional 입니다.
이미 만들어져 있는 예제가 많으므로 친숙화 과정 중에는 가급적 이미 존재하는 예제를 참조하여 테스트 해 보시길 바랍니다. 

아이템 생성 및 변경은 항상 yml 직접 수정으로 시작합니다. 시그 플러그인에는 매우 특정한 상황을 제외하고는 in-game editor 은 지원하지 않습니다.

1. 필요한 사항을 yml에서 추가 또는 변경합니다.
2. 게임 내에서 /itemadmin reload 
3. 변경된 사항을 확인합니다.

기본 아이템

간단한 소모품 + 기간제 / 귀속 예제

on-consume 아래 항목은 SigReward 포맷을 모두 지원합니다.

SigReward 포맷은 https://wiki.beartown.kr/dev/docs/plugins/siglib/sigreward 에서 확인 할 수 있습니다.

SigReward 에서 제공되는 항목은 대부분 Optional 입니다.

소모품에서 제공되는 것이 명령어인 것은 가장 바람직한 방향은 아니지만, 일반적으로 명령어를 사용한다고 문제가 생기지는 않기 때문에 명령어 연동을 하는 경우도 잦습니다. 이러한 방향이 아니라 내부적으로 자체 연동을 해 두는 방향을 네이티브(native) 구현이라 합니다.

네이티브 구현 소모품 + 쿨다운 예제

소모 제한 예제

restriction 항목은 consume 아이템이 특정 서버에서 사용되지 못하도록 막는 기능입니다.

현재 서버만 있습니다. (지역 등으로 확장 가능)