BuzzBuild-BossIndicator — 설치

설치 구성

Minecraft 26.1.2, Java 25를 기준으로 준비합니다. 버전 선언과 빌드 대상은 개요를 참고하세요.

설치 대상	파일·구성	위치
Paper 서버	BuzzBuild-Framework Paper 배포 JAR	서버 기준 plugins/
Paper 서버	BuzzBuild-BossIndicator-Paper-0.1.0.jar	서버 기준 plugins/
Fabric 클라이언트	Fabric API, BuzzBuild-Framework Fabric 배포 JAR	게임 인스턴스 기준 mods/
Fabric 클라이언트	BuzzBuild-BossIndicator-Fabric-0.1.0.jar	게임 인스턴스 기준 mods/
서버 선택	MythicMobs, PlaceholderAPI 및 필요한 placeholder 제공자	각 구성 요소의 설치 방식에 따름

클라이언트는 Fabric Loader 0.19.3 이상이 필요하며 확인된 Fabric API 빌드 대상은 0.155.2+26.1.2입니다. shared 모듈은 배포 JAR에 포함되므로 별도로 설치하지 않습니다. Framework API 전용 JAR을 실행용 JAR로 사용하지 마세요.

최초 실행과 설정

1. 운영자가 정한 서버 정비 절차에 따라 서버용 JAR과 의존성을 설치합니다. 새 JAR을 로드하는 시점은 운영자가 관리합니다.
2. 플러그인이 처음 활성화되면 plugins/BuzzBuild-BossIndicator/config.yml과 bosses.yml을 없는 경우에 생성합니다. 기존 파일은 덮어쓰지 않습니다.
3. 시작 로그에서 Framework 서비스와 BossIndicator 활성화 여부를 확인합니다. FeatureRegistry, PaperMessagingBus 서비스가 없으면 활성화 과정에서 오류가 발생합니다.
4. 클라이언트를 실행하면 config/buzzbuild-boss-indicator.json을 읽고 저장합니다. 파일이 없으면 기본값으로 생성합니다.
5. /보스표시 상태로 MythicMobs·PlaceholderAPI 감지와 규칙 개수를 확인합니다.
6. 모드를 설치한 플레이어가 관리자 권한으로 /보스표시 테스트를 실행해 HUD 수신을 확인합니다. 이 명령은 가상 체력 데이터를 보내며 몹을 생성하지 않습니다.

대상 등록과 적용

기본 bosses.yml에는 Mythic ID example1, example2, Dummy, live_Dummy가 들어 있고 바닐라 목록은 비어 있습니다. 이 이름의 몹을 자동 생성하지 않으므로 실제 대상에 맞게 수정해야 합니다.

1. 설정에 따라 bosses.yml의 대상과 config.yml의 표시 설정을 편집합니다.
2. /보스표시 리로드로 두 서버 파일을 다시 읽습니다. 서버 전체 reload는 필요하지 않습니다.
3. 대상 몹을 다시 타격해 변경된 규칙을 적용합니다. 기존 추적 뷰는 이전에 매칭한 규칙을 보관하므로 규칙 변경 직후에는 재타격 확인이 필요합니다.
4. 클라이언트 JSON을 수정했다면 클라이언트를 다시 실행합니다. 서버의 리로드 명령은 클라이언트 JSON을 다시 읽지 않습니다.

확인 범위

2026-10-05 소스 기준 설치·초기화 경로입니다. 게임 내 동작은 미검증이며 실제 JAR 로드와 서버 운영 작업은 수행하지 않았습니다.