Geyser — Minecraft에서 Bedrock 플레이어를 Java 서버에 연결하는 플러그인
Geyser 플러그인으로 Bedrock 플레이어를 Java Minecraft 서버에 연결하는 방법을 소개합니다. 작동 원리, Floodgate 인증, config.yml 주요 설정과 한계까지 정리했습니다.
Geyser 플러그인으로 Bedrock 플레이어를 Java Minecraft 서버에 연결하는 방법을 소개합니다. 작동 원리, Floodgate 인증, config.yml 주요 설정과 한계까지 정리했습니다.
Geyser — Minecraft에서 Bedrock 플레이어를 Java 서버에 연결하는 플러그인
이 문서를 테스트하고 작성한 Minecraft 버전: Java Edition 26.1.2 (Bedrock 26.x)
지원되는 버전 범위: 최신 빌드는 Java 26.1 – 26.1.2 및 Bedrock 26.0 – 26.30이며, 1.16.5 버전 이상 서버로의 접속은 추가 설정을 통해 가능합니다
Geyser는 프록시 플러그인으로, Bedrock Edition 플레이어가 Java Edition 서버에 접속할 수 있게 해줍니다. 이 플러그인은 두 에디션 간의 네트워크 패킷을 변환하므로, 서버 소유자는 각 에디션마다 별도의 월드를 유지할 필요가 없으며, 스마트폰·콘솔·Windows 버전에서 접속하는 사용자도 Java 플레이어와 동일한 서버에 접속할 수 있습니다.
Geyser의 작동 방식
Java와 Bedrock은 서로 다른 네트워크 프로토콜을 사용하며 직접적으로는 호환되지 않습니다. 프록시는 그 사이에 위치하여 Bedrock 클라이언트의 접속을 받아들이고, 패킷을 Java 형식으로 변환하며 그 반대도 수행합니다. 플레이어 입장에서는 주소와 포트를 통한 평범한 서버 접속일 뿐입니다.
플러그인은 두 가지 방식으로 실행할 수 있습니다: 기존 서버 내부에서 실행하는 방식(Spigot, Paper, BungeeCord, Velocity, Fabric, NeoForge)과 서버 앞단에서 별도의 Standalone 프로그램으로 실행하는 방식입니다. Standalone은 서버 자체에 접근할 수 없거나 여러 백엔드를 처리해야 할 때 선택합니다.
Bedrock 플레이어가 얻는 것
접속 후 Bedrock 플레이어는 Java 사용자와 동일한 월드에 들어가며 서로를 볼 수 있습니다. 에디션 간 차이의 일부는 자동으로 로드되는 리소스팩인 GeyserIntegratedPack이 완화해줍니다. 이 팩은 Bedrock 쪽에 타격 파티클, 보조 손 아이템 애니메이션, Java와 동일한 스코어보드 너비, Java 스타일의 인벤토리 디자인을 추가합니다.
Bedrock는 공격 쿨다운이 없는 1.8 버전의 전투 방식으로 동작하는 반면, Java에는 공격 타이머가 있습니다. 플레이어가 감을 잡을 수 있도록 프록시는 조준점, 핫바 옆의 게이지, 또는 표시 안 함 중 하나로 인위적인 쿨다운 표시를 보여주며, 이는 파라미터 cooldown-type에 따라 달라집니다.
인증과 Floodgate
로그인 방식은 파라미터 auth-type가 결정합니다. 기본값은 online 이며, 이 경우 Bedrock 플레이어는 Java Edition을 소유한 Microsoft 계정으로 로그인해야 합니다. 이는 모든 사용자가 Java 계정을 가지고 있는 서버에 적합합니다.
Java 버전이 없는 플레이어도 접속할 수 있게 하려면, Geyser와 함께 같은 팀이 만든 별도의 플러그인인 Floodgate를 설치합니다. 값을 auth-type: floodgate로 설정하면 Bedrock 계정만으로 로그인이 가능해집니다. Floodgate는 또한 Bedrock 플레이어의 스킨을 Java 쪽에 표시하고, 네이티브 Bedrock 폼을 전송할 수 있게 하며, 두 에디션의 계정을 연동합니다. Spigot/Paper, BungeeCord, Velocity, Fabric에서 사용할 수 있으며, 이것이 없으면 프록시는 online모드로 동작합니다.
주요 설정 파라미터
파일 config.yml에는 수십 개의 옵션이 있지만, 실행에는 몇 가지 핵심 항목만으로 충분합니다 — 나머지는 네트워크 세부 조정에 관한 것입니다.
파라미터 | 기능 |
| Bedrock 접속용 UDP 포트입니다. UDP에 대해 개방되어 있어야 합니다. |
|
|
| Java에서 Bedrock 서버 화면으로 MOTD를 전달합니다; |
| Java에서 플레이어 수를 전달합니다; |
|
|
| GeyserIntegratedPack을 로드합니다; |
제한 사항
이 플러그인은 서로 다른 두 게임 사이의 프로토콜을 변환하기 때문에, Java의 일부 기능은 Bedrock 쪽에서 재현할 수 없습니다: 채팅 내 클릭 가능한 링크, 엔티티의 발광(glowing) 효과, 인벤토리에서 좌클릭과 우클릭의 구분, 커스텀 인챈트, 모루와 대장간 작업대의 자체 레시피 등입니다. Bedrock 플레이어의 움직임은 완벽하게 재현되지 않으므로, 대형 서버에서는 안티치트가 이를 잘못 감지할 수 있습니다.
결론
Geyser는 각 에디션마다 별도의 월드를 만들 필요 없이, 스마트폰·콘솔·Windows 버전에서 동시에 Bedrock 플레이어를 Java 서버에 접속시켜 줍니다. 두 개의 병렬 서버를 유지하는 방식과 달리, 프록시는 모두를 하나의 월드에 두고 MOTD, 스킨, 폼을 전달합니다. 반면 Java의 일부 메커니즘은 Bedrock에서 단순화되거나 사용할 수 없으며, 움직임이 항상 안티치트와 잘 맞는 것은 아닙니다. 이 플러그인은 Bedrock 사용자층에게 문을 열고 싶은 서버에 적합하며, Floodgate와 함께 사용하면 Java 계정이 없는 플레이어도 받을 수 있습니다.
설치
일반적인 설치는 약 5 분 정도 걸려요. 과정은 동일하고, Loader 와 그에 맞는 빌드만 달라요.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.











