BuzzBuild-Esc — 명령어·권한

운영 명령어

등록된 기본 명령은 이스크, 별칭은 bbesc, esc입니다. 아래 명령 모두 서버 콘솔에서 실행할 수 있으며, 콘솔에서는 선행 /를 생략합니다. 플레이어 전용 검사나 대상 플레이어 인자는 없습니다.

문법	영문 하위 명령	동작	콘솔
/이스크	없음	로드된 메뉴·그룹·항목 수와 통신 채널 표시	가능
/이스크 상태	status	기본 명령과 같은 상태 표시	가능
/이스크 리로드	reload	설정·메뉴 재로드 후 온라인 전체에 update 전송	가능
/이스크 동기화	sync	현재 로드된 메뉴를 온라인 전체에 open 재전송	가능

영문 reload, sync는 대소문자를 구분하지 않습니다. 상태, status는 별도 분기 없이 기본 상태 표시 경로를 사용하며, 알 수 없는 하위 명령도 상태 표시로 처리됩니다. 추가 인자는 읽지 않습니다. 상태의 개수는 전송 중인 주 메뉴만이 아니라 로드된 전체 메뉴의 합계입니다.

/이스크 상태
/bbesc reload
/esc sync

콘솔 예시:

이스크 리로드

권한

노드	메타데이터 기본 허용	역할
buzzbuild.esc.admin	op	이스크 명령의 등록 권한. buzzbuild.esc.reload를 자식 권한으로 포함
buzzbuild.esc.reload	op	내부 명령 처리에서 허용 여부를 판단할 때 사용

plugin.yml의 명령 진입 권한은 **buzzbuild.esc.admin**입니다. 내부에서는 리로드뿐 아니라 상태·동기화·탭 완성에도 admin 또는 reload 중 하나를 허용합니다. 따라서 reload만 부여해도 명령을 사용할 수 있다고 보장할 수 없습니다. 등록 단계의 admin 권한 검사에 먼저 걸릴 수 있으므로 운영 명령 사용자는 admin을 기준으로 설정하세요.

서버 메뉴를 열거나 native 버튼을 누르는 데 필요한 별도의 ESC 권한 노드는 없습니다. command 클릭 처리에는 항목별 권한·해금 검사가 없습니다. 클릭된 ID가 현재 주 메뉴의 command 항목인지 확인한 뒤 서버 설정에 있는 명령을 실행합니다.

메뉴 버튼의 명령 실행

이는 새로운 ESC 명령 등록이 아니라, 메뉴 YAML의 commands 또는 command에 지정한 기존 서버 명령을 실행하는 기능입니다.

접두사	실행 주체	권한 동작
player:	클릭한 플레이어	플레이어의 현재 권한으로 performCommand
console:	서버 콘솔	콘솔 권한으로 dispatchCommand
op:	클릭한 플레이어	비OP 플레이어를 일시적으로 OP로 변경하여 실행
접두사 없음	commands.default-mode	배포 기본값은 op

인식하는 접두사만 제거합니다. 명령 앞의 /는 한 개 제거하며 %player%, %uuid%를 클릭한 플레이어의 이름과 UUID로 치환합니다. commands 목록을 순서대로 처리하고, 단일 command가 있으면 목록 뒤에 추가합니다.

commands:
  - 'player:help'

op: 실행 뒤에는 원래 비OP였고 아직 온라인인 플레이어의 OP를 해제합니다. 대상 명령이 실행 도중 연결을 종료시키는 경우까지 원복을 보장하는 구현은 아닙니다. 메뉴 명령은 서버 관리자가 신뢰하는 내용으로 구성하고, 일반 권한으로 충분한 항목에는 player:를 명시하세요. 클라이언트는 명령 문자열이 아닌 항목 ID만 전송합니다.

제공하지 않는 명령

클라이언트 전용 명령, 특정 플레이어만 동기화하는 인자, 메뉴 ID를 지정해 화면을 여는 명령, 해금 명령은 없습니다. 화면은 게임 안에서 ESC로 엽니다.

확인 범위

2026-10-05 기준 명령 등록, 실행 분기, 권한 노드, 버튼 명령 실행 코드를 확인했습니다. 게임 내 동작은 미검증이며, 권한 플러그인과의 실제 조합은 별도 확인이 필요합니다.