BuzzBuild-Framework — 개요

BuzzBuild-Framework는 기능 플러그인과 클라이언트 모드가 공유하는 메시징, DB, GUI, 서비스 검색, 프록시 제어 기반입니다. 현재 소스 버전은 0.1.0이며, Paper·Fabric·Velocity용 배포물이 분리되어 있습니다.

핵심 기능

영역	확인한 구현
메시징	Paper ↔ Fabric의 `buzz:payload` 채널, `feature/op`별 핸들러 등록·해제·전송
DB	Paper의 MariaDB/HikariCP 연결 풀, 기능별 DDL 등록·실행, 기존 테이블 확인
서비스	Bukkit ServicesManager에 공통 서비스를 등록하고 `FeatureRegistry`로 기능 서비스 검색
GUI	`GuiSchema` 기반 1~6행 인벤토리 생성, Fabric의 특정 제목을 가진 상자 GUI 배경 조정
표시명·브랜드	`PlayerIdentity` 제공자 검색과 이름 대체값, Paper 브랜드·로그 접두 설정
접속 게이트	Velocity 화이트리스트·점검 허용 목록, 로그인 차단과 점검 전환 시 접속 해제
서버 이동	Paper의 DB 핸드오프 기록과 `buzz:proxy` 요청, Velocity의 등록 서버 연결 요청

Framework 자체에 일반 플레이어용 기능 메뉴를 여는 명령은 없습니다. GUI 내용·클릭 동작·업무 규칙은 사용하는 기능 플러그인이 구현해야 합니다.

지원 환경과 의존성

아래는 실제 빌드·메타데이터의 대상입니다. 다른 버전까지 호환된다는 의미는 아닙니다.

배포물	확인한 대상	필수 구성
Paper	Minecraft `26.1.2`, Paper API `26.1.2.build.69-stable`	Java 25 기준 빌드, 해당 Paper 서버
Fabric	Minecraft `26.1.2`, 클라이언트 전용	Java `>=25`, Fabric Loader `>=0.19.3`, Fabric API
Velocity	Velocity API `3.4.0-SNAPSHOT` 기준 빌드	Java 25 기준 빌드, Velocity 프록시
shared	플랫폼 공통 API·DTO	런타임 모듈에 포함되므로 따로 설치하지 않음

Fabric 빌드에 고정된 버전은 Loader 0.19.3, Fabric API 0.155.2+26.1.2입니다. 메타데이터의 Fabric API 요구값은 *이지만 모든 버전의 동작을 검증한 것은 아닙니다. Spigot·Folia·다른 Minecraft 버전의 지원은 확인하지 않았습니다.

Paper 메타데이터에는 필수 플러그인 depend가 없습니다. softdepend는 Vault, LuckPerms, PlaceholderAPI, Nexo, Citizens, MythicMobs, MythicLib, ModelEngine입니다. 현재 Framework의 연동 배너는 설치·활성 상태를 표시하며, 이 목록만으로 경제·권한·플레이스홀더 API 연동이 제공되지는 않습니다.

MariaDB는 DB 기능과 서버 이동 기능을 사용할 때 필요합니다. MariaDB 서버의 지원 버전 범위는 소스에 명시되어 있지 않습니다. Paper 런타임 JAR에는 HikariCP 6.2.1과 MariaDB JDBC 3.5.1이 포함됩니다. 프록시 제어·이동에는 Velocity용 Framework가 필요하며, Fabric 통신·GUI 보조 기능에는 클라이언트용 Framework가 필요합니다.

문서 안내

확인 범위

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