DeluxeTags는 Spigot용 Minecraft 플러그인으로, 권한 기반의 추가 태그(접두사)를 제공합니다. 플레이어는 게임 내 GUI 또는 명령어로 이를 해금하고 전환할 수 있습니다. 태그는 "추가 접두사"로 취급되며, 플레이스홀더를 통해 채팅, 탭, 기타 채팅 연동 기능에 표시할 수 있습니다.

🎯 목적

DeluxeTags는 랭크/그룹 접두사와 별도로, 플레이어에게 선택 가능한 커스텀 장식 태그를 제공하는 문제를 해결합니다. 메인 그룹이나 랭크를 바꾸지 않고도 구매/해금/보상형 태그를 활성화하거나 비활성화할 수 있게 하려는 서버에 유용합니다.

⚙️ 기능

권한 기반 태그: deluxetags.tag.<identifier>로 접근 권한을 부여합니다(설정 예시: deluxetags.tag.example).
사용 가능한 태그를 둘러보고 선택할 수 있는 플레이어 GUI.
태그를 목록화, 선택, 관리하는 명령어(플레이어 및 관리자 명령어는 프로젝트 문서에 안내됨).
PlaceholderAPI 지원과, 활성 태그, 식별자, 설명, 개수를 채팅 형식에 삽입하는 플레이스홀더.
플러그인 설정 예시에 표시된 GUI 아이템, 이름, 페이지 설정을 구성 가능.
접속 시 플레이어의 태그를 불러오기, 채팅 포맷 연동, 업데이트 확인 옵션.

🧩 대상

랭크 접두사와 분리된, 장식용이며 해금 가능한 채팅 태그를 원하는 Survival / SMP 서버.
LuckPerms 같은 권한 플러그인으로 장식 보상을 지급하는 서버.
플레이어를 위한 간단한 GUI 기반 태그 선택기를 원하는 관리자.

🏗️ 사용 예시

VIP 태그 권한을 구매 가능한 장식으로 플레이어에게 부여하고, 태그 GUI에서 전환할 수 있게 함.
이벤트 보상으로 특정 태그 권한을 지급하여, 우승자가 사용 가능한 태그 중 새 태그를 선택할 수 있게 함.
관리자가 명령어로 커스텀 태그를 만들고 권한으로 사용 가능한 플레이어를 지정함.

⌨️ 명령어

명령어	설명	권한	접근
`/tags`	태그 GUI를 엽니다.	지정되지 않음	플레이어
`/tags list`	사용 가능한 태그를 목록으로 보여줍니다.	지정되지 않음	플레이어
`/tags list all`	로드된 모든 태그를 목록으로 보여줍니다.	지정되지 않음	관리자
`/tags list <player>`	지정한 플레이어의 사용 가능한 태그를 목록으로 보여줍니다.	지정되지 않음	관리자
`/tags select <TagID>`	지정한 태그를 선택합니다(플레이어는 해당 태그 권한이 있어야 합니다).	지정되지 않음	플레이어
`/tags set <player> <TagID>`	지정한 플레이어에게 지정한 태그를 설정합니다.	지정되지 않음	관리자
`/tags clear <player>`	플레이어의 태그를 제거합니다.	지정되지 않음	관리자
`/tags create <TagID> <Tag>`	새 태그를 만듭니다.	지정되지 않음	관리자
`/tags delete <TagID>`	지정한 태그를 삭제합니다.	지정되지 않음	관리자
`/tags setorder <TagID> <Order>`	태그 순서를 설정합니다.	지정되지 않음	관리자
`/tags setdisplay <TagID> <Display>`	태그 표시 텍스트를 설정합니다.	지정되지 않음	관리자
`/tags setdesc <TagID> <Desc>`	태그 설명을 설정합니다.	지정되지 않음	관리자
`/tags reload`	플러그인 설정을 다시 불러옵니다.	지정되지 않음	관리자
`/tags version`	플러그인 버전과 제작자 정보를 표시합니다.	지정되지 않음	관리자
`/tags help`	사용 가능한 명령어 도움말을 보여줍니다.	지정되지 않음	플레이어

참고: 프로젝트 문서에서 이 명령어들을 확인할 수 있습니다. 태그별 노드 패턴 외의 구체적인 명령어 권한 노드는 मुख्य 소스에 나와 있지 않습니다.

🔐 권한

권한	설명	기본값
`deluxetags.tag.<identifier>`	`<identifier>`로 식별되는 특정 태그를 사용할 수 있는 권한을 플레이어에게 부여합니다. 예: 설정에 표시된 `deluxetags.tag.example`.	지정되지 않음

이 플러그인은 태그별 권한 노드를 사용합니다. 그 외 명령어 전용 노드는 제공된 주요 프로젝트 파일에 명시적으로 문서화되어 있지 않습니다.

⚙️ 설치

📥 설정

프로젝트의 Spigot 리소스 또는 공식 빌드 아티팩트에서 플러그인 JAR를 다운로드합니다.
JAR를 서버의 plugins/ 폴더에 넣습니다.
서버를 시작하거나 재시작한 뒤 콘솔에서 플러그인이 로드되었는지 확인합니다.

📦 의존성

PlaceholderAPI — 지원됨(플러그인에 플레이스홀더와 papi_chat 옵션 포함). 설정과 예시에서 확인할 수 있습니다.

🧾 설정

DeluxeTags는 태그, GUI 설정, 메시지를 정의하는 YAML 설정을 사용합니다. 설정에는 태그 항목, GUI 아이템 설정, 플레이스홀더, 채팅 형식 옵션의 예시가 포함되어 있습니다. 설정에서 자주 보이는 키: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 기술 메모

프로젝트 소스는 공개 GitHub 저장소에서 이용할 수 있습니다.
Spigot 프로젝트는 1.8부터 1.21까지의 테스트된 Minecraft 버전을 सूची화하며, 테스트된 버전 목록에 1.20.6 항목도 포함합니다.
개발 빌드와 CI 아티팩트는 프로젝트의 CI 서버에서 제공됩니다.
저장소에는 소스 호스트에 공개 릴리스가 표시되지 않으며, CI 아티팩트는 별도로 제공됩니다.