구성

• main : 플러그인 메인 클래스의 위치
  • maven 사용시 pom.xml의 groupId.artifactId.main클래스 형식이어야 함
• name : 이름
• version : 플러그인 버전
  • 마인크래프트 버전과 다름
• description : 설명
• api-version : 사용하려는 API 버전, 마인크래프트 버전으로 기입
  • 예시) 1.20.4 버전 같은경우 1.20
• load : 플러그인을 로드하는 시기, 기본 값은 POSTWORLD
  • STARTUP : 시작 하자마자
  • POSTWORLD : 월드 로드 이후
• author : 저자 (작성자)
  • authors: 저자가 여러명인 경우 []으로 표기
• website : 플러그인이나 저자의 웹사이트
• depend : 현재 플러그인을 로드할때 필요한 플러그인, 없으면 로드가 안됨
  • 해당 플러그인 파일의 plugin.yml의 name
• softdepend : 플러그인이 전체 기능을 갖추는 데 필요한 플러그인
  • 해당 플러그인 파일의 plugin.yml의 name
• loadbefore : 해당 플러그인 이후에 로드되는 플러그인
  • 해당 플러그인 파일의 plugin.yml의 name
• prefix : 플러그인 이름 대신 콘솔에 로그인할 때 사용할 이름
• commands : 명령어를 선언할 때 사용, 하단 명령어 부분 참조
• permissions : 권한을 선언할 때 사용, 하단 권한 부분 참조

명령어 (Commands)

commands:
  test:
    description: "테스트"
    usage : "/test"
    operator : admin
    aliases : [t,tes]
    permission: test.T
    permission-message : You do not have permission to use this command.

• test : 실제로 사용할 명령어 이름을 지정
  • /test의 형태로 명령어 사용 가능
• description : 명령어 설명으로 /help 쳤을때 나오는 내용
• usage : command 클래스에서 return false;시 출력되는 메시지
• operator : admin 값으로 입력시 op만 사용 가능함
• aliases : 별명, 명령어로 사용할 수 있음
• permission : 해당 퍼미션을 가져야만 명령어 사용 가능
• permission-message : 퍼미션이 없을 때 사용시 출력되는 메시지

퍼미션 (Permision)

permissions:
  test.T:
    description: "Allows you to use the command /test"
    default : true

  test.*:
    description: Wildcard permission
    default: op
    children:
      test.foo: true

• description : 퍼미션에대한 설명으로 보통 권한으로 할 수 있는 것들로 작성함
• default : 기본적으로 퍼미션을 가지고 있는 대상
  • true : 모두
  • false : 아무도 안가짐
  • op : op권한을 가진 경우
  • not op : op권한이 없는 경우
• children : 권한에 대한 하위 항목을 설정
  • true : 하위 노드는 상위 권한을 상속함
  • false : 하위 노드는 상위 권한을 역상속함