BuzzBuild-Title — 개요

BuzzBuild-Title은 Paper 서버에서 칭호와 장착 상태를 저장하고, Fabric 클라이언트에서 칭호 선택 화면과 MCEF 관리자 에디터를 제공하는 플러그인·모드 구성입니다. 내부 패키지와 통신 기능 이름에는 이전 이름인 profile이 남아 있습니다.

핵심 기능

완성형(complete) 또는 접두·접미(prefix·suffix) 칭호를 지급·회수·장착합니다. 완성형과 접두·접미의 동시 장착은 거부됩니다.
관리자 에디터에서 내부 ID와 표시 이름, 종류, 등급, 설명, Nexo 이미지, 이미지 높이·위치를 편집합니다.
머리 위에는 칭호와 닉네임을 두 줄로 표시합니다. 이미지 칭호가 포함되면 이미지 행에는 이미지들만 합성합니다.
채팅과 탭에는 읽을 수 있는 칭호 표시 이름을 사용합니다. 기본 자동 대괄호는 없으며 칭호와 닉네임 사이에 공백을 넣습니다.
장착·해제 성공음과 목록 클릭·스크롤 소리를 제공합니다.
통계 화면, 관리자 통계 증감, PlaceholderAPI 확장과 다른 플러그인을 위한 서비스 API를 제공합니다. 플레이만으로 모든 통계를 자동 수집하는 기능은 확인되지 않았습니다.

아래 값은 현재 소스의 빌드 대상 또는 메타데이터 요구사항입니다. 다른 버전의 호환성을 보증하지 않습니다.

항목	확인 값
프로젝트 버전	`0.1.0`
Minecraft	`26.1.2`
서버	Paper API `26.1.2.build.69-stable`, `api-version: '26.1.2'`
Java	빌드 도구 체인 `25`; 클라이언트 요구사항 `>=25`
Fabric Loader	빌드 대상 `0.19.3`; 메타데이터 `>=0.19.3`
Fabric API	빌드 대상 `0.155.2+26.1.2`; 메타데이터는 버전 제한 없는 필수 의존성
MCEF Modern	클라이언트 필수, `>=0.3.2`

위치	필수/선택	구성 요소	역할
서버	필수	BuzzBuild-Framework	DB 풀, 테이블 마이그레이션, 메시징, 기능 레지스트리
서버	필수	BuzzBuild-Nickname	`NicknameApi` 및 변경 알림
클라이언트	필수	BuzzBuild-Framework, Fabric API, MCEF Modern	통신과 게임 내 에디터
서버	선택	Nexo	칭호 이미지와 등급 마커 글리프 조회
서버	선택	PlaceholderAPI	`%buzzbuild_*%` 확장
서버	조건부 연동	CMI	설치 여부 확인 후 탭 갱신 호출; 필수 의존성은 아님

칭호 정의를 YAML로 관리해도 보유·장착·히스토리·통계 저장에는 Framework DB가 필요합니다. 이미지는 클라이언트가 받은 활성 리소스팩에 있어야 합니다. 구형 클라이언트 모드 ID buzzbuild_profile과는 동시 설치할 수 없습니다.

설치 → 설정 → 사용법 순서로 확인하세요. 관리 명령은 명령어·권한, 오류 점검은 문제 해결에서 다룹니다.

2026-10-05에 Gradle, 메타데이터, 명령 실행·권한 검사, 기본 설정, 저장소, 이벤트, 클라이언트와 연동 코드를 대조했습니다. 게임 내 동작은 미검증입니다. 이번 문서 작업에서는 서버 실행, 플러그인·위키 빌드, 배포를 하지 않았습니다.