pixly.

마인크래프트 Java·Bedrock 크로스플레이: Geyser 설정 가이드

Java 서버에서 Bedrock 프로토콜을 변환하는 Geyser와 Bedrock 로그인을 처리하는 Floodgate를 쓰면 Java와 Bedrock 플레이어가 한 월드에서 함께 플레이해요.

AlekseiFounder
업데이트7분 분량
이끼가 군데군데 낀 흙 플랫폼 위에 돌로 된 관문이 서 있고, 주황색으로 빛나는 입구를 굵은 관들이 직각으로 가로질러 지나가요.

Pixly에서 Bedrock 크로스플레이는 스위치 하나와 재시작이면 끝나고, 그다음부터 Java와 Bedrock 플레이어가 같은 주소로 접속해요. 직접 운영하는 서버라면 최신 Geyser 빌드, Floodgate, 그리고 TCP와 UDP 모두 열린 19132 포트가 필요해요. 2026년 10월 27일에 나온 Bedrock 26.60은 NetherNet으로만 접속하기 때문이에요.12

Pixly의 Bedrock 크로스플레이: 스위치 하나와 재시작

Pixly는 Bedrock 플레이어가 Java 서버에 접속하게 해 주는 플러그인 Geyser와, Java 계정 없이 접속하게 해 주는 Floodgate를 설치해요.3 따로 설정할 것은 없어요.

  1. Bedrock 크로스플레이를 켜요. 서버 설정을 열고 스위치를 켜요. Paper, Purpur, Pufferfish, Leaf, and Folia, Fabric, NeoForge, and Quilt에서 쓸 수 있어요.
  2. 서버를 재시작해요. 이번 시작 때 Geyser와 Floodgate가 설치돼요. 게임이 이미 더 새로운 버전으로 업데이트된 Java 플레이어도 접속할 수 있어요. 단, NeoForge는 예외예요.
  3. 주소를 공유해요. Java 플레이어는 멀티플레이에서 주소를 추가해요. 휴대폰, 태블릿, Windows의 Bedrock 플레이어는 플레이, 서버, 서버 추가 순서로 열고 같은 주소를 입력한 뒤 포트는 그대로 둬요.

커스텀 도메인도 Bedrock 플레이어에게 그대로 쓸 수 있고, Bedrock 플레이어가 접속해도 Java 플레이어와 똑같이 잠자는 서버가 깨어나요. 크로스플레이는 모든 서버 사양에 추가 요금 없이 포함돼요. 나머지 내용은 Java·Bedrock 크로스플레이 호스팅에서 볼 수 있어요.

시작하기 전에: 서버 소프트웨어, 버전, Java 21

Geyser를 직접 운영한다면 네 가지부터 확인해요.

  • 서버 소프트웨어. Geyser는 Paper, Spigot과 그 포크에서는 플러그인, Fabric과 NeoForge에서는 모드, Velocity와 BungeeCord에서는 프록시 플러그인이에요. Vanilla와 Forge에는 서버 옆에서 별도 프로그램으로 실행되는 Geyser Standalone이 필요해요.4
  • 마인크래프트 버전. Geyser는 한 번에 Java 버전 하나만 지원해요. 2026년 10월 기준으로는 26.3이에요. 1.20.5 이상의 Paper와 Spigot은 ViaVersion 플러그인으로 함께 쓸 수 있어요. Fabric과 NeoForge는 정확히 그 버전으로 실행해야 해요.5
  • Java 업데이트. 2026년에 Geyser가 새 Java 릴리스를 지원하기까지 24~44일이 걸렸어요.6 그러니 Geyser가 따라잡을 때까지 서버를 Geyser가 지원하는 버전에 두세요.5
  • Java 21 이상. 그보다 오래된 Java에서는 Geyser가 실행되지 않아요.7

내 서버에 Geyser와 Floodgate 설정하기

GeyserMC 다운로드 페이지에서 둘 다 받은 다음:

  1. Geyser와 Floodgate를 설치해요. Paper나 Spigot에서는 Geyser-Spigot.jar와 Floodgate-Spigot.jar를 plugins/에 넣어요.8 Fabric이나 NeoForge에서는 Geyser 빌드와 Floodgate 모드를 mods/에 넣어요. Fabric은 Fabric API도 필요해요.9
  2. 서버를 한 번 시작해요. 그러면 Geyser의 config.yml이 plugins/Geyser-Spigot/, config/Geyser-Fabric/ 또는 config/Geyser-NeoForge/에 만들어져요.7 Geyser는 Floodgate를 알아서 찾아요.10
  3. Geyser의 전송 방식을 확인해요. 아래 예시처럼 bedrock: 아래의 transport가 nethernet이어야 해요. 빌드 1273부터 이 값이 기본이에요. Bedrock 26.60 이상은 이 방식으로만 접속하고, 빌드 1280부터는 Geyser가 예전 raknet 값을 알아서 nethernet으로 바꿔요.1112
  4. server.properties를 수정해요. enforce-secure-profile=false로 설정해요. 그렇지 않으면 Bedrock 플레이어가 접속은 해도 채팅을 못 해요.13 online-mode=true는 그대로 둬요.14
  5. 19132 포트를 TCP와 UDP로 열어요. 공유기에서 둘 다 포트 포워딩하거나, Docker에서 -p 19132:19132 -p 19132:19132/udp로 공개해요. Java 서버 포트와 같으면 안 돼요.15
  6. 재시작하고 콘솔을 확인해요. Built-in signaling started on http://가 보이면 Bedrock 플레이어가 접속할 수 있어요.16 WARNING! Raknet-only transport has now been REMOVED.가 보이면 설정이 raknet이었다는 뜻이에요. 이제 Geyser는 NetherNet을 쓰니, 포트가 UDP뿐 아니라 TCP로도 열려 있는지 확인하세요.17
bedrock:
  port: 19132
  transport: nethernet

TCP 포트를 열 수 없다면? Geyser는 Warden과도 작동해요

Warden은 CubeCraft를 운영하는 Ziax의 무료 서비스로, Bedrock 플레이어의 게임은 이 서비스를 거쳐 서버에 도착해요.2 Warden을 쓰면 서버까지 UDP만 도달하면 되고,15 플레이어에게 신뢰 확인 창도 뜨지 않으며, Warden 호스트 이름이나 내 도메인을 쓸 수 있어요.18 Geyser 설정에서 켜요.

bedrock:
  transport: nethernet
  signaling:
    mode: nxs

Java 포트만 주는 호스트라면 bedrock: 아래에 clone-remote-port: true도 추가해요. 재시작하면 Bedrock 플레이어가 쓸 주소와 포트가 콘솔에 표시돼요.19 Warden은 가동 시간 보장이 없고 개인 서버용으로 만들어졌어요.18

Bedrock 플레이어 접속 방법: 주소, 포트, 콘솔 기기

휴대폰, 태블릿, Windows에서는 플레이, 서버, 서버 추가 순서로 열어요.19 접속 여부는 세 가지에 달려 있어요.

  • 주소와 포트는 각각 다른 칸에 입력해요. 주소 칸에 play.example.com:19132를 입력하면 “Invalid IP address!”가 떠요.20
  • SRV 레코드는 작동하지 않아요. Bedrock은 Java에서 포트를 숨기는 DNS 레코드를 무시하니, IP 주소나 일반 A 레코드가 있는 도메인을 쓰세요.20
  • 콘솔 기기는 우회 방법이 필요해요. Xbox, PlayStation, Switch 플레이어는 DNS 서비스인 BedrockConnect나 BedrockTogether 같은 LAN 앱으로 접속해요.21

위 설정에서는 Bedrock이 플레이어가 처음 접속할 때마다 이 서버를 신뢰할지 물어봐요.22 도메인 이름으로 접속하는 플레이어에게 이 질문을 없애려면 Let's Encrypt의 무료 인증서 같은 인증서를 Geyser에 설정하세요. bedrock: 섹션의 signaling.builtin.https 아래에 certificate와 private-key를 설정하고, 갱신할 때마다 geyser reload를 실행해요.23

프록시, Standalone, ViaProxy: key.pem 복사하기

Floodgate는 Bedrock 플레이어가 Java 로그인을 건너뛰게 해 주는 키 key.pem을 plugins/floodgate/ 또는 config/floodgate/에 만들어요.2425 다음 구성에서는 이 키를 직접 복사해야 해요.

Geyser Standalone

key.pem을 Geyser 폴더에 복사하고, auth-type: floodgate로 설정한 뒤, Geyser 설정의 java: 아래에 Java 서버의 address와 port를 지정해요.2426

Geyser-ViaProxy

key.pem을 plugins/Geyser/에 복사하면 Floodgate 로그인이 자동으로 켜져요.2728

Velocity 또는 BungeeCord

Geyser와 Floodgate는 프록시에만 설치하고, 프록시와 서버 사이의 플레이어 포워딩을 켜요. 프록시에서는 보안 채팅을 꺼요. BungeeCord는 enforce_secure_profile: false, Velocity는 force-key-authentication = false예요.2913

Bedrock 플레이어에게 달라지는 점: 이름, 계정 연동, 제한

Bedrock 플레이어도 같은 월드에 접속하지만, 몇 가지 차이가 있어요.

  • 이름. Floodgate는 이름 앞에 .을 붙이고 공백을 밑줄로 바꿔요. 그래서 Steve Miner는 .Steve_Miner로 접속해요.30 화이트리스트에 추가하려면 원래 이름으로 fwhitelist add를 써요.31
  • 계정 연동. 두 에디션을 모두 가진 플레이어는 계정을 연동할 수 있어요. 양쪽에서 link.geysermc.org에 접속하고, 한쪽에서 /linkaccount를 실행한 뒤 나온 코드를 다른 쪽에 입력해요. Java 계정의 인벤토리와 진행 상황이 그대로 유지돼요.32
  • 없는 기능. Bedrock에는 채팅의 클릭 가능한 링크, 발광 효과, 커스텀 마법 부여, 커스텀 레시피가 없고, 오버월드는 -512 아래나 512 위로는 아무것도 보이지 않아요. Geyser가 설치하는 GeyserIntegratedPack이 갑옷 거치대 포즈, 보조 손 애니메이션 등을 되살려 줘요.33
  • 리소스 팩. Java 팩은 그대로는 Bedrock에서 작동하지 않아요. 초기 베타 단계인 GeyserMC의 Thunder로 간단한 팩을 변환할 수 있고, 결과물은 Geyser의 packs 폴더에 넣어요.34
  • 모드. 서버 측 모드는 작동하지만, 모드가 추가한 블록, 아이템, 몹은 Bedrock 플레이어에게 보이지 않아요.35

알려진 Geyser 문제와 해결 방법

Bedrock 26.60 이후로는 오래된 Geyser 빌드, 예전 RakNet 설정, 막힌 TCP/UDP 트래픽 때문에 플레이어가 접속하지 못할 수 있어요. 확인 방법은 NetherNet, Terracotta, Door 오류 해결 방법을 참고하세요.

Bedrock 플레이어가 접속하지 못하면 Geyser는 콘솔에 다음 메시지를 출력해요.16

Geyser 콘솔 메시지

Built-in signaling cannot use port … because the Java server already uses it

Geyser 전용 포트를 정하고 TCP와 UDP로 열어요.

… is a loopback address

bedrock: 아래의 address를 0.0.0.0으로 설정해요. 그렇지 않으면 모든 플레이어가 시간 초과돼요.

Built-in signaling could not start

바로 뒤에 출력되는 오류가 원인을 알려 줘요. 다른 프로그램이 그 TCP 포트를 쓰고 있다면 그 프로그램을 멈추거나 다른 포트를 고르세요.

다른 문제는 게임 안에서 나타나요.

“Unable to Connect to World”

포트나 Geyser 설정이 잘못됐어요.36 19132 포트가 TCP와 UDP로 열려 있는지(Warden을 쓰면 UDP만), Java 서버 포트와 겹치지 않는지, bedrock: 아래의 address가 0.0.0.0인지 확인하세요.

서버는 보이는데 접속하면 시간 초과돼요

공유기나 방화벽이 UDP 19132를 막고 있거나, 같은 컴퓨터의 다른 프로그램이 그 포트를 쓰고 있어요.23

“Cannot reply to EncryptionRequestPacket without profile and access token”

Floodgate 설정이 잘못됐어요. 플러그인으로 설치했는데 필요 없는 Geyser 폴더에 key.pem을 복사했거나, Java 서버는 온라인 모드인데 Geyser는 오프라인으로 설정돼 있어요.20 불필요한 키를 지우고 두 설정을 맞추세요.

접속할 때 “Outdated client!” 또는 “Outdated server!”가 떠요

Geyser와 서버의 마인크래프트 버전이 달라요. Outdated client!는 Geyser를 업데이트하라는 뜻이고, Outdated server!는 서버를 업데이트하거나 ViaVersion을 추가하라는 뜻이에요.20

Geyser는 playit.gg나 ngrok과 함께 쓸 수 있나요?

ngrok은 UDP를 지원하지 않아서 안 돼요.35 playit.gg에는 Geyser용 Minecraft Bedrock (NetherNet) 터널이 있는데, 아직 실험 기능으로 표시돼 있어요. 예전 Minecraft Bedrock 유형이 아니라 이 터널을 고르세요.37

Floodgate와 충돌하는 플러그인은 무엇인가요?

10.28B 미만의 DynamicBungeeAuth, FastLogin, ExploitFixer, JPremium, LibHatesMods, ProtocolSupport, ProtocolSupportBungee, SayNoToMcLeaks예요. Floodgate가 플레이어 로그인 방식을 바꾸기 때문이에요. TCPShield는 유료 요금제가 아니라면 only-allow-proxy-connections를 꺼야 해요.35

Footnotes

  1. minecraft.wiki, Bedrock Edition 26.60: 2026년 10월 27일 출시. ↩

  2. GeyserMC, Preparing Your Geyser Server for NetherNet, 2026년 10월 8일. ↩ ↩

  3. GeyserMC, Floodgate overview. ↩

  4. GeyserMC, Download: 2026년 11월 9일 Geyser 2.12.1 빌드 1298이 BungeeCord, Fabric, NeoForge, Spigot, Standalone, Velocity, ViaProxy용으로 공개돼 있어요. 2026년 11월 10일 확인. ↩

  5. GeyserMC, Supported versions. 2026년 10월 20일 확인. ↩ ↩

  6. Modrinth, Geyser versions: 각 릴리스를 처음 지원한 빌드는 5월 7일 2.10.0-b1138, 7월 10일 2.11.0-b1186, 2026년 10월 14일 2.12.0-b1255이며, Mojang 버전 매니페스트의 출시일과 비교했어요. 2026년 10월 20일 측정. ↩

  7. GeyserMC, Geyser setup guide. 2026년 10월 20일 확인. ↩ ↩

  8. GeyserMC, Floodgate on Paper and Spigot. ↩

  9. GeyserMC, Floodgate on modded servers. ↩

  10. GeyserMC, GeyserImpl.java, Geyser 소스 코드. 2026년 10월 20일 확인. ↩

  11. GeyserMC, Geyser 2.12.1 build list: 빌드 1273(2026년 10월 26일) “change bedrock.transport config default to nethernet”, 빌드 1280(2026년 10월 31일) “Remove RakNet-only transport”. 2026년 11월 10일 확인. ↩

  12. GeyserMC, GeyserConfig.java, Geyser 소스 코드, 설정 버전 10. transport는 “nethernet”과 “both”를 받으며 기본값은 NETHERNET이에요. 2026년 11월 10일 확인. ↩

  13. GeyserMC, Geyser and Secure Chat. ↩ ↩

  14. minecraft.wiki, server.properties. ↩

  15. GeyserMC, Port forwarding. 2026년 10월 20일 확인. ↩ ↩

  16. GeyserMC, NetherNetServer.java, Geyser 소스 코드. 2026년 10월 20일 확인. ↩ ↩

  17. GeyserMC, Remove RakNet-only transport (#6843): raknet 전송 방식은 “WARNING! Raknet-only transport has now been REMOVED.” 메시지와 함께 nethernet으로 바뀌어요. ↩

  18. Warden, Signaling infrastructure for Minecraft Bedrock. 2026년 10월 20일 확인. ↩ ↩

  19. GeyserMC, Provider.tsx, 설정 가이드의 호스트별 안내 소스. 2026년 10월 20일 확인. ↩ ↩

  20. GeyserMC, Common Issues. 2026년 10월 20일 확인. ↩ ↩ ↩ ↩

  21. GeyserMC, Using Geyser with Consoles. ↩

  22. Mojang, NetherNet HTTP Signaling — Partner Onboarding Guide, 2026년 10월 13일 생성된 프로토콜 문서. ↩

  23. GeyserMC, HTTPS for NetherNet. 2026년 10월 20일 확인. ↩ ↩

  24. GeyserMC, Floodgate with Geyser Standalone. ↩ ↩ ↩

  25. GeyserMC, FabricFloodgateMod.java, Floodgate-Modded 소스 코드. NeoForge 빌드도 같은 폴더를 써요. ↩

  26. GeyserMC, GeyserRemoteConfig.java, Geyser 소스 코드. ↩

  27. GeyserMC, Floodgate with ViaProxy. ↩

  28. GeyserMC, GeyserViaProxyPlugin.java, Geyser 소스 코드. ↩

  29. GeyserMC, Floodgate on proxy servers. ↩

  30. GeyserMC, Floodgate's default config.yml, Floodgate 소스 코드. ↩

  31. GeyserMC, Floodgate features. ↩

  32. GeyserMC, Floodgate account linking. ↩

  33. GeyserMC, Current Limitations. 2026년 10월 20일 확인. ↩

  34. GeyserMC, Thunder. ↩

  35. GeyserMC, Frequently Asked Questions. ↩ ↩ ↩

  36. GeyserMC, Fixing 'Unable to Connect to World'. ↩

  37. playit.gg, Setting up Geyser with playit: “Make sure you pick Minecraft Bedrock (NetherNet), not Minecraft Bedrock”, “Tick the box to confirm NetherNet is experimental.” 2026년 11월 10일 확인. ↩

AlekseiFounder at Pixly

마인크래프트 서버 운영에 대해 써요. 직접 측정한 수치, 재현 가능한 해결책, 호스팅 페이지가 말하지 않는 트레이드오프까지요.

계속 읽기