BuzzBuild-BossIndicator — 문제 해결
증상별 확인
섹션 제목: “증상별 확인”| 문제 | 확인 방법 | 해결·대응 |
|---|---|---|
| 플러그인 활성화 실패 | Framework 누락 또는 Framework 서비스 없음 로그 확인 | Framework Paper 실행용 JAR과 서비스 활성화 확인. API 전용 JAR을 실행용으로 쓰지 않음 |
| 테스트 메시지만 나오고 HUD가 없음 | Fabric 모드 두 종류와 Fabric API, enabled, 클라이언트 초기화 로그 확인 | 설치 구성을 맞추고 클라이언트 재실행. 전송 메시지만으로 렌더링 성공을 판정하지 않음 |
| 타격해도 HUD가 없음 | /보스표시 상태, 대상을 바라본 /보스표시 진단, only-configured-bosses 확인 | 실제 ID를 bosses.yml에 등록하고 리로드 후 재타격. 취소된 피해나 플레이어·플레이어 투사체 이외 공격은 추적하지 않음 |
| Mythic 대상이 인식되지 않음 | MythicMobs 없음, 조회 메서드 없음, 바인딩 실패 로그와 진단의 MythicID 확인 | MythicMobs 활성화와 현재 API 조합 점검. 연동 정상화 후 플러그인 리로드로 브리지 재조회 |
| 시간 줄이 없음 | show-time-left, placeholder 문자열, PAPI 감지 확인 | 실제 치환 제공자를 준비. 미설치·빈 값·원문 그대로인 결과는 숨김. 필요 없으면 표시 설정을 끔 |
| 설정을 바꿔도 동일함 | 서버 YAML과 클라이언트 JSON 중 어느 파일을 바꿨는지 확인 | 서버 파일은 /보스표시 리로드, 대상 규칙은 재타격, 클라이언트 파일은 클라이언트 재실행 |
숨김 직후 다시 나타남 | 상태의 활성 추적 수 확인 | 일회성 clear의 현재 동작. 추적 종료를 기다리거나 개인 JSON의 enabled: false 사용 |
| 유지 시간 전에 HUD가 사라짐 | 거리·월드·대상 생존 여부와 마지막 sync 시각 확인 | 클라이언트의 8초 만료와 서버의 동일 데이터 전송 생략을 고려. 유지 틱을 늘리는 것만으로 해결되지 않음 |
| 테스트 후 활성 수가 늘지 않음 | 실제 보스 추적 여부 확인 | 테스트는 패킷만 보내므로 정상. 살아 있는 등록 대상을 타격하여 추적 확인 |
| 색이 기본 빨강으로 나옴 | 색 이름, 6자리 HEX, colors.order 구분자 확인 | 올바른 이름 또는 따옴표로 감싼 HEX를 >로 연결. 유효하지 않은 색은 제외됨 |
| 줄 수가 예상과 다름 | 대상 rows, 자동 계산 설정, 현재 체력 비율 확인 | 고정 rows가 우선. x N은 남은 줄 수이며 자동 상한은 고정 rows에 적용되지 않음 |
| 권한 오류·콘솔 실행 거부 | 명령어·권한 표 확인 | 명령 진입 권한과 관리자 권한을 구분. 테스트·숨김은 플레이어로 실행, 콘솔 진단은 대상 지정 |
| 클라이언트 설정 오류 또는 시작 실패 | JSON 구문·boolean·integer 타입과 클라이언트 로그 확인 | 파일을 백업한 뒤 유효한 JSON으로 수정. 잘못된 JSON·숫자 오류 전체를 복구한다고 보장하지 않음 |
현재 구현의 제한과 확인 필요 항목
섹션 제목: “현재 구현의 제한과 확인 필요 항목”- 바닐라 클라이언트용 대체 HUD, 별도 인벤토리 GUI, 클라이언트 명령어·키 바인딩은 없습니다.
- 플레이어별 대상 하나만 추적합니다. 파티 전체 공유, 주변 자동 탐색, 여러 보스 동시 목록은 구현되어 있지 않습니다.
- 보스 생성·전투 로직·보상 지급·자체 시간 계산은 제공하지 않습니다.
- 리로드는 설정과 브리지를 교체하지만 기존 뷰의 대상 규칙을 재매칭하지 않습니다. 대상 규칙을 바꾼 뒤에는 다시 타격해야 합니다.
- 서버는 동일한 스냅샷을 생략하고 클라이언트는 8초 후 숨깁니다. 변화가 없는 대상에서 유지 시간보다 먼저 숨는 현상은 소스로 확인한 가능성이며 게임 내 재현이 필요합니다.
- MythicMobs·PlaceholderAPI의 구체적인 호환 버전과 기본 시간 placeholder 제공자는 확인이 필요합니다. 상태의
감지는 API 연결 상태이며 특정 몹 조회·placeholder 치환 성공을 보증하지 않습니다. - Folia 지원 선언과 지역 스케줄러 적용은 없습니다. 다른 서버 플랫폼·로더·Minecraft 버전의 호환성은 확인하지 않았습니다.
진단 기록
섹션 제목: “진단 기록”운영 확인 시 서버·클라이언트 버전, 연동 감지 상태, 규칙 개수, 재현 순서와 HUD 표시 여부를 기록하세요. runtime.debug: true는 sync·clear 로그를 추가합니다. 로그와 진단 결과에는 플레이어 이름·UUID가 포함될 수 있으므로 공개 공유 전 제거하세요.
확인 범위
섹션 제목: “확인 범위”2026-10-05 소스 정적 확인 결과입니다. 게임 내 동작은 미검증입니다. 서버 시작·중지·재시작·전체 reload와 빌드·배포는 수행하지 않았습니다.