Minecraft 플러그인 TitleManager

🔌 TitleManager 소개

TitleManager는 Minecraft에서 플레이어에게 보이는 표시 요소를 관리하는 플러그인입니다. 화면 중앙에 표시되는 애니메이션 제목과 부제목, actionbar, 애니메이션이 적용된 tab-list 헤더와 푸터, 그리고 설정 가능한 사이드바 scoreboard를 다룹니다. 더 세련된 접속 메시지, 공지, 실시간 tab/scoreboard 표시를 원하는 서버를 위한 프레젠테이션 레이어 역할을 합니다.

🎯 목적

이 플러그인은 표시 기능(title, actionbar, tab-list, sidebars)을 한곳에 모아, 서버 운영자가 별도 코딩 없이도 일관되고 애니메이션이 적용된 placeholder 기반 정보를 플레이어에게 보여줄 수 있게 합니다. 접속/환영 메시지, 순환 공지, 동적인 TAB/scoreboard UI를 관리하려는 서버 관리자용입니다.

⚙️ 기능

• 접속 및 첫 접속 title과 actionbar를 시간 설정과 변형 옵션과 함께 구성 가능.
• 온라인 수, 월드/서버 시간, 기타 동적 값에 대한 placeholder를 포함하는 애니메이션 및 그라데이션 지원 tab-list 헤더와 푸터.
• 서버 scoreboard 시스템을 기반으로 최대 15개의 애니메이션 줄을 지원하는 설정 가능한 사이드바 scoreboard.
• title 또는 actionbar로 전달되는 방송 및 예약 공지.
• 재사용 가능한 애니메이션 파일과 미리보기를 갖춘 애니메이션 엔진(공식 문서에서 animation playground 제공).
• placeholder 연동(내장 TitleManager placeholders 및 존재할 경우 외부 placeholder 시스템 지원).
• 트랜잭션 방식의 재로드: 설정 재로드는 안전하게 적용되며 새 설정이 유효하지 않으면 되돌릴 수 있습니다.
• 선택적 연동 및 플러그인 간 사용을 위한 작은 개발자용 API.

🧩 대상

• 세련된 접속/공지 UI를 원하는 Survival 및 SMP 서버.
• 표시에서 동적 값을 사용하기 위해 placeholders와 외부 연동을 사용하는 서버.
• 커스텀 플러그인을 작성하지 않고 애니메이션이 적용된 tab 및 scoreboard 표시가 필요한 관리자.
• 제공된 API를 통해 다른 플러그인에 프레젠테이션 기능을 통합하려는 개발자.

🏗️ 사용 예시

• 플레이어가 접속할 때 애니메이션이 적용된 환영 title과 actionbar를 표시하고, 첫 접속 시에는 다른 메시지를 보여줍니다.
• 서버 시간, 온라인 수, 그라데이션 헤더/푸터를 표시해 tab 플레이어 목록을 더 생동감 있게 유지합니다.
• 일정에 따라 애니메이션 공지 title 또는 actionbar를 바꿔 이벤트나 규칙을 전달합니다.
• 사이드바 scoreboard를 사용해 순위표, 통계 또는 동적인 서버 정보를 표시합니다.

⌨️ 명령어

참고: 위 명령어들은 프로젝트에서 문서화되어 있습니다. 여기 사용된 소스에는 특정 권한 노드가 나와 있지 않으므로, 정확한 노드와 기본값은 플러그인 문서를 확인하세요.

⚙️ 설치

📥 설정

• 프로젝트 릴리스 또는 플러그인 리소스 페이지에서 플러그인 JAR를 다운로드합니다.
• JAR를 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작합니다.
• plugins/TitleManager/ 아래에 생성된 설정 파일을 편집해 title, 애니메이션, 플레이어 목록 설정을 조정합니다.
• 설정 변경을 적용하려면 /tm reload를 사용하세요. 플러그인은 깨진 설정을 적용하지 않도록 트랜잭션 방식 재로드를 수행합니다.

📦 의존성

• PlaceholderAPI(외부 placeholders용 선택적 연동).
• Vault(선택 사항, 존재할 경우 placeholder 값에 사용).
• BungeeCord(프록시 설정에서 사용할 때 연동을 인식하는 동작).

이 연동은 선택 사항이며 존재할 때만 사용됩니다. 플러그인은 없어도 동작하지만, 사용 가능하면 해당 데이터를 사용할 수 있습니다.

🧠 기술 메모

• 공식 런타임 대상은 Minecraft 1.8부터 1.21.x까지입니다(프로젝트 자료에서는 1.21.11까지의 명시적 지원을 언급합니다). 동작은 서버 버전에 따라 달라지며, 최신 Minecraft 버전은 현대 Bukkit/Paper API를 사용하고 레거시 버전은 버전별 호환 모듈에 의존합니다.
• TitleManager는 선택적 연동을 위한 작은 Bukkit용 API를 제공하며, 생성된 API 문서도 제공합니다.
• 안전한 재로드와 진단 명령어는 설정 및 런타임 문제 해결에 도움이 됩니다.

🤝 이 플러그인이 유용한 경우

설정에서 관리하는, 중앙집중식이고 애니메이션이 적용되며 placeholder 기반인 표시 제어(title, actionbar, tab-list, sidebars)를 원한다면, TitleManager는 이러한 UI 요소를 서버 환경 전반에서 일관되게 제공할 수 있도록 문서화된 플러그인과 API를 제공합니다.