BuzzBuild-Esc — 설치

설치 전 확인

Minecraft 26.1.2, Java 25를 기준으로 준비합니다. Fabric Loader·Fabric API·Paper의 실제 빌드 대상은 지원 환경을 확인하세요. Forge·NeoForge용 산출물은 없습니다.

설치 위치

아래 경로는 각 게임 인스턴스 또는 서버 폴더를 기준으로 한 상대 경로입니다.

파일·구성	위치	용도
`BuzzBuild-Esc-Fabric-0.1.0.jar`	클라이언트 `mods/`	ESC 화면 표시
Fabric API	클라이언트 `mods/`	필수 Fabric 기능
Framework Fabric 모드	클라이언트 `mods/`	서버 메뉴 연동 시 필요
`BuzzBuild-Esc-Paper-0.1.0.jar`	서버 `plugins/`	메뉴 로드·전송·명령 실행
Framework Paper 플러그인	서버 `plugins/`	ESC 서버 플러그인의 필수 의존성

ESC Fabric 산출물은 공통 모듈을 포함하고, Paper 산출물도 공통 코드를 포함합니다. 공통 모듈 JAR를 별도 모드나 플러그인으로 설치하지 않습니다. Fabric JAR는 클라이언트 전용입니다.

클라이언트 단독 사용

대상 버전의 Fabric 게임 인스턴스에 Fabric API와 ESC Fabric 모드를 설치합니다.
사용자가 게임을 실행하고 싱글플레이 월드 또는 서버에 들어갑니다.
다른 화면이 열려 있지 않은 상태에서 ESC를 누릅니다.
기본 설정 그룹의 여섯 버튼을 사용합니다.

이 구성에서는 서버의 사용자 정의 명령 버튼이 나타나지 않습니다. Iris는 선택 사항이며, 없거나 호환 화면 생성에 실패하면 쉐이더 버튼은 비디오 설정을 엽니다.

서버 메뉴 연동 설치

서버 plugins/에 Framework Paper와 ESC Paper를 설치합니다.
각 플레이어의 클라이언트 mods/에 Fabric API, Framework Fabric, ESC Fabric을 설치합니다.
운영자가 정해진 절차로 서버와 클라이언트를 실행합니다. ESC 서버 활성화에는 Framework 서비스가 먼저 준비되어 있어야 합니다.
최초 활성화 시 생성된 아래 파일을 확인합니다.
플레이어 접속 후 ESC에서 서버 메뉴가 표시되는지 확인합니다.

생성 파일	내용
`plugins/BuzzBuild-Esc/config.yml`	레이아웃·동기화·메시지·사운드·색상
`plugins/BuzzBuild-Esc/menus/main.yml`	기본 그룹과 버튼 정의

이미 있는 config.yml과 menus/main.yml은 초기 저장 과정에서 덮어쓰지 않습니다. menus/의 .yml, .yaml 파일을 읽으며, 실제 전송에는 id: main 메뉴를 우선 사용합니다.

기본 메뉴에는 아바타·우편함·탈것 등의 외부 명령이 포함됩니다. 설정의 기본 명령 목록과 실제 서버 구성을 비교하여 제공하지 않는 기능의 항목을 비활성화하거나 바꾸세요.

설정 변경 적용

기존 설정 파일을 백업합니다.
config.yml 또는 menus/main.yml을 수정합니다.
운영 권한으로 /이스크 리로드를 실행합니다. 콘솔에서는 선행 / 없이 입력합니다.
이 명령은 ESC 설정과 메뉴를 다시 읽고 온라인 플레이어에게 갱신을 보냅니다.
/이스크 상태로 로드된 개수를 보고 실제 화면을 확인합니다.

/이스크 동기화는 메모리에 있는 메뉴를 다시 보냅니다. 파일 수정 내용을 읽어들이는 명령은 아닙니다. 서버 전체 /reload는 이 적용 절차에 포함하지 않습니다.

JAR 교체 적용

운영자가 서버·클라이언트의 정상 종료 및 재실행 절차에 맞춰 기존 JAR를 백업하고 교체합니다. 단순 설정 리로드만으로 JAR의 코드가 교체되지는 않습니다. 서버 메뉴 누락 복구를 사용하려면 sync 요청·응답을 구현한 ESC Fabric과 ESC Paper 양쪽을 배포해야 합니다. 파일 버전 0.1.0만으로 동일 소스에서 생성된 JAR인지 구분할 수 없으므로 배포 세트도 확인하세요.

확인 범위

2026-10-05 기준 산출물 이름·의존성·리소스 생성·리로드 코드를 확인했습니다. 게임 내 동작은 미검증입니다. 이 문서는 설치 절차 안내이며, 문서 작성 중 서버 제어나 파일 배포는 실행하지 않았습니다.