BuzzBuild-Avatar — 명령어·권한

대표 명령어는 /아바타, 전체 명령어 별칭은 /avatar입니다. 메타데이터의 기본 진입 권한은 buzzbuild.avatar.use입니다. 아래 권한은 진입 후 추가 검사합니다.

명령어

문법	하위 명령 별칭	추가 권한·조건	콘솔
/아바타	없음	use 또는 admin; 자기 화면	불가
/아바타 <닉네임>	없음	타인이면 open.other 또는 admin; 대상 온라인	불가
/아바타 리로드	reload	reload 또는 admin	가능
/아바타 착용 <id> [닉네임]	equip	admin; 대상 온라인	닉네임 지정 시 가능
/아바타 착용해제 <그룹 또는 all> [닉네임]	unequip	admin; 대상 온라인	닉네임 지정 시 가능
/아바타 조회 [닉네임]	list	admin; 대상 온라인	닉네임 지정 시 가능
/아바타 debug <on 또는 off>	없음	admin	가능

표의 짧은 권한명에는 buzzbuild.avatar. 접두사가 붙습니다. 플레이어가 관리 명령의 닉네임을 생략하면 자신이 대상입니다. 온라인 플레이어의 정확한 이름으로 조회하며 오프라인 대상은 지원하지 않습니다. 콘솔에서는 맨 앞 /를 생략합니다.

착용은 보유 권한을 우회하는 관리자 강제 착용입니다. 권한을 영구 지급하는 명령은 아니며 카탈로그에 존재하고 그룹이 활성화되어야 합니다. 화면의 적용 버튼은 관리자라도 대상의 보유 권한을 검사합니다.

착용해제는 그룹 ID, 설정한 표시 이름, 모자/hat, 등/back, 한벌옷/outfit, 보조손/offhand를 받습니다. all과 전체는 전체 해제입니다. HMC에서는 기본 네 그룹을 순회하고 local에서는 대상의 Avatar 장착 행 전체를 삭제합니다. 비활성 한벌옷도 기본 이름으로 해제할 수 있습니다.

debug는 settings.debug를 변경하고 파일에 저장합니다. 리로드는 Avatar 자체 설정을 다시 읽습니다.

권한 노드

노드	기본 허용	의미
buzzbuild.avatar.use	true	기본 명령어 접근·자기 화면
buzzbuild.avatar.admin	op	강제 착용·해제·조회·debug, 리로드와 타인 편집
buzzbuild.avatar.reload	op	Avatar 설정 리로드
buzzbuild.avatar.open.other	op	타인 화면 열기 및 그 대상의 장착 변경
코스메틱 정의의 permission 값	Avatar에서 기본 허용 등록 없음	대상의 해당 권한으로 보유 판단. 빈 문자열이면 전원 보유

admin의 자식 권한으로 use, reload, open.other가 모두 true로 선언되어 있습니다. open.other는 읽기 전용 권한이 아닙니다.

예시

ID는 기본 local 샘플의 값이고 ExamplePlayer는 가상 닉네임입니다. HMC 모드에서는 HMC에 등록된 ID를 사용합니다.

/아바타
/avatar ExamplePlayer
/아바타 착용 banana_hat ExamplePlayer
/avatar equip sample_backpack ExamplePlayer
/아바타 착용해제 모자 ExamplePlayer
/avatar unequip all ExamplePlayer
/아바타 조회 ExamplePlayer
/avatar list ExamplePlayer
/아바타 debug on
/아바타 debug off
/아바타 리로드

별도 구매·보유권 지급·프리셋 저장 명령어는 없습니다. 보유 권한은 서버의 권한 관리 체계에서 부여합니다. 화면 조작은 사용법을 참고하세요.

확인 범위

2026-10-05 기준 명령어 등록·실행·탭 완성과 권한 검사를 확인했습니다. 게임 내 동작은 미검증입니다.