BuzzBuild-Title — 설치

서버 관리자와 모드팩 관리자를 위한 문서입니다. 지원 환경에 맞는 서버·클라이언트를 함께 준비하세요.

파일 배치

위치	파일 또는 구성
서버 `plugins/`	`BuzzBuild-Title-Paper-0.1.0.jar`, Framework와 Nickname 서버 플러그인
클라이언트 `mods/`	`BuzzBuild-Title-Fabric-0.1.0.jar`, Framework 클라이언트 모드, Fabric API, MCEF Modern
서버 `plugins/BuzzBuild-Title/`	최초 실행 시 생성되는 `config.yml`, `titles.yml`, `titles/`
클라이언트 `config/`	`buzzbuild-profile-title-ui.json` — 일반 칭호 선택 화면의 좌표 설정

Paper JAR를 클라이언트에 넣거나 Fabric JAR를 서버 플러그인 폴더에 넣지 마세요. 이전 buzzbuild_profile 모드와 새 buzzbuild_title 모드를 함께 두지 않습니다.

최초 구성

Framework의 DB와 필수 서비스를 준비합니다. Title에 DB 주소·계정 설정을 중복 작성하지 않습니다.
Nickname을 설치합니다. Title은 시작 중 NicknameApi를 요구합니다.
Title 서버 플러그인과 클라이언트 모드를 설치합니다. 이미지 칭호를 쓰려면 서버에 Nexo를 설치하고 사용 글리프가 들어 있는 리소스팩을 배포합니다.
운영자가 서버를 시작하면 Title이 기본 설정·시드 파일을 만들고, Framework를 통해 테이블 마이그레이션을 적용합니다.
기본 titles-storage.mode: database를 유지할지 결정합니다. 기본값에서는 YAML 시드를 DB에 가져오되, DB에 이미 있는 ID의 정의는 시드로 덮어쓰지 않습니다.
관리 권한으로 에디터를 열고 일반 플레이어의 목록·장착·채팅·탭을 확인합니다. OP는 기본 설정상 모든 칭호를 지급받으므로 일반 이용자 권한 검증과 분리하세요.

이 문서 작성 중 위 절차를 실행하지 않았습니다.

기존 설치에서 업데이트

설정, 칭호 파일, DB를 백업한 뒤 서버 플러그인과 클라이언트 모드를 같은 배포 묶음으로 맞춥니다. 파일 교체는 운영자가 서버를 정상 중지한 상태에서 하거나 서버의 업데이트 절차를 따릅니다. 서버 JAR 교체 후에는 서버 재시작, 클라이언트 JAR 교체 후에는 게임 재시작이 필요합니다.

/bbtitle reload는 Title의 설정·카탈로그·캐시를 다시 읽고 온라인 사용자 스냅샷을 갱신하는 명령입니다. JAR나 모드를 새로 로드하는 기능이 아닙니다. 서버 전체 /reload를 적용 절차로 사용하지 않습니다.

기존 config.yml이 있으면 새 기본 파일이 덮어쓰지 않습니다. 대괄호나 사운드 기본값이 바뀌었어도 기존 값이 남을 수 있으므로 설정과 대조하세요.

이전 Profile 데이터

서버의 이전 plugins/BuzzBuild-Profile/ 폴더가 있고 이전 완료 표식이 없으면, Title 폴더에 없는 파일만 복사하고 .profile-migrated 표식을 만듭니다. 기존 Title 파일은 덮어쓰지 않습니다. 내부 DB 이름은 계속 bb_profile_*를 사용합니다. 기존 DB를 이름만 보고 삭제하거나 변경하지 마세요.

확인 범위

2026-10-05 소스 확인. 자동 파일 생성·마이그레이션 호출과 설치 의존성을 확인했으며 게임 내 동작은 미검증입니다. 실제 운영 DB 마이그레이션과 리소스팩 배포는 별도 검증이 필요합니다.