BuzzBuild-Title — 사용법

설치와 권한 구성을 마친 운영자·이용자를 위한 절차입니다. 다음은 소스에서 확인한 흐름이며 게임 내 동작은 미검증입니다.

1. 관리자: 텍스트 칭호 만들기

1. 게임에서 /bbtitle title editor를 실행합니다. 관리자 권한과 MCEF Modern이 필요합니다.
2. 내부 ID를 dawn_companion처럼 입력합니다. 표시 이름에는 여명의 동행자처럼 실제 목록에 보일 문구를 입력합니다. ID와 표시 이름은 별도입니다.
3. 종류를 완성형·접두·접미 중 선택하고 등급을 정합니다. 새 화면 기본값은 완성형·전설입니다.
4. 표현 방식을 텍스트로 두고, 색상·굵게·기울임·밑줄·그라데이션 도구를 사용합니다. 선택한 범위가 없으면 전체에 적용됩니다. MiniMessage 원문도 입력할 수 있으나 웹 미리보기가 모든 태그를 재현하지는 않습니다.
5. 설명을 입력하고 저장합니다. 설명은 안내 문구이며 자동 획득 조건을 실행하지 않습니다.
6. 저장 성공 안내를 확인합니다. 실패하면 입력은 유지됩니다. 기존 정의는 /bbtitle title editor dawn_companion으로 다시 편집하며 기존 ID는 화면에서 변경하지 않습니다.

정의 생성과 플레이어 소유권 부여는 별도 작업입니다. OP 전체 지급 설정이 켜져 있으면 관리자는 동기화 과정에서 모든 정의를 보유할 수 있습니다.

2. 관리자: 이미지 칭호 만들기

1. Nexo에 실제 글리프를 등록하고 클라이언트가 해당 리소스팩을 받도록 준비합니다.
2. 에디터에서 표현 방식을 이미지로 바꿉니다. 표시 이름은 이미지 모드에서도 입력합니다.
3. Nexo ID로 검색해 이미지를 클릭하거나 미리보기로 끌어놓습니다.
4. 이미지 높이(864)와 위치(-4848)를 조정합니다. 위치가 음수면 닉네임 쪽으로 내려갑니다.
5. 저장하고 장착한 뒤 머리 위·목록·채팅·탭을 각각 확인합니다.

표시 위치	동작
머리 위	이미지 위, 닉네임 아래의 두 줄; 이미지 행은 배경·그림자 없이 제출
칭호 목록·채팅·탭	이미지의 표시 이름을 텍스트로 사용
에디터	웹 미리보기; 현재 플레이어 캐릭터 렌더링은 보류 상태

접두·접미 중 이미지 칭호가 하나라도 있으면 머리 위 행에는 이미지 정의만 합성합니다. 텍스트 칭호를 이미지 옆에 추가하지 않습니다. 여러 이미지의 높이·간격은 장착 정의의 최대값을 사용합니다. 미리보기 닉네임과 확대 비율은 미리보기용이며 실제 닉네임 변경 기능이 아닙니다.

3. 지급·회수

가상의 온라인 플레이어에게 다음처럼 실행합니다.

/bbtitle grant ExamplePlayer dawn_companion
/bbtitle revoke ExamplePlayer dawn_companion

대상은 로그인한 정확한 플레이어 이름으로 조회합니다. 지급할 ID는 기존 카탈로그에 있어야 합니다. 회수 시 관련 장착도 갱신합니다. 지급·회수·적용 이력은 DB에 기록됩니다. OP 전체 지급을 켜 둔 서버에서는 회수 후 다시 지급될 수 있습니다.

4. 이용자: 장착과 해제

1. /칭호 또는 기본 P 키로 목록을 엽니다.
2. 항목을 눌러 설명과 미리보기를 확인합니다. 미보유 항목을 선택해도 장착 선택은 되지 않습니다.
3. 완성형 하나 또는 접두·접미 조합을 선택합니다. 완성형 선택과 조합 선택은 서로 해제됩니다.
4. 적용 버튼을 눌러 서버 결과를 확인합니다. 적용 성공 시 장착음이 나도록 서버 기본 설정이 지정되어 있습니다.
5. 해제 버튼을 눌러 장착을 비웁니다. 성공 시 해제음이 재생됩니다.

목록 항목에는 클릭음, 실제 목록 이동에는 스크롤음이 있습니다. 스크롤음은 과도한 중첩을 줄이기 위해 60ms 간격으로 제한됩니다. 목록 끝에서 이동하지 않으면 소리도 내지 않습니다.

5. 통계와 외부 연동

/bbtitle stat ExamplePlayer exploration 5
/통계

통계 변경은 지정한 키의 증감입니다. 이 플러그인의 이벤트 리스너에서 채광·전투 등 모든 게임 행동을 자동 계수하는 구현은 확인되지 않았습니다. 별도 시스템이 명령이나 ProfileApi로 값을 제공해야 합니다.

다른 서버 플러그인은 등록된 ProfileApi, PlayerIdentity, TitleRewardApi를 사용할 수 있습니다. TitleRewardApi.grantTitleOnce(player, title, key)는 서버 메인 스레드에서 호출해야 하고 실제 저장은 작업 스레드에서 수행합니다. 결과는 DELIVERED, ALREADY_DELIVERED, UNKNOWN_TITLE이며 저장소 불가 시 예외로 완료됩니다. 이것은 서비스 API이며 이용자 명령어가 아닙니다.

PlaceholderAPI 변수는 명령어·권한을 참고하세요. 다른 채팅·탭 플러그인과 병용할 때는 %buzzbuild_display%를 표시명 구성에 연결하고 중복 포맷을 점검합니다.

확인 범위

2026-10-05 에디터 자산, 선택 화면, 저장·지급·장착 서비스, 통계 및 연동 코드 확인. 게임 내 동작은 미검증이며 소리·리소스팩·다른 모드와의 조합은 운영 환경에서 확인해야 합니다.