BuzzBuild-Chat — 사용법

아래 절차는 소스로 확인한 입력·표시 흐름입니다. 실제 화면과 OS IME별 동작은 별도 확인이 필요합니다.

채팅 읽기와 일반 메시지

1. Minecraft의 채팅 열기 키로 입력 화면을 엽니다.
2. 탭을 눌러 표시할 분류를 선택합니다. 메시지 입력이 /로 시작하지 않으면 Shift+Tab으로도 분류를 바꿀 수 있습니다.
3. 일반 탭에서 메시지를 작성하고 Enter로 전송합니다. /로 시작하는 입력은 일반 모드에서 서버 명령으로 처리합니다.
4. 패널 안에서 마우스 휠로 이전 메시지를 확인합니다. 스크롤 위치는 분류별로 관리합니다.

탭	표시 대상
전체	보관 중인 모든 분류
일반	플레이어 일반 채팅으로 분류된 메시지
귓속말	귓속말 마커 메시지
도전과제	도전과제 문구·패턴으로 분류된 메시지
시스템	시스템 분류와 도전과제 분류

별도 업적 탭은 없습니다. 서버가 achievement 마커로 보낸 메시지는 전체에서 확인합니다. 보관 개수는 maxMessages의 영향을 받으며 영구 기록이 아닙니다.

귓속말 보내기

1. 일반 입력에서 /귓 ExamplePlayer를 입력하고 Enter를 누르거나 귓속말 탭을 선택합니다.
2. 받는 사람 칸에 온라인 로그인 이름을 입력합니다. 추천 목록·Tab 완성을 사용할 수 있습니다.
3. 받는 사람 칸에서 Enter 또는 Space로 메시지 입력란으로 이동합니다.
4. 본문을 작성하고 Enter를 누릅니다. 클라이언트가 기본적으로 귓속말 <대상> <본문> 서버 명령을 전송합니다.
5. 상대를 바꾸려면 받는 사람 칸을 선택합니다. 본문이 비었을 때 Backspace로도 돌아갈 수 있습니다.

부분 이름 추천은 입력을 돕는 기능입니다. 전송 시 온라인 이름을 확인하며, 후보가 여러 개면 정확한 이름을 선택해야 합니다. 자기 자신에게는 보낼 수 없습니다. 대상 또는 본문이 비었을 때는 전송하지 않고 입력 화면이 닫힐 수 있습니다.

귓속말 탭에서 /로 시작하는 본문은 귓속말 내용으로 처리됩니다. 서버 명령을 실행하려면 일반 입력으로 전환합니다.

수신 상대가 기억된 경우 /답으로 작성 상태를 열 수 있습니다. 현재 기본 서버 포맷에서는 자동 상대 기억이 누락될 수 있으므로, 빈 대상이면 /답 ExamplePlayer 또는 받는 사람 직접 입력을 사용합니다. 이 단축어들은 메시지를 즉시 전송하지 않습니다.

패널과 개인 설정

1. 채팅을 연 상태에서 버튼·탭이 아닌 상단 헤더의 빈 부분을 드래그해 패널을 옮깁니다.
2. 오른쪽 위·아래 모서리의 크기 조절 영역을 드래그합니다. 설정의 최소·최대 크기가 적용됩니다.
3. 최소화 버튼으로 접고, 최소화 막대를 클릭해 다시 펼칩니다.
4. F10 또는 패널 설정 버튼으로 설정 화면을 엽니다.
5. 불투명도·유지 시간·귓속말 색상을 조절하고 탭의 위·아래 버튼으로 순서를 바꿉니다. 완료로 닫아 저장합니다.

마우스로 위치·크기를 바꾼 뒤 버튼을 놓으면 저장됩니다. 초기화 버튼의 범위와 파일 편집 방법은 설정을 참고하세요.

한글 입력과 검색

기본 입력은 OS IME를 사용합니다. 일반 한영 전환을 사용해 입력하고, 조합 중인 글자와 확정된 글자가 입력란에서 어떻게 표시되는지 구분해 확인합니다. 조합 중 클릭·Enter 처리를 보호하는 코드가 있으므로, 다른 입력란이나 탭으로 옮길 때는 조합을 먼저 확정하거나 취소합니다.

지원되는 단일 입력란에서 보조 입력이 필요하면 F6을 눌러 **강제 한글 [가]**로 전환할 수 있습니다. 다시 F6을 누르면 **자동 입력 [IME]**로 돌아갑니다. 강제 입력은 현재 입력란·화면에 묶인 두벌식 조합 기능이며 모든 커스텀 입력 UI를 지원한다는 뜻은 아닙니다.

검색 색인에는 한글 초성을 추가합니다. 예를 들어 한국어 이름이 색인된 항목은 초성으로 검색할 수 있고, 영문 자판 상태로 입력한 두벌식 키도 한글 검색 후보로 변환합니다. 여러 검색어의 보조 교집합 처리와 명령어 추천 보정 코드도 포함되어 있습니다. 서버 명령을 새로 만들거나 번역 사전을 제공하는 기능은 아닙니다.

Windows에서는 한글 입력 상태에서도 물리 키를 복구하는 코드가 있습니다. 이동뿐 아니라 인벤토리·단축키 입력을 다루지만, 실제 OS IME와 다른 모드 조합에서의 정상 동작은 아직 검증하지 않았습니다.

운영자 분류 메시지

1. buzzbuild.chat.mark 권한을 확인합니다.
2. 아래처럼 온라인 대상 또는 전체 온라인 플레이어에게 메시지를 보냅니다.
3. 시스템 메시지는 전체·시스템에서, 업적 마커 메시지는 전체에서 확인합니다.

/bbchatmark system ExamplePlayer 안내 메시지입니다
/bbchatmark system * 전체 안내입니다
/bbchatmark achievement ExamplePlayer 임무를 완료했습니다

서버의 ChatApi는 sendAchievement(UUID, String), sendSystem(UUID, String), broadcastSystem(String)을 제공합니다. UUID 대상 메서드는 온라인 대상에게만 전송합니다. Framework 메시징의 feature: chat, op: mark 수신 경로에도 buzzbuild.chat.mark 권한 검사가 있습니다. 다른 플러그인의 자동 연동은 해당 플러그인이 이 API나 메시지를 실제 사용하는지 추가 확인해야 합니다.

확인 범위

2026-10-05 기준 채팅 저장·분류, 입력 화면·HUD·설정 화면, 한글 입력·검색 및 서버 전송 코드를 확인했습니다. 이 문서의 절차를 실제 게임에서 실행하지 않았으며 게임 내 동작은 미검증입니다.