BuzzBuild-Avatar — 사용법

설치를 마치고 코스메틱 보유 권한을 준비한 사용자를 위한 절차입니다.

부위별 조합 선택·적용

1. /아바타로 화면을 엽니다.
2. 모자 탭에서 원하는 보유 아이템 카드를 클릭합니다.
3. 등·보조손 등 다른 탭에서도 카드를 클릭합니다. 같은 그룹을 다시 고르면 이전 선택을 대체합니다.
4. 미리보기 모델을 왼쪽 버튼으로 드래그하여 회전시킵니다. 아이템 목록 위에서 휠로 스크롤합니다.
5. 적용을 누릅니다. 부위별 선택 중 보유했고 아직 장착하지 않은 항목들을 하나의 요청으로 전송합니다. 현재 탭의 마지막 카드 하나만 전송하지 않습니다.
6. 서버가 전체 요청의 ID·그룹·보유 권한을 먼저 검사하고 각 항목을 순서대로 저장합니다. 처리 후 서버 상태로 화면이 갱신됩니다.
7. 닫았다가 다시 열어 조합을 확인합니다. HMC 실제 외형과 재접속 후 유지 여부는 운영 환경에서 별도 점검합니다.

탭 이동으로 자동 강조된 항목과 카드 클릭으로 선택한 항목은 다를 수 있습니다. 적용할 아이템은 직접 클릭하세요. 이미 장착된 항목만 선택했다면 적용할 변경이 없습니다.

여러 항목 저장은 단일 트랜잭션이 아닙니다. 중간 실패 시 앞에서 성공한 항목은 남을 수 있으므로 실패 메시지가 나오면 갱신된 상태를 확인합니다.

미보유 아이템과 미리보기 취소

• 미보유 아바타 표기를 켜면 서버가 보내준 미보유 항목도 표시합니다. settings.send-unowned-to-client: false이면 체크해도 그 항목은 표시할 수 없습니다.
• 미보유 아이템도 미리보기 선택은 가능하지만 적용 목록에서 제외됩니다. 보유 여부는 화면을 보는 사람이 아니라 대상 플레이어 기준입니다.
• 아이템 카드 우클릭은 해당 그룹의 임시 미리보기 선택을 지웁니다. 실제 장착 해제 요청은 아닙니다.
• 적용 전 Esc로 닫으면 임시 선택은 저장하지 않습니다. 미리보기는 클라이언트 전용이며 실제 서버 장착을 바꾸지 않습니다.

장착 해제

1. 해제할 그룹을 선택하고 해제를 누릅니다.
2. 또는 착용 영역의 해당 그룹 항목을 우클릭합니다. 실제 착용 항목이 있으면 즉시 해제 요청을 보내고 없으면 미리보기만 지웁니다.
3. 서버 응답으로 화면이 새 세션으로 갱신됩니다.

해제는 적용 버튼을 기다리지 않고 별도로 실행됩니다. 해제 후 갱신 시 다른 부위의 미적용 선택도 초기화되므로 필요한 조합은 다시 선택합니다. 여러 슬롯을 묶은 그룹은 저장 방식별 해제 범위가 다를 수 있습니다. 관리자의 그룹·전체 해제는 명령어를 참고하세요.

관리자 대상 편집

1. 대상이 온라인인지 확인합니다.
2. /아바타 ExamplePlayer를 실행합니다. buzzbuild.avatar.open.other 또는 관리자 권한이 필요합니다.
3. 대상의 보유 아이템을 골라 적용합니다. 이 권한은 실제 대상 장착 변경도 허용합니다.
4. /아바타 조회 ExamplePlayer로 확인합니다. 조회는 관리자 권한이 필요합니다.

ExamplePlayer는 가상 닉네임입니다. 강제 착용은 /아바타 착용 <id> ExamplePlayer를 사용합니다. 보유 권한을 지급하지 않으므로 사망·리스폰 시 미보유 장착 정리 대상이 됩니다.

설정 변경과 세션

1. 설정에 맞게 카탈로그나 그룹을 수정합니다.
2. 권한 있는 운영자가 /아바타 리로드를 실행합니다.
3. 기존 화면을 닫고 다시 열어 카탈로그와 보유 상태를 확인합니다.

사망·퇴장·리스폰 시 관련 세션을 정리합니다. 사망과 Paper 리스폰 후 이벤트에서는 미보유 장착 정리 코드도 실행됩니다. 플러그인 비활성화나 설정 리로드도 세션을 정리합니다.

확인 범위

2026-10-05 기준 클라이언트 입력과 서버 처리·이벤트 코드를 확인했습니다. 게임 내 동작은 미검증입니다.