BuzzBuild-Chat — 설치
채팅 HUD와 한글 입력은 클라이언트 모드 기능입니다. 서버에 Paper 플러그인만 넣어서는 클라이언트 UI가 설치되지 않습니다. 서버 귓속말·분류 메시지까지 사용하려면 양쪽 구성을 준비합니다.
설치 파일과 위치
섹션 제목: “설치 파일과 위치”아래 경로는 각각 서버 폴더 또는 실제 사용하는 게임 인스턴스를 기준으로 합니다.
| 대상 | 파일 | 위치 |
|---|---|---|
| Paper 서버 | BuzzBuild-Chat-Paper-0.1.4.jar | plugins/ |
| Paper 서버 | 호환되는 BuzzBuild-Framework Paper 배포 JAR | plugins/ |
| Fabric 클라이언트 | BuzzBuild-Chat-Fabric-0.1.4.jar | mods/ |
| Fabric 클라이언트 | 호환되는 BuzzBuild-Framework Fabric 배포 JAR | mods/ |
| Fabric 클라이언트 | Fabric API | mods/ |
sources, 테스트·verification JAR은 배포용 파일이 아닙니다. 서버 플러그인과 클라이언트 모드 파일을 서로 바꾸어 설치하지 않습니다.
설치 전 확인
섹션 제목: “설치 전 확인”- Minecraft
26.1.2, Java25, Paper/Fabric 구성을 지원 환경과 대조합니다. - 클라이언트의 Fabric Loader는
0.19.3이상이어야 합니다. 현재 빌드 기준 Fabric API는0.155.2+26.1.2입니다. - Framework를 각 플랫폼에 맞게 준비합니다. 서버는 Framework의 메시징·기능 레지스트리 서비스가 초기화되어야 합니다.
- 같은 인스턴스에 Chat의 이전 JAR이 중복되지 않았는지 확인합니다.
- 클라이언트의
imblocker,koreanpatch,hangul,hangeul을 함께 사용하지 않습니다. 로더의 충돌 선언 대상입니다. 별도 Hangul/KoreanPatch 또는 BlazeSDL 병용 구성을 추가하는 설치 절차는 없습니다.
운영 중인 서버의 JAR 교체·활성화 시점은 운영자가 정한 점검 절차에 따릅니다. /bbchat reload는 JAR을 새로 로드하는 명령이 아닙니다.
최초 실행과 생성 파일
섹션 제목: “최초 실행과 생성 파일”| 파일 | 생성 시점 | 역할 |
|---|---|---|
plugins/BuzzBuild-Chat/config.yml | Paper 플러그인 활성화 시 기본 리소스 저장 | 서버 마커, 귓속말 문구, 안내 문구 |
config/buzzbuild-chat.json | Fabric 클라이언트 초기화 시 읽기·저장 | 개인 HUD, 분류 마커, 귓속말 명령 이름 |
Chat 자체 DB 생성이나 DB 접속 설정 단계는 없습니다. Framework 자체 설치 요구 사항은 Framework 문서를 따릅니다.
설치 후 운영자가 정상 실행한 환경에서 다음을 확인합니다.
- 로더·서버 로그에 의존성 누락이나 Mixin 적용 오류가 없는지 확인합니다.
- 클라이언트에서 채팅을 열어 탭과 입력란을 확인하고,
F10으로 설정 화면을 엽니다. - 온라인 테스트 계정 두 개로
/귓속말 ExamplePlayer 안녕하세요를 확인합니다.ExamplePlayer는 가상 예시이며 실제 온라인 로그인 이름으로 바꿉니다. - 권한이 있는 계정에서
/bbchatmark system ExamplePlayer 분류 확인을 보내 전체·시스템 탭 분류를 확인합니다. - 한글 조합 중 표시, 조합 확정, 한영 전환 뒤 이동·인벤토리·단축키를 별도로 확인합니다. 점검 순서는 문제 해결에 있습니다.
설정 적용
섹션 제목: “설정 적용”- 서버 YAML: 파일을 수정한 뒤
buzzbuild.chat.admin권한으로/bbchat reload를 실행합니다. 마커·포맷·안내 문구를 다시 읽습니다. 콘솔에서는 앞의/를 생략합니다. - 클라이언트 화면 설정:
F10또는 채팅 패널 설정 버튼에서 변경한 뒤 완료로 닫습니다. 슬라이더·탭 순서 등 일부 조작은 즉시 저장됩니다. - 클라이언트 JSON 직접 편집: 게임을 종료한 상태에서 백업 후 편집하고 클라이언트를 다시 실행합니다. 별도 JSON 다시 읽기 명령은 없습니다. 실행 중 편집하면 UI 저장으로 덮어써질 수 있습니다.
- 마커 변경: 서버
markers.*와 클라이언트의 대응 마커를 함께 맞춥니다. 키 이름은 서로 다르므로 설정 대응표를 확인합니다.
확인 범위
섹션 제목: “확인 범위”2026-10-05 기준 빌드 산출물 이름, 의존성 선언과 설정 생성·다시 읽기 코드를 확인했습니다. 설치·서버 실행·재시작·전체 reload는 수행하지 않았으며 게임 내 동작은 미검증입니다.