BuzzBuild-BossIndicator — 사용법

HUD 수신 점검

설치에 따라 서버와 클라이언트 양쪽 구성을 준비합니다.
관리자 플레이어가 /보스표시 상태로 연동 감지 상태를 확인합니다.
/보스표시 테스트를 실행합니다. 가상 체력 850,000/1,000,000과 피해량 12,400을 전송합니다.
화면 상단에서 체력 바·이름·x N 표시를 확인합니다. 기본 첫 규칙은 총 8줄이며 표시되는 x N은 현재 체력 비율로 계산한 남은 줄 수이므로 총 줄 수와 다를 수 있습니다.
/보스표시 숨김으로 테스트 화면을 지웁니다. 실제 대상 추적 중에는 다음 갱신으로 다시 표시될 수 있습니다.

채팅의 전송 완료 메시지는 클라이언트 렌더링 성공 확인이 아닙니다. 화면이 없으면 문제 해결의 설치·통신 항목을 확인합니다.

바닐라 대상으로 시작하기

bosses.yml에 다음 규칙을 등록합니다.
```
mythic: {}
vanilla:
  zombie:
    rows: 3
```
config.yml의 display.only-configured-bosses를 true로 둡니다.
/보스표시 리로드를 실행합니다.
살아 있는 좀비를 직접 공격하거나 자신이 발사한 투사체로 공격합니다. 보호 플러그인 등에 의해 취소된 피해는 추적하지 않습니다.
다시 공격하면 유지 시간이 갱신됩니다. 다른 매칭 대상을 공격하면 해당 플레이어의 표시 대상이 바뀝니다.

자동 추적은 공격한 플레이어에게만 적용됩니다. 주변 플레이어나 파티원 전체에게 자동 방송하지 않습니다. 매칭되지 않는 대상을 공격해도 기존 추적을 즉시 지우지는 않습니다.

Mythic 보스 등록

서버에서 MythicMobs가 활성화되어 있는지 /보스표시 상태로 확인합니다.
보스를 바라보고 /보스표시 진단으로 MythicID를 확인합니다. 다른 플레이어의 시선은 /보스표시 진단 ExamplePlayer로 확인할 수 있습니다.
확인한 내부 ID를 bosses.yml의 mythic에 등록합니다. 아래 example_boss와 위 ExamplePlayer는 가상 예시입니다.
```
mythic:
  example_boss:
    rows: 8
vanilla: {}
```
/보스표시 리로드 후 보스를 다시 타격합니다.
체력이 감소할 때 현재 줄의 채움과 남은 줄 수가 변하고 색상이 순환하는지 확인합니다. rows: 0이면 최대 체력 기반 자동 계산을 사용합니다.

이 플러그인은 보스 소환·스킬·보상·체력을 설정하지 않습니다. 기존 엔티티의 현재 체력과 최대 체력을 읽어 표시합니다.

남은 시간과 개인 위치

PlaceholderAPI와 원하는 placeholder를 제공하는 구성 요소를 준비합니다. 기본 %md_dungeon_time_left% 제공자는 이 프로젝트에 구현되어 있지 않습니다.
display.show-time-left: true와 유효한 display.time-left-placeholder를 설정한 뒤 리로드합니다.
치환 결과가 비어 있거나 원문과 같으면 시간 줄은 표시되지 않습니다. 자체 카운트다운은 없으므로 실제 감소는 제공자가 담당합니다.
HUD를 아래로 옮기려면 클라이언트 JSON의 positions.hudOffsetY를 변경하고 클라이언트를 다시 실행합니다. 개인 HUD를 완전히 끄려면 enabled: false로 설정합니다.

표시 종료 조건

서버는 유지 시간 만료, 대상 사망·소멸, 다른 월드로 이동, 최대 거리 초과 시 추적을 제거하고 clear를 보냅니다. 플레이어 접속 종료 시 서버 추적과 클라이언트 HUD 상태를 정리합니다. 별도로 클라이언트는 마지막 sync로부터 8초가 지나면 그리기를 중단합니다.

확인 범위

2026-10-05 소스에서 확인한 흐름에 따른 절차입니다. 게임 내 동작은 미검증이며 위 시나리오를 실제 서버에서 실행하지 않았습니다.