Minecraft 플러그인 Geyser-Spigot

🔌 Geyser-Spigot 소개

Geyser-Spigot은 Geyser의 Spigot/Paper 플랫폼 빌드입니다. Minecraft: Bedrock Edition 클라이언트가 Geyser를 서버 측 플러그인으로 실행하여 Java Edition 서버에 접속할 수 있게 해 주는 프로토콜 변환기입니다. Spigot 호환 서버 JAR 내부에서 동작하며, Bedrock 프로토콜 트래픽을 호스트 서버용 Java 프로토콜 트래픽으로 변환하는 Bedrock listener를 제공합니다.

🎯 목적

별도의 프록시 프로세스 없이 서버 운영자가 Java 서버에서 Bedrock 플레이어를 받을 수 있도록 크로스플레이 기능을 제공합니다. 이를 통해 Bedrock 에디션과 Java 에디션 사이의 핵심적인 프로토콜 호환성 문제를 해결합니다.

⚙️ 기능

• Spigot/Paper 플러그인으로 동작합니다(plugins/에 JAR를 넣고 재시작하세요).
• Bedrock 프로토콜 트래픽을 Java 프로토콜로 변환하여 Bedrock 클라이언트가 Java 서버에 접속할 수 있게 합니다.
• 서버별 구성을 생성합니다(플러그인 폴더와 설정 파일이 plugins/Geyser-Spigot 아래에 생성됩니다).
• Bedrock 플레이어를 Java 계정 인증 없이 접속시키고 싶을 때는 Floodgate와 함께 사용하는 것이 공식적으로 권장됩니다.
• GeyserMC 프로젝트의 일부로 지원 및 유지보수됩니다(소스는 프로젝트 저장소에서 확인할 수 있습니다).

🧩 대상

• 하나의 Spigot 또는 Paper 백엔드에서 Java/Bedrock 크로스플레이를 원하는 서버 운영자.
• Bedrock 클라이언트 호환성이 필요한 소규모부터 대규모까지의 Survival, SMP, 커뮤니티 서버.
• 별도의 독립형 프록시보다 플러그인으로 Geyser를 실행하고 싶은 관리자.

🏗️ 사용 예시

• 모바일 및 콘솔 플레이어(Bedrock)가 별도의 프록시 서버 없이 Spigot/Paper Java 서버에 접속하도록 허용합니다.
• 게임 로직을 같은 백엔드에 유지하면서 Java와 Bedrock 클라이언트를 모두 받는 공개 SMP 서버를 운영합니다.

⚙️ 설치

📥 설정

• Spigot/Paper 플랫폼용 공식 Geyser-Spigot JAR를 다운로드하세요.
• Geyser-Spigot.jar 파일을 서버의 plugins/ 디렉터리에 넣으세요.
• 서버를 시작하거나 재시작한 뒤 서버 로그를 확인하여 플러그인이 활성화되고 폴더를 생성했는지 확인하세요.

📦 의존성

• Floodgate(선택 사항): Bedrock 플레이어가 Java 계정 인증 없이 인증/접속하길 원할 때 권장됩니다. Floodgate는 Geyser의 일반적인 동반 플러그인으로 안내됩니다.

🧾 설정

• Geyser-Spigot은 plugins/Geyser-Spigot 아래에 설정 디렉터리와, listener, 원격 Java 서버 설정 및 기타 옵션을 담은 मुख्य 설정 파일을 생성합니다. 필요에 따라 해당 파일을 편집하고 서버를 재시작해 변경 사항을 적용하세요.

🧠 기술 메모

• 확인된 지원 서버 플랫폼: Spigot 및 Paper.
• Spigot/Paper 플러그인으로 사용할 때 1.16.5 이상 최신 서버 버전을 지원한다고 문서화되어 있습니다.
• 소스 코드와 이슈 추적은 GeyserMC 프로젝트 저장소에서 관리됩니다.
• MIT License 하에 라이선스가 부여됩니다.

🤝 이 플러그인이 유용한 경우

별도의 프록시 프로세스를 실행하지 않고 기존 Spigot/Paper Java 서버에서 Bedrock 플레이어를 받아야 한다면, Geyser-Spigot은 서버 측에서 유지보수되는 프로토콜 변환 계층을 제공하여 Bedrock 연결을 Java 플레이어와 같은 백엔드에 유지합니다.