BuzzBuild-Esc — 사용법

단독 설정 메뉴 사용

단독 설치를 완료합니다.
월드에 들어가 다른 화면을 닫은 뒤 ESC를 누릅니다.
설정 그룹에서 원하는 항목을 누릅니다. 기본 메뉴는 1열·최소 6행입니다.
ESC 메뉴에서 ESC를 다시 누르면 닫힙니다.
접속 종료를 누르면 현재 월드를 나가 타이틀 화면으로 이동하는 코드가 실행됩니다.

단독 메뉴에 서버 전용 버튼이 없는 것은 정상입니다. 클라이언트 기본 메뉴의 항목·색상은 내장값이며 서버 YAML이 없는 상태에서 편집하는 설정 화면은 없습니다.

서버 메뉴 사용

서버 연동 구성을 갖춘 서버에 접속합니다.
서버가 메뉴 스냅샷을 보내면 클라이언트가 저장합니다. 수신 전에 ESC를 열면 우선 단독 기본 메뉴가 보일 수 있습니다.
수신 후 ESC를 열어 그룹별 버튼을 누릅니다. 이미 열려 있으면 새 스냅샷으로 갱신됩니다.
native 버튼은 클라이언트 설정을 엽니다. command 버튼은 ESC를 닫고 항목 ID를 서버에 보냅니다.
서버는 주 메뉴에서 해당 ID를 조회하여 설정된 명령을 실행합니다.

서버 접속을 끝내거나 새 연결이 초기화되면 이전 메뉴와 재시도 상태를 초기화합니다. 다른 서버에서도 이전 서버의 메뉴를 계속 보관하는 방식은 아닙니다.

운영자가 메뉴 변경하기

menus/main.yml에서 그룹 제목·항목 이름·순서 또는 동작을 수정합니다.
사용하지 않는 항목은 그 항목의 enabled: false로 제외합니다.
외부 명령 버튼은 실제 명령 제공 플러그인과 실행 주체를 확인합니다. 설정 형식은 메뉴 YAML을 참고하세요.
/이스크 리로드를 실행합니다.
/이스크 상태와 플레이어의 ESC 화면을 확인합니다. 상태 수치는 전체 로드 메뉴의 합계입니다.

클릭할 때마다 메뉴 파일을 디스크에서 읽는 구조는 아닙니다. 파일 편집 후에는 리로드가 필요합니다.

기본 설정만 보일 때 복구

단독 사용 중인지 서버 연동을 기대하는 상황인지 구분합니다.
서버 연동이라면 양쪽 Framework·ESC 설치와 서버 활성화 상태를 확인합니다.
메뉴 미수신 중에는 연결·플레이어 준비 이후 최초 600클라이언트 틱 동안 40틱 간격으로 재요청합니다. 정상 20틱/초 기준 약 30초 동안 약 2초 간격입니다.
초기 재시도 기간이 지나도 ESC를 열어 두면 같은 간격으로 재요청합니다. 통신 채널을 사용할 수 있을 때만 실제 패킷을 보냅니다.
운영자는 /이스크 동기화로 온라인 전체에 다시 보낼 수 있습니다. 파일도 바꿨다면 먼저 /이스크 리로드를 사용합니다.

서버 응답은 플레이어별 20서버 틱 간격으로 제한됩니다. 비어 있는 서버 메뉴라도 스냅샷을 수신하면 자동 재요청은 중단됩니다. 등록된 메뉴가 없습니다가 나오면 네트워크 재시도만 기다리지 말고 서버 메뉴 정의를 확인하세요.

화면·효과음 조정

config.yml에서 layout, theme, sounds를 수정합니다.
색상은 따옴표로 감싼 6자리 RGB 또는 8자리 ARGB 문자열을 사용합니다.
/이스크 리로드 후 실제 사용하는 GUI 배율과 해상도에서 확인합니다.
호버 소리는 기본으로 꺼져 있습니다. 사용하려면 sounds.enabled와 sounds.hover.enabled를 모두 켭니다.

확인 범위

2026-10-05 기준 입력 Mixin, 화면 클릭 처리, 접속·종료 이벤트, 재시도 정책 및 서버 명령 처리에서 도출한 절차입니다. 게임 내 동작은 미검증입니다.