BuzzBuild-LootNotice — 문제 해결

증상별 확인

문제	확인 방법	해결 또는 대응
모드가 로드되지 않음	클라이언트 로그의 의존성·Mixin 오류, 설치 인스턴스와 버전 확인	Minecraft 26.1.2, Java 25 이상, Fabric Loader 0.19.3 이상과 해당 버전용 Fabric API 확인. 서버 plugins 폴더가 아닌 클라이언트 mods 폴더 사용
아이템을 얻어도 알림이 없음	생존·모험 모드인지, 알림 켜짐과 HUD 표시 상태인지 확인	조건을 맞춘 뒤 바닥 아이템을 직접 주워 확인. 크리에이티브·관전자 모드는 표시 대상 아님
명령어 지급·상자 이동은 표시되지 않음	지급 과정에 자신의 바닥 아이템 습득 패킷이 있는지 확인	현재 미지원 경로. 인벤토리 수량 증가 전체를 추적하는 기능은 없음
설정 키가 반응하지 않음	다른 화면이 열려 있는지, 조작 설정의 키 충돌 확인	화면을 닫고 실행하거나 습득물 알림 설정 키 변경. Mod Menu 진입도 가능
화면 밖으로 나감·이름이 잘림	offsetX/Y, scale, barWidth 및 GUI 배율 확인	초기화 후 드래그 재배치, 너비 조절. 긴 이름의 말줄임은 의도된 동작
애니메이션이 없거나 너무 짧음	fadeInMs, fadeOutMs, slideDistance, durationMs 확인	페이드 인 0이면 슬라이드도 없음. 페이드 인을 표시 시간보다 짧게 조절
재실행하면 설정이 되돌아옴	실제 사용 인스턴스의 JSON과 파일 쓰기 권한 확인	저장 후 파일 내용 확인. 저장 오류를 화면에 알리는 코드가 없으므로 폴더 쓰기 가능 여부 확인
설정이 기본값으로 바뀜	configVersion과 .broken 파일 확인	구버전 자동 변환 또는 JSON 읽기 실패 가능. 백업 확보 후 올바른 타입과 JSON 문법으로 복구
raon 설정을 다시 읽지 않음	새 buzzbuild-lootnotice.json 존재 여부 확인	자동 가져오기는 새 파일이 없을 때만 수행. 현재 파일과 원본을 백업한 뒤 필요한 값만 새 JSON에 반영
샘플 미리보기 버튼에 반응이 없음	enabled, 게임 모드, HUD 숨김 상태 확인	고정 박스와 샘플 HUD는 다름. 샘플은 실제 HUD 조건을 따름
설정 화면에 라온 이름이 보임	제목이 라온 습득물 알림 모드인지 확인	현재 소스의 고정 제목으로, 설치 오류의 근거가 아님

파일 편집은 클라이언트를 종료한 뒤 진행하고 다음 실행에 반영하세요. 설정 reload 명령어는 없습니다. 전체 설정 키를 참고하세요.

미지원 사항

• Paper·Bukkit 서버 플러그인 설치, 서버 콘솔 명령어, 권한 노드 제어.
• Forge·NeoForge용 배포 모듈 및 Minecraft 26.1.2 이외 버전에 대한 지원 선언.
• 습득 패킷이 없는 직접 보상 지급 알림, 경험치 구슬 알림.
• DB 저장, 습득 이력 조회, 서버 간 동기화, MythicMobs 전용 연동.
• 실행 중 JSON 변경 자동 반영 및 이전 .properties 설정 자동 변환.

확인이 필요한 항목

화면 크기·GUI 배율별 설정 위젯 겹침, 드래그 조작, 선택 의존성 Mod Menu의 실제 호환성, 커스텀 리소스팩 아이콘·이름 표시를 확인해야 합니다. 습득 패킷을 다르게 처리하는 서버나 다른 HUD·패킷 관련 모드와의 조합도 실제 환경 검증이 필요합니다.

확인 범위

2026-10-05 소스 확인 기준이며 게임 내 동작은 미검증입니다. 이 문서의 대응 방법은 소스 조건에 따른 점검 안내이고, 실제 재현·수정 완료를 의미하지 않습니다.