BuzzBuild-Chat — 명령어·권한

Paper 서버 명령어

plugin.yml에 등록된 명령어는 세 개이며, 별도 서버 별칭은 없습니다. <...>는 필수 인자이고 대괄호는 선택 인자입니다. 아래 예시의 ExamplePlayer는 가상 로그인 이름입니다.

문법	기능	권한	기본 허용	콘솔
`/귓속말 <플레이어> <메시지>`	온라인 대상과 발신자에게 귓속말 표시	`buzzbuild.chat.use`	`true`	불가: 플레이어 전용
`/bbchatmark <achievement\|system> <플레이어\|*> <메시지>`	업적 또는 시스템 마커 메시지 전송	`buzzbuild.chat.mark`	`op`	가능: 권한 검사 적용
`/bbchat reload`	서버 `config.yml` 다시 읽기	`buzzbuild.chat.admin`	`op`	가능: 권한 검사 적용

default: true는 기본적으로 모든 플레이어에게 허용한다는 뜻이며 권한 관리 도구로 거부할 수 있습니다. op는 기본 OP 권한입니다. mark·admin은 명령 메타데이터와 실행 코드에서 검사하고, use는 귓속말 실행 코드에서 검사합니다.

/귓속말 ExamplePlayer 안녕하세요
/bbchatmark achievement ExamplePlayer 첫 임무를 완료했습니다
/bbchatmark system * 안내 메시지입니다
/bbchat reload

콘솔에서는 다음처럼 / 없이 사용합니다.

bbchatmark system ExamplePlayer 안내 메시지입니다
bbchat reload

서버 대상은 온라인 로그인 이름을 사용합니다. 표시명이나 닉네임으로 조회하는 명령이 아닙니다.
/귓속말은 자기 자신에게 보낼 수 없고 오프라인 메시지를 저장하지 않습니다. 대상 이후 인자를 공백으로 이어 메시지로 사용합니다.
/귓속말의 대상 자동 완성은 자신을 제외한 온라인 이름을 접두어로 검색합니다.
/bbchatmark는 achievement, system 두 타입만 처리합니다. *는 현재 온라인인 모든 플레이어입니다. 타입과 대상 이름·* 자동 완성이 있습니다.
/bbchat reload는 서버 설정만 갱신합니다. 클라이언트 JSON, 플러그인 JAR, 의존성은 갱신하지 않습니다.

아래 입력은 Chat 클라이언트가 채팅 입력 단계에서 가로챕니다. Paper 명령 별칭이 아니며 콘솔에서는 동작하지 않습니다. 단축어 자체에 별도 권한 노드는 없지만 실제 전송되는 서버 귓속말 명령의 권한은 필요합니다.

입력	동작	예시
`/귓 [플레이어]`	귓속말 탭을 열고 받는 사람 설정. 생략하면 기억된 귓속말 대상 사용	`/귓 ExamplePlayer`
`/답 [플레이어]`	귓속말 탭 열기. 생략하면 기억된 수신 상대 사용	`/답 ExamplePlayer`

입력 후 Enter를 누르면 귓속말 작성 상태로 전환하며 메시지를 즉시 보내지 않습니다. /귓 ExamplePlayer 안녕처럼 메시지를 함께 붙이는 문법은 지원하지 않습니다. 나머지 전체가 대상 입력으로 취급됩니다.

/답의 자동 대상은 클라이언트가 발신자를 파싱했을 때만 사용할 수 있습니다. 현재 기본 Paper 귓속말 포맷은 상대 기억 갱신을 건너뛰는 경로가 있어, 대상이 채워지지 않으면 이름을 직접 입력해야 합니다.

키	적용 위치·동작
`F10`	Chat 설정 화면 열기
`F6`	포커스된 지원 `EditBox`에서 강제 두벌식 입력 ↔ OS IME 자동 입력 전환
`Shift+Tab`	메시지 입력이 `/`로 시작하지 않을 때 채팅 분류 전환. 받는 사람 입력란에서는 메시지 입력란으로 이동
`Tab`	받는 사람 입력란에서 추천 대상 완성
`Enter` / `Space`	받는 사람 입력란의 대상을 확인하고 메시지 입력란으로 이동
`Backspace`	귓속말 메시지가 비었을 때 받는 사람 입력란으로 복귀
`Enter`	메시지 전송 또는 입력 단축어 처리

한글 조합 중에는 조합 보호 처리가 일반 키·마우스 처리를 막을 수 있습니다. 조합 확정 또는 취소 후 조작합니다. F6은 OS 전체 한영 상태를 전환하는 키가 아니며 현재 입력란 범위의 보조 기능입니다.

2026-10-05 기준 명령 메타데이터·실행기·권한 검사·클라이언트 입력 분기를 확인했습니다. 권한 플러그인과의 실제 조합 및 게임 내 동작은 미검증입니다.