BuzzBuild-Framework — 명령어·권한

모든 명령어의 명시적 별칭은 없습니다. Fabric에는 별도 명령어 없음이 확인되었습니다. 표의 <...>는 필수 인자, [...]는 선택 인자입니다. 콘솔에서는 선행 /를 제외합니다.

게이트 명령

문법	Velocity에서 실행	Paper에서 실행
`/bbwl on`	화이트리스트 켜기	같은 작업 요청 전달
`/bbwl off`	화이트리스트 끄기	같은 작업 요청 전달
`/bbwl add <플레이어 또는 UUID>`	허용 목록 추가	같은 작업 요청 전달
`/bbwl remove <플레이어 또는 UUID>`	허용 목록 제거	같은 작업 요청 전달
`/bbwl list`	상태·인원수·등록 항목 출력	Velocity에서 조회하라는 안내만 출력
`/bbmaint on`	점검 모드 켜기와 현재 접속자 재검사	같은 작업 요청 전달
`/bbmaint off`	점검 모드 끄기	같은 작업 요청 전달
`/bbmaint allow <플레이어 또는 UUID>`	점검 허용 목록 추가	같은 작업 요청 전달
`/bbmaint deny <플레이어 또는 UUID>`	점검 허용 목록 제거	같은 작업 요청 전달
`/bbmaint status`	점검·화이트리스트 상태와 점검 허용 인원수 출력	Velocity에서 조회하라는 안내만 출력

목록 인자는 계정 이름 또는 UUID입니다. 명령으로 입력한 이름은 소문자로 정규화되며 UUID는 표준 문자열로 정규화됩니다. 별도 계정 조회로 이름을 UUID로 바꾸지 않습니다. 닉네임 제공자와도 연결되지 않습니다.

bbwl on, bbwl remove, bbmaint deny에는 기존 접속자를 즉시 내보내는 처리가 없습니다. 반면 bbmaint on은 현재 접속자에게 점검·화이트리스트 조건을 모두 적용하고 하나라도 통과하지 못하면 연결을 끊습니다. 관리 권한도 게이트 우회 권한은 아닙니다.

서버 이동 명령

문법	동작	실행 위치·조건
`/bbtransfer <서버명> [플레이어]`	`feature=framework`, 별도 payload 없이 핸드오프를 기록하고 이동 요청	Paper 전용. 이동 설정 활성화·DB 준비 필요

플레이어 인자를 생략하면 실행자 자신이 대상입니다. 명시한 대상은 해당 Paper에 접속 중인 정확한 플레이어 이름으로 조회합니다. 콘솔은 반드시 플레이어를 지정해야 합니다. 목적지는 Velocity에 등록된 서버 이름입니다. 서버명 자동 완성은 없고 두 번째 인자에는 온라인 플레이어 이름을 제안합니다.

이동 요청함 메시지는 DB 기록과 메시지 전송 단계의 결과입니다. 목적지 연결 성공이나 기능 데이터 적용 완료를 보장하지 않습니다.

권한과 콘솔

위치	권한 노드	기본 허용	콘솔 실행
Paper의 세 명령	`buzzbuild.proxy.admin`	`plugin.yml`에서 `default: op`; 실행 코드에서도 권한 검사	가능. 게이트 전달에는 접속자 1명 이상, 이동에는 명시적 온라인 대상 필요
Velocity의 두 게이트 명령	`buzzbuild.proxy.admin`	일반 플레이어 기본 허용 선언 없음. `hasPermission` 결과 사용	`ConsoleCommandSource`는 코드에서 항상 허용

Paper와 Velocity 권한은 각각의 실행 환경에서 판단합니다. Paper의 OP 설정만으로 Velocity 권한 부여를 확인할 수는 없습니다.

Paper의 proxy.control-bridge-enabled: false 또는 이동 서비스 비활성 상태에서는 해당 실행기를 연결하지 않습니다. 다만 명령 선언은 plugin.yml에 남아 있어 명령 이름이 완전히 사라진다고 보장하지 않습니다.

예시

아래 ExamplePlayer, example-lobby는 가상 계정·서버 이름입니다. 실제 작업 시 운영 대상에 맞춰 사용합니다.

/bbwl add ExamplePlayer
/bbwl on
/bbwl list
/bbmaint allow ExamplePlayer
/bbmaint status
/bbtransfer example-lobby ExamplePlayer

게이트 상태 확인은 Velocity 콘솔에서 수행하면 실행 위치가 명확합니다. Paper에서 보내는 메시지는 처리 완료 응답을 받지 않으므로 Velocity 상태와 저장 오류 로그도 확인해야 합니다.

확인 범위

2026-10-05 등록·실행·탭 완성·권한 코드를 확인했습니다. 실제 프록시 경유 시 명령 선택과 게임 내 동작은 미검증입니다.