plugin.yml 가이드
plugin.yml은 Spigot, Paper, Bukkit 서버에서 플러그인을 로드하는 데 필요한 구성 파일입니다. 이 도구는 플러그인의 동작을 정의하는 YAML 형식의 파일을 생성하는 데 도움이 됩니다.
name, main, version 필드는 필수입니다. name은 플러그인의 고유 식별자이며 영문자, 숫자, 밑줄만 사용해야 합니다. main은 플러그인의 메인 클래스에 대한 전체 경로이며, version은 플러그인의 버전 번호입니다.
선택적 메타데이터 필드에는 description, author, authors, contributors, website, prefix, load, api-version 등이 있습니다. 이 필드들은 플러그인에 대한 추가 정보를 제공하고 서버가 플러그인을 로드하는 방식에 영향을 줄 수 있습니다.
명령어와 권한은 플러그인이 제공하는 기능과 해당 기능에 액세스할 수 있는 사용자를 정의하는 데 사용됩니다. 각 명령어는 이름, 설명, 사용법, 권한 및 권한 메시지를 가질 수 있습니다. 권한은 노드, 설명, 기본값 및 하위 권한을 가질 수 있습니다.
자주 묻는 질문
plugin.yml 파일은 어디에 두어야 하나요?
생성된 plugin.yml 파일은 플러그인의 JAR 파일 내 루트 디렉토리에 위치해야 합니다. 일반적으로 이는 플러그인의 빌드 프로세스에 의해 자동으로 처리됩니다.
"Spigot requires name to use only letters, numbers, and underscores (a-z A-Z 0-9 _)." 오류가 발생하는 이유는 무엇인가요?
이는 플러그인 이름에 유효하지 않은 문자가 포함되어 있음을 의미합니다. Spigot은 플러그인 이름에 영문자, 숫자, 밑줄만 허용합니다. 공백, 하이픈 또는 기타 특수 문자는 사용할 수 없습니다.
여러 작성자나 기여자를 지정하려면 어떻게 해야 하나요?
"authors" 또는 "contributors" 필드에 쉼표로 구분된 이름 목록을 입력하세요. "authors" 필드는 "author" 필드를 재정의합니다.
명령어 별칭을 추가하려면 어떻게 해야 하나요?
명령어의 "aliases" 필드에 쉼표로 구분된 별칭 목록을 입력하세요. 예를 들어, "mycommand, mc"를 입력하면 "mycommand"와 "mc" 모두로 명령어를 실행할 수 있습니다.