BuzzBuild-Title — 문제 해결
2026-10-05 소스 확인 기준입니다. 게임 내 동작은 미검증이므로 아래 항목은 점검 절차이지 해당 환경에서 해결을 확인했다는 뜻이 아닙니다.
증상별 점검
섹션 제목: “증상별 점검”| 문제 | 확인 방법 | 해결·다음 조치 |
|---|---|---|
| 플러그인이 활성화되지 않음 | 서버 로그에서 필수 의존성·서비스 누락, Java/API 버전 확인 | Framework·Nickname과 Java 25, 대상 Paper 버전 확인; DB 설정은 Framework에서 점검 |
| 에디터 열기 안내만 나오고 화면 없음 | 클라이언트 모드·MCEF Modern 설치와 로그 확인 | 서버와 클라이언트 배포 버전을 맞추고 각각 재시작; 구형 Profile 모드 중복 제거 |
| 저장 시 403 | 클라이언트 로그의 session_token, origin_mismatch 등 확인 | 에디터를 닫고 게임 명령으로 다시 열어 새 세션 사용; 외부 브라우저의 이전 주소 재사용 금지; 토큰/Origin 검사를 끄지 않음 |
| 저장 실패·DB 미준비 | Framework DB 준비 로그, 서버 오류 확인 | DB 연결·테이블 마이그레이션 확인; YAML 모드도 소유권·장착 저장은 DB 필요 |
| YAML 수정이 반영되지 않음 | titles-storage.mode와 동일 ID의 DB 등록 확인 | DB 모드의 기존 ID는 에디터로 변경; YAML 시드는 누락 ID만 가져오는 구조 |
| 한영 전환·단축키·드래그 문제 | 게임과 모드 버전, 클라이언트 입력 초기화 로그 확인 | 최신 모드에서 재현 확인; 운영체제 IME·MCEF 조합 및 포커스 상태 별도 점검 |
| 입력이 늦게 반응함 | 슬라이더·마우스·키 입력 모두 지연되는지 구분 | 현재 코드는 미전송 연속 마우스 이동을 병합; 이전 모드 여부와 MCEF 초기화·입력 실패 로그 확인 |
| 이미지 확대가 멈춤 | 높이 값 저장 여부와 클라이언트 버전 확인 | 현재 높이 범위 8~64, 머리 위·미리보기의 예전 최대 너비 제한은 제거됨; 서버 저장 실패 여부도 확인 |
| 이미지가 없거나 미리보기 없음 | Nexo ID, 활성 리소스팩 PNG, 이미지 제한 확인 | 같은 글리프가 리소스팩에 포함돼 있는지 확인; 복합·애니메이션 글리프는 미리보기 제한 |
| 이미지 위에 문구가 중복되거나 정렬이 어긋남 | 서버 플러그인·클라이언트 모드 모두 업데이트했는지 확인 | 모드만 교체하지 말고 서버도 맞춤; 다른 이름표 모드·플러그인과 글리프 경계 별도 검증 |
| 탭에 이미지가 표시됨 | 이전 Title 모드나 별도 탭 플러그인의 포맷 확인 | 현재 Title은 서버 텍스트 표시명을 쓰며 이미지 탭 믹스인은 없음; 외부 포맷에서 글리프 삽입 확인 |
| 대괄호가 계속 보임 | 기존 display.title-open, display.title-close, 표시 문구 자체 확인 | 설정을 "", " "로 변경; 직접 입력한 대괄호나 외부 채팅 포맷은 별도로 제거 |
| 장착·해제 소리가 없음 | sounds.title-apply.key, sounds.title-unequip.key가 빈 값인지 확인 | 새 기본값이 기존 파일에 자동 반영되지 않으므로 사운드 키 지정; 음량과 클라이언트 MASTER 설정 확인 |
| 클릭음·스크롤음이 없음 | 일반 칭호 목록인지, 실제 목록이 이동했는지 확인 | 해당 소리는 클라이언트 코드에 있음; 서버 사운드 설정으로 제어하지 않음 |
| 회수한 칭호가 다시 생김 | OP 여부와 titles.op-grant-all 확인 | 전체 지급 동기화를 끄거나 일반 사용자 권한으로 검증 |
| 채팅·탭이 로그인명으로 바뀜 | 다른 채팅·탭 플러그인의 덮어쓰기 확인 | %buzzbuild_display% 연결 및 중복 포맷 담당 조정; Title은 AsyncChatEvent 렌더러를 설정함 |
| UI 좌표 설정이 초기화됨 | JSON layoutVersion과 파싱 오류 확인 | 현재 버전은 3; 이전 버전은 기본값으로 재작성, 잘못된 JSON은 기본값 사용 |
/bbtitle nick이 자동완성되지만 실행 안 됨 | 명령 실행 분기 확인 | 미지원 잔여 자동완성임; 닉네임은 별도 Nickname 플러그인 사용 |
지원 범위와 제한
섹션 제목: “지원 범위와 제한”- Paper 서버 플러그인과 Fabric 클라이언트를 대상으로 합니다. 바닐라 클라이언트에서 전용 화면·머리 위 두 줄 기능이 동작한다고 보장하지 않습니다.
- 이미지 목록은 활성 리소스팩의 단일 PNG 미리보기를 대상으로 하며 파일당 2 MiB, 화면당 총 32 MiB 읽기 제한이 있습니다. 복합·애니메이션 글리프는 충실한 미리보기를 제공하지 않습니다.
- 현재 에디터에서 접속 캐릭터 3D 렌더링은 비활성입니다. 웹 미리보기는 실제 게임 글꼴·기준선·크기와 차이가 날 수 있습니다.
- 에디터는 게임 클라이언트의 임시 로컬 HTTP 서버와 MCEF를 사용합니다. 인터넷에 배포하는 관리자 사이트가 아니며 Cloudflare Pages에 에디터를 올리는 구조가 아닙니다.
- Nexo 이외 이미지 제공자의 전용 연동, 칭호 정의 삭제 명령, 오프라인 대상 관리 명령, 설명 문구만으로 자동 지급하는 조건 엔진은 확인되지 않았습니다.
/bbtitle reload는 설정 갱신이며 서버·모드 바이너리 교체를 대신하지 않습니다. 서버 전체 reload는 사용하지 않습니다.
추가 확인이 필요한 항목
섹션 제목: “추가 확인이 필요한 항목”IME·키보드 조합, 다양한 GUI 배율의 드래그, 실제 글리프의 중앙 정렬, 다른 이름표·탭·채팅 플러그인과의 우선순위, DB 장애 시 복구·마이그레이션, 리소스팩 적용과 소리 재생은 게임 내 검증이 필요합니다. 오류를 전달할 때는 모드·플러그인 버전, 재현 단계, 민감정보를 지운 관련 로그를 함께 준비하세요.