BuzzBuild-Achievement — 명령어·권한

기본 명령어

루트 명령어는 /업적이며 별칭은 /achievements, /bbachievement입니다. 별칭에도 같은 하위 명령을 사용할 수 있습니다. 콘솔에서는 앞의 /를 생략합니다.

문법	기능	필요한 권한	콘솔
/업적	본인의 업적 화면 열기	별도 권한 검사 없음	화면 불가, 사용 안내만 출력
/업적 리로드	설정과 조건 다시 읽기	buzzbuild.achievement.admin	가능
/업적 reload	리로드와 동일	buzzbuild.achievement.admin	가능
/업적 진단	전체·활성·조건 개수, 활동 저장 대기, CustomCrops 연결 여부	buzzbuild.achievement.admin	가능
/업적 추적 <접속중인 닉네임>	활동 이벤트·대상·수량·일치 조건 ID 출력	buzzbuild.achievement.admin	불가, 관리자 플레이어만
/업적 추적 끄기	본인의 추적 해제	buzzbuild.achievement.admin	불가
/업적 보상 상태	설정된 칭호 보상 수, 지급 완료·미지급 및 오류 요약	buzzbuild.achievement.admin	가능
/업적 보상 동기화	기존 완료자의 누락된 칭호 지급 대기 등록	buzzbuild.achievement.admin	가능

추적 대상은 정확한 접속 중 닉네임으로 찾습니다. 추적은 조건 이벤트 경로를 보여주며 add·peak로 직접 갱신되는 모든 구형 지표를 보여주는 기능은 아닙니다.

권한 노드

노드	메타데이터 기본값	적용 범위
buzzbuild.achievement.admin	op	리로드·진단·추적·보상 관리

일반 조회용 별도 권한 노드는 등록되어 있지 않습니다. 콘솔에서 가능한 관리자 명령도 hasPermission 검사를 통과해야 합니다.

실행 예시

/업적
/achievements 진단
/bbachievement reload
/업적 추적 ExamplePlayer
/업적 추적 끄기
/업적 보상 상태
/업적 보상 동기화

보상 동기화는 지급 기록을 초기화하거나 모든 칭호를 다시 주는 명령이 아닙니다. 현재 설정과 기존 완료 기록을 대조해 누락된 지급 건을 등록합니다. 처리 결과는 비동기이므로 보상 상태로 다시 확인합니다.

제공하지 않는 명령

임의 업적 완료·취소, 진행 수치 편집·초기화, 이용자 지정 강제 점수 수령, Google Sheets 가져오기 명령은 없습니다. 업적 점수 수령은 화면의 수령 동작을 이용합니다. 칭호 자동 지급은 수령 버튼과 독립적으로 진행합니다.

별도 탭 완성기는 등록되어 있지 않습니다. 알 수 없는 인수는 일반 화면 열기로 이어질 수 있으므로 오류 안내가 없다고 하위 명령이 지원된다고 판단하지 마세요.

확인 범위

2026-10-05 plugin.yml 등록과 onCommand의 각 분기·권한·실행자 검사를 확인했습니다. 게임 내 동작은 미검증입니다.