BuzzBuild-BossIndicator — 개요

BuzzBuild-BossIndicator는 Paper 서버에서 플레이어가 타격한 대상의 체력을 추적하고, Fabric 클라이언트 화면 상단에 보스 HUD를 표시합니다. 서버 플러그인과 클라이언트 모드가 함께 필요합니다.

핵심 기능

• MythicMobs 내부 ID 또는 바닐라 엔티티 종류를 bosses.yml에 등록합니다.
• 플레이어의 직접 공격과 플레이어가 발사한 투사체 공격을 추적합니다. 취소된 피해 이벤트는 제외합니다.
• 플레이어마다 마지막으로 매칭된 대상 하나의 체력, 마지막 타격 피해량, 남은 체력 줄 수와 순환 색상을 표시합니다.
• PlaceholderAPI로 치환한 남은 시간 문자열을 표시합니다. 자체 던전 타이머는 없습니다.
• 서버에서 이름·체력 문구·색·갱신 간격을, 클라이언트에서 HUD 위치·표시 여부를 설정합니다.
• 활성 추적 정보는 메모리에만 보관합니다. 별도 DB·영속 테이블은 없습니다.

지원 환경

아래는 버전 0.1.0 소스의 빌드 대상과 메타데이터 선언입니다. 다른 버전까지의 호환성을 보장하는 범위는 아닙니다.

항목	확인된 값
Minecraft	26.1.2
서버	Paper, 컴파일 API 26.1.2.build.69-stable, api-version: '26.1.2'
Java	서버·클라이언트 빌드 대상 25, Fabric 요구 조건 >=25
Fabric Loader	빌드 0.19.3, 모드 요구 조건 >=0.19.3
Fabric API	빌드 0.155.2+26.1.2, 모드 메타데이터는 *
클라이언트 환경	Fabric 전용, environment: client

Folia, Spigot, Forge, NeoForge 및 다른 Minecraft 버전은 이 소스로 지원을 확인하지 않았습니다.

의존성

구분	구성 요소	용도
서버 필수	BuzzBuild-Framework Paper 플러그인	서비스 등록과 HUD 데이터 전송
클라이언트 필수	BuzzBuild-Framework Fabric 모드, Fabric API, Fabric Loader	통신 수신과 HUD 렌더링
서버 선택	MythicMobs	Mythic 내부 ID·표시 이름 조회. 없어도 바닐라 규칙 사용 가능
서버 선택	PlaceholderAPI와 사용하는 placeholder 제공자	남은 시간 문자열 치환. 없거나 치환되지 않으면 시간 줄을 비움

Framework는 빌드에서 0.1.0 산출물을 참조하지만 런타임 메타데이터에 정확한 버전 제약은 없습니다. MythicMobs와 PlaceholderAPI의 호환 버전도 별도로 고정되어 있지 않아 실제 조합 확인이 필요합니다. 바닐라 클라이언트용 BossBar 대체 출력은 없습니다.

문서 안내

설치 · 명령어·권한 · 설정 · 사용법 · 문제 해결

확인 범위

2026-10-05 기준 Gradle, 메타데이터, 서버·클라이언트 구현, 기본 리소스와 Framework 송수신 코드를 확인했습니다. 게임 내 동작은 미검증입니다. 빌드·서버 실행·배포는 수행하지 않았습니다.