BuzzBuild-Esc — 개요

BuzzBuild-Esc는 Minecraft의 ESC 화면을 그룹별 버튼 메뉴로 바꾸는 Fabric 클라이언트 모드와 Paper 서버 플러그인입니다. 서버는 YAML에 정의한 메뉴를 전송하고, 클라이언트는 메뉴를 표시합니다.

핵심 기능

• 서버 연동 없이도 전체 설정·비디오·소리·조작키·리소스팩·쉐이더 설정의 기본 메뉴를 제공합니다.
• 서버 연동 시 그룹·항목·실행 명령을 YAML로 정의하고, 색상·효과음·열 수를 설정합니다.
• native 항목은 클라이언트 설정 화면을 열고, command 항목은 서버에 저장된 명령을 실행합니다.
• 접속 시 메뉴 전송, 운영자 수동 동기화, 설정 리로드 후 갱신을 지원합니다.
• 서버 메뉴 수신이 누락되면 클라이언트가 재요청합니다. 이미 열린 ESC 화면도 수신한 메뉴로 갱신합니다.
• 창 포커스 상실 등으로 PauseScreen이 열리는 경우에도 월드와 플레이어가 있으면 커스텀 ESC로 교체합니다.

단독 모드의 기본 메뉴는 코드에 포함되어 있습니다. 별도의 클라이언트 메뉴 설정 파일이나 클라이언트 명령어는 없습니다.

지원 환경

아래는 현재 소스의 빌드 대상과 메타데이터 선언입니다. 다른 버전에 대한 호환 보장은 아닙니다.

항목	확인 값
플러그인·모드 버전	0.1.0
Minecraft	26.1.2
Java	빌드 도구 체인·컴파일 대상 25, 모드 요구 >=25
서버	Paper API 빌드 대상 26.1.2.build.69-stable
서버 메타데이터	api-version: '26.1.2'
클라이언트	Fabric, environment: client
Fabric Loader	빌드 0.19.3, 모드 요구 >=0.19.3
Fabric API	빌드 0.155.2+26.1.2, 모드 의존성 선언 *

* 선언이 모든 Fabric API 버전과의 호환 검증을 뜻하지는 않습니다. 확인된 빌드 대상을 기준으로 설치하세요.

필수·선택 의존성

사용 형태	필요한 구성
클라이언트 단독 사용	Fabric Loader, Fabric API, ESC Fabric 모드
서버 메뉴 연동	클라이언트의 ESC·Framework Fabric 모드와 서버의 ESC·Framework Paper 플러그인
서버 플러그인	BuzzBuild-Framework 필수. FeatureRegistry, PaperMessagingBus 서비스를 사용
쉐이더 화면	Iris 선택. 화면을 열 수 없으면 비디오 설정으로 이동
사용자 정의 명령 버튼	해당 명령을 실제로 제공하는 플러그인 필요

Framework 개요를 함께 확인하세요. Framework는 ESC 모드의 선택 의존성이지만, 서버 메뉴를 받으려면 클라이언트에도 필요합니다. 서버에 Paper 플러그인만 설치해서는 바닐라 클라이언트의 ESC 화면을 바꿀 수 없습니다.

기본 메뉴에 다른 기능의 명령이 들어 있다는 이유만으로 해당 플러그인이 자동 설치되지는 않습니다. ESC 자체에는 DB 접속 설정, 플레이어별 해금 조회, Bukkit 상자 GUI 구현이 없습니다.

문서 안내

• 설치: 단독 설치와 서버 연동 설치
• 명령어·권한: 운영 명령과 버튼 실행 방식
• 설정: 실제 YAML 키와 예시
• 사용법: 플레이어·운영자 절차
• 문제 해결: 기본 메뉴만 보이는 경우와 구현 제한

확인 범위

2026-10-05 기준 Gradle, 모드·플러그인 메타데이터, 기본 리소스, 명령어·권한 검사, 이벤트·메시징·화면 코드를 확인했습니다. 게임 내 동작은 미검증입니다. 이번 문서 작업에서는 빌드·서버 실행·배포를 하지 않았습니다.