프로토콜 불일치
접속할 때 발생하는 프로토콜 오류를 살펴봐요. 클라이언트와 서버 버전 차이, ViaVersion, 프록시, 그리고 네트워크를 방해하는 모드를 다뤄요.
업데이트 2026년 8월 13일
프로토콜 불일치는 여러 방식으로 나타나요. Outdated client, Internal Exception, 즉시 연결 끊김, 또는 명확한 메시지 없이 거부되는 경우가 있어요.
자주 발생하는 경우
- 클라이언트 버전 ≠ 서버 버전. 가장 단순한 경우는 Outdated client예요.
- ViaVersion이 일부만 구성된 경우: 구버전에서 로그인하려면 ViaBackwards가, 신버전에서 로그인하려면 ViaVersion이 필요해요. 구성 요소가 빠지면 로그인 단계에서 이상한 오류가 발생해요 — 다른 버전에서 로그인.
- 프록시가 다른 버전으로 실행되는 경우. Velocity와 BungeeCord는 게임 버전의 프로토콜을 지원해야 해요.
- 플레이어에게 네트워크 계층을 방해하는 모드가 있는 경우.
- 호환되는 처리가 없는 커스텀 플러그인 패킷 — ProtocolLib.
진단
- 모든 버전에서 모든 사람에게 오류가 발생해요 → 서버 또는 프록시 문제예요.
- 일부 플레이어에게만 발생해요 → 해당 플레이어의 버전 또는 모드 문제예요.
- 플러그인 업데이트 후 나타났어요 → 해당 플러그인 문제예요.
네트워크 환경에서
프록시는 모든 백엔드 버전과 함께 작동할 수 있어야 해요. 하나의 네트워크에서 서버 버전이 섞여 있다면 프록시뿐만 아니라 모든 백엔드에 ViaVersion이 필요해요.
관련 문서 — Internal Exception io.netty.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
