BuzzBuild-LootNotice — 설정

설정 파일

클라이언트의 config/buzzbuild-lootnotice.json을 사용합니다. 기본 설정 리소스를 복사하는 방식이 아니라 LootAlertConfig 필드 기본값으로 생성합니다. DB·서버 설정은 없습니다.

설정 키

키	타입	기본값	설명 및 보정 범위
configVersion	정수	4	설정 변환 버전. 사용자 조절용이 아님
offsetX	정수	84	화면 중앙에서 알림 바 왼쪽 끝까지 X 오프셋, -2000~2000
offsetY	정수	18	화면 중앙에서 알림 바 위쪽 끝까지 Y 오프셋, -1200~1200
scale	실수	1.0	HUD 배율, 0.5~1.8
barWidth	정수	160	배율 적용 전 바 너비, 100~340
maxAlerts	정수	3	최대 표시 개수, 1~5. 초과 시 가장 오래된 항목 제거
fadeInMs	정수	200	등장 페이드 시간(ms), 0~2000
fadeOutMs	정수	200	사라짐 페이드 시간(ms), 0~2000
durationMs	정수	2500	마지막 추가·병합 후 페이드 아웃 시작까지 시간(ms), 600~10000
slideDistance	정수	12	배율 적용 전 등장 이동 거리, 0~32
appearDirection	정수	2	0 아래→위, 1 위→아래, 2 좌→우, 3 우→좌
stackOrder	정수	1	0 내림차순(기준점 아래로), 1 오름차순(기준점 위로)
accentColor	정수	16777215	RGB 색상. 하위 24비트 사용, 0은 기본 흰색으로 보정
enabled	불리언	true	실제 알림 추가·표시 활성화
mergeSameItem	불리언	true	같은 ID와 컴포넌트 정보의 알림 수량 합산

양수 X는 오른쪽, 양수 Y는 아래쪽입니다. 좌표 보정은 고정 범위만 사용하므로 화면 해상도에 맞춰 자동으로 안쪽에 배치하지 않습니다. 새 알림은 목록 맨 앞과 기준점에 놓이며, 기존 항목이 정렬 방향으로 밀립니다.

durationMs에는 페이드 인 구간이 포함됩니다. 기본값에서는 마지막 추가·병합 후 약 2500ms부터 200ms 동안 사라집니다. fadeInMs가 0이면 등장 슬라이드도 생략합니다. 자연스러운 표시를 위해 페이드 인을 표시 시간보다 짧게 설정하세요.

띠 색상 버튼은 하늘 #26D9FF, 보라 #B865FF, 금색 #FFB23F, 초록 #56E38B, 분홍 #FF5E7A, 흰색 #FFFFFF를 순환합니다. JSON에는 #FFFFFF 문자열이나 0xFFFFFF 대신 십진수 정수를 적습니다.

최소 설정 예시

아래 예시는 나머지 필드에 클래스 기본값을 사용합니다. 저장하면 모든 필드가 기록됩니다.

{
  "configVersion": 4,
  "enabled": true,
  "offsetX": 84,
  "offsetY": 18,
  "maxAlerts": 3,
  "durationMs": 2500,
  "accentColor": 16777215
}

JSON에는 주석과 마지막 항목 뒤 쉼표를 넣지 마세요. 파일 직접 편집 후 적용 방법은 설치를 참고하세요.

기존 설정과 오류 복구

• 새 파일이 없으면 raon_drop_notice.json 복사를 먼저 시도합니다.
• configVersion이 2 미만이면 너비·이동 거리·등장 방향·색상을, 3 미만이면 정렬을 변환합니다.
• 4 미만이면 배율·너비·표시 개수·페이드·표시 시간·이동 거리·등장 방향·정렬·색상을 현재 기본값으로 바꾸고 버전 4로 저장합니다. 위치와 활성화·병합 값은 이 변환에서 유지됩니다.
• 이전 .properties 파일은 사용하지 않습니다.
• 읽기 또는 파싱 실패 시 기존 JSON을 buzzbuild-lootnotice.json.broken으로 이동하고 기본 설정 저장을 시도합니다. 같은 이름의 .broken은 덮어쓸 수 있습니다.
• 저장 시 I/O 오류를 별도 표시하지 않으므로, 재실행 후 설정이 돌아오면 파일과 폴더 쓰기 권한을 확인하세요.

확인 범위

2026-10-05 필드 초기값, load, clamp, save, HUD 시간 계산을 확인했습니다. 게임 내 동작은 미검증입니다.