pixly.

Geyser NetherNet 오류와 Terracotta 오류 해결 방법

Geyser 서버의 NetherNet 오류와 Terracotta 오류 해결법: InitialConnection 코드를 확인하고 Geyser를 업데이트한 뒤 TCP와 UDP 접속을 점검하세요.

AlekseiFounder
업데이트6분 분량
닫힌 돌문 위의 GeyserMC 로고, 테라코타 블록, 잔디 플랫폼 위에 뽑혀 있는 케이블.

Pixly는 Bedrock 26.60을 출시 첫날부터 지원했어요. 설정에서 Bedrock 크로스플레이를 켜고 재시작하면 Pixly가 Geyser와 Floodgate를 자동으로 설치하고 설정해요. Java와 Bedrock 플레이어가 같은 주소로 접속해요.

NetherNet, Terracotta, Door 코드의 의미

2026년 10월 27일에 출시된 Bedrock 26.60은 NetherNet으로만 서버에 접속해요.12 NetherNet 오류, Terracotta, Door로 접속에 실패하면 세부 정보 표시를 눌러 InitialConnection 번호를 확인하세요. 그 번호로 아래에서 어떤 점검을 할지 고르면 돼요.

Bedrock 26.60의 접속은 TCP로 서버를 찾는 웹 요청인 시그널링으로 시작하고, 그다음 게임은 UDP로 진행돼요.3 GeyserMC의 지원 안내는 InitialConnection 번호마다 원인을 짝지어 두었어요:4

코드세부 정보원인해결
TerracottaInitialConnection-149Geyser가 RakNet 사용 중이거나 TCP 포트가 닫힘아래 네 단계
DoorInitialConnection-83UDP 차단 또는 서버가 NAT 뒤에 있음UDP 열기, advertise-addresses 설정
NetherNetInitialConnection-13NetherNet과 RakNet 모두 응답 없음주소와 두 포트 확인
NetherNetInitialConnection-122연결이 열렸다가 닫힘Geyser 업데이트, 계속되면 연결 끊김 로그 확인

Terracotta와 149는 서버가 NetherNet을 쓰지 않거나 시그널링에 닿을 수 없다는 뜻이에요.4 NetherNet 오류와 13은 서버가 어느 쪽으로도 응답하지 않았다는 뜻이니 주소부터 확인하세요. 122는 연결이 열렸다가 닫힌 경우로, 1273 이전 Geyser 빌드가 Alpine Linux에서 이랬어요.5

Geyser 서버에서 Terracotta 오류 해결하기

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

  1. Geyser를 최신 빌드로 업데이트하세요. 10월 26일에 나온 빌드 1273이 Bedrock 26.60을 지원하는 첫 빌드이고, 이후 빌드에서 26.61부터 26.63까지 추가됐어요.6
  2. Geyser 설정에서 transport: nethernet으로 지정하세요. 설정은 Paper에서는 plugins/Geyser-Spigot/, Fabric이나 NeoForge에서는 config/Geyser-Fabric/ 또는 config/Geyser-NeoForge/에 있어요.7 빌드 1279까지는 예전 raknet 줄이 그대로 남고, 빌드 1280부터는 Geyser가 알아서 바꿔요. 다른 값은 both뿐인데, RakNet도 받는 대신 UDP 포트가 하나 더 필요해요.8910
  3. Geyser 포트를 TCP와 UDP 모두 여세요. Docker에서는 -p 19132:19132 -p 19132:19132/udp로 게시해요.3 Java 서버와 같은 포트는 쓸 수 없어요.7
  4. 재시작하고 Bedrock으로 접속해 보세요. Built-in signaling started on http://0.0.0.0:19132가 나오면 Geyser의 시그널링 서버가 시작된 거예요.8 내 네트워크 밖에서 접속해 플레이어가 TCP와 UDP로 연결되는지 확인하세요.3

그러면 설정의 bedrock: 섹션은 다음과 같아요:

bedrock:
  port: 19132
  transport: nethernet

프록시, Geyser Standalone, Java 포트만 열어 주는 호스트라면 이것만으로는 부족해요. 이런 경우는 Geyser와 Floodgate 설정 가이드에서 다뤄요.

Door 오류 해결하기: UDP와 NAT 확인

Door와 83은 TCP 시그널링은 성공했지만 UDP 게임 트래픽이 통과하지 못했다는 뜻이에요. 포트 포워딩이나 Docker 포트 매핑을 TCP로만 하면 이렇게 되니, 같은 포트에 UDP도 추가하세요. 한 서버 운영자는 TCP가 이미 동작하는 상태에서 UDP를 고쳐 26.60 콘솔 기기의 Door 83을 해결했어요.11

Geyser가 라우터나 NAT 뒤에 있고 Door가 계속되면, GeyserMC는 공인 IP를 bedrock.signaling.advertise-addresses에 추가하고 재시작하라고 안내해요.4 기존 bedrock: 섹션에 아래 내용을 합치고 203.0.113.10을 서버의 공인 IP로 바꾸세요:

bedrock:
  signaling:
    advertise-addresses:
      - "203.0.113.10"

26.60 이후 Geyser 경고와 그 의미

Geyser는 시작할 때 아래 경고를 출력해요. 빌드 1273부터 1279까지는 관리자가 접속할 때도 NetherNet 관련 메시지를 보내요.69

Geyser 콘솔 경고

WARNING! NetherNet support is NOT enabled.

빌드 1273부터 1279까지에서 설정이 아직 raknet일 때 나와요. Geyser를 업데이트하거나 transport: nethernet으로 지정한 뒤 재시작하세요.

WARNING! Raknet-only transport has now been REMOVED.

빌드 1280 이상이 설정을 NetherNet으로 바꿨다는 뜻이에요. UDP뿐 아니라 TCP로도 포트를 여세요.

NetherNet will not start! Could not load its WebRTC native library

빌드 1280 이전에는 대신 NetherNet is not available on Linux (amd64)가 나와요. Geyser가 NetherNet 라이브러리를 불러오지 못한 상태예요. 보고된 원인은 libcrypto.so.3 누락(Ubuntu에서는 libssl3 설치)과 읽기 전용 /tmp예요.1211

빌드 1280 이전에는 이 마지막 경고에 transport를 raknet으로 바꾸라는 조언이 붙어요. 따르지 마세요. GeyserMC에 따르면 Bedrock 26.60은 RakNet으로는 아예 접속하지 않아요.2

테스트: 잘못된 설정마다 접속은 어떻게 되나

2026년 11월 1일에 Paper 26.3, Geyser 2.12.1, 오픈 소스 Bedrock 라이브러리인 gophertunnel로 만든 NetherNet 테스트 클라이언트로 다섯 가지 설정을 테스트했어요.8

Geyser설정접속 결과
1279transport: raknetTCP에서 바로 거부됨
1279transport: nethernet로그인이 Geyser에 도달
1280transport: raknetNetherNet으로 전환, 로그인이 Geyser에 도달
1280TCP 19132 닫힘TCP에서 바로 거부됨
1280UDP 19132 차단시그널링은 성공, 30 s 후 시간 초과

테스트 클라이언트는 각 접속이 멈춘 단계를 알려 줘요. 외부 보고도 정상 설정과 일치해요. 한 운영자는 Windows용 Bedrock 26.60에서 NetherNet으로 접속하고 있고,13 groundsgg 서버 이미지는 빌드 1280과 TCP·UDP 19132로 26.60 접속을 되살렸어요.14

NetherNet 오류와 Terracotta 오류 FAQ

플레이어는 NetherNet 오류를 어떻게 해결하나요?

서버 주소와 게임 버전을 확인하세요. 세부 정보 표시 화면 전체, 사용 중인 기기와 게임 버전, 다른 플레이어는 접속되는지를 서버 운영자에게 보내 주세요. 코드 13과 122는 연결이 실패했거나 닫혔다는 뜻이고, 운영자는 이 정보로 서버 로그를 확인할 수 있어요.

26.60에서 Geyser 서버가 LAN 게임에 안 보이는 이유는 뭔가요?

Bedrock 26.60은 UDP 포트 7551에서 LAN 월드를 찾는데, Geyser는 아직 여기에 응답하지 않아요. 2026년 11월 10일 기준 Geyser 이슈 트래커에 이 보고가 아직 열려 있어요.13 대신 서버 탭에서 주소로 서버를 추가하세요.

이전 Bedrock 버전의 플레이어가 접속하지 못하는 이유는 뭔가요?

빌드 1273에서 Bedrock 26.30 지원이 빠졌고, 현재 Geyser 빌드는 Bedrock 26.40부터 26.63까지 받아요.615 이전 버전의 플레이어는 기기의 스토어에서 게임을 업데이트하면 돼요.

Footnotes

  1. minecraft.wiki, Bedrock Edition 26.60: 2026년 10월 27일 출시, 프로토콜 2225. 2026년 11월 1일 확인. ↩

  2. GeyserMC, Preparing Your Geyser Server for NetherNet, 2026년 10월 8일: “Bedrock clients will stop connecting over RakNet.” ↩ ↩

  3. GeyserMC, Port forwarding: “players find the server over TCP (signaling), and play on it over UDP.” 2026년 11월 1일 확인. ↩ ↩ ↩

  4. GeyserMC, Bedrock 오류 코드 지원 태그, GeyserDiscordBot: InitialConnection-149는 “Terracotta”, UnsupportedTransport이며 “may also appear if the signaling server is unreachable or not running”; 83은 “Door”, NetherNetICE, “try adding your public IP address to the advertise-addresses config option”; 13은 “NetherNet”, LegacyDisconnect, “if both attempts time out” 표시; 122는 “NetherNet”, NetherNetDataChannelClosed. 2026년 11월 1일 확인. ↩ ↩ ↩

  5. GeyserMC/Geyser 이슈 #6807, 닫힘: Alpine 이미지에서 클라이언트가 “shows InitialConnection-122 (NetherNetDataChannelClosed) after 30 s”; 빌드 1273에서 수정. ↩

  6. GeyserMC, Geyser 2.12.1 빌드 목록: 빌드 1273, 2026년 10월 26일, “Support 26.60”, “Surgically remove 26.30”, “Add operator join message informing NetherNet deprecation, change bedrock.transport config default to nethernet”; 빌드 1291, 11월 6일, “Indicate Minecraft: Bedrock Edition 26.61 and 26.62 Support”; 빌드 1298, 11월 9일, “Indicate Minecraft: Bedrock Edition 26.63 Support”. 2026년 11월 10일 확인. ↩ ↩ ↩

  7. GeyserMC, Geyser 설정 가이드: “Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server.” 2026년 11월 1일 확인. ↩ ↩

  8. Pixly 테스트, 2026년 11월 1일: Docker에서 Paper 26.3과 Geyser-Spigot 2.12.1 빌드 1279, 1280을 실행하고, 같은 네트워크에서 gophertunnel 기반 NetherNet 클라이언트로 접속. 포트는 서버 컨테이너 안의 방화벽 규칙으로 닫음. 빌드 1279는 새 설정을 transport: nethernet으로 만들었고 기존 transport: raknet은 그대로 둔 채 WARNING! NetherNet support is NOT enabled.를 기록. ↩ ↩ ↩

  9. GeyserMC, Remove RakNet-only transport (#6843), 빌드 1280, 2026년 10월 31일(UTC): raknet 전송 방식을 nethernet으로 바꾸고, 시작 시와 접속 시의 WARNING! NetherNet support is NOT enabled. 메시지를 없애고, Linux 메시지를 “NetherNet will not start! Could not load its WebRTC native library”로 바꿈. ↩ ↩

  10. GeyserMC, GeyserConfig.java: “both”: “accepts NetherNet and RakNet. Each needs its own UDP port”. 2026년 11월 10일 확인. ↩

  11. spruyt-labs, run NetherNet transport for Bedrock 26.60 clients, 2026년 10월 28일 닫힘: “The first console test failed with initialconnection 83. TCP signaling worked”, 이후 UDP를 고치자 “A console on Minecraft 26.60 reaches the server list and joins”; 시작은 “/tmp/datachannel-java-...: Read-only file system”으로 실패했었음. ↩ ↩

  12. GeyserMC/Geyser 이슈 #6852, “NETHERNET: Terracotta error”, 2026년 10월 31일: 로그에 libcrypto.so.3: cannot open shared object file이 나오고, Geyser 기여자가 “Installing libssl3 should resolve your issue.”라고 답변. ↩

  13. GeyserMC/Geyser 이슈 #6853, 2026년 10월 31일, 11월 10일 기준 열림: Windows용 Bedrock 26.60과 Geyser 2.12.1-b1279에서 “Joining by address from the Servers tab works fine over NetherNet”이지만, 클라이언트의 UDP 7551 LAN 브로드캐스트에는 응답이 없음. 이유는 “Nothing listens on UDP 7551”. ↩ ↩

  14. groundsgg, fix(geyser): restore Bedrock 26.60 connections, 2026년 11월 1일 병합: Geyser 2.12.1 빌드 1280으로 고정하고 TCP와 UDP 19132를 엶. ↩

  15. GeyserMC, Supported versions: “Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3.” 2026년 11월 10일 확인. ↩

AlekseiFounder at Pixly

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

계속 읽기