Skip to content
호스팅 · 플러그인

ProtocolLib: 왜 필요한가

네트워크 패킷을 다루는 라이브러리예요. 어떤 플러그인이 이를 요구하는지, 버전을 업데이트할 때 왜 가장 먼저 깨지는지, 어떻게 고치는지 알아봐요.

업데이트 2026년 8월 13일

ProtocolLib는 플러그인이 클라이언트와 서버 사이의 네트워크 패킷에 접근할 수 있게 해줘요. 그 자체로는 아무 일도 하지 않지만, 많은 인기 플러그인이 이것 없이는 작동하지 않아요.

누가 필요로 하나요

구세대 홀로그램, 일부 안티치트, 스킨 및 NPC 플러그인, 커스텀 인터페이스, 블록 표시를 재정의하는 플러그인이 필요로 해요.

핵심 특징

ProtocolLib는 일반 플러그인보다 특정 Minecraft 버전의 내부 구조에 더 강하게 묶여 있어요. 그래서 서버 업데이트 후 가장 먼저 깨져요:

[ProtocolLib] Unsupported server version

유일한 해결책은 ProtocolLib를 사용 중인 버전에 맞는 빌드로 업데이트하는 거예요. 때로는 개발 빌드가 필요해요: 정식 릴리스는 나중에 나오거든요.

깨졌을 때 무슨 일이 일어나나요

ProtocolLib에 의존하는 플러그인은 로드되지 않아요: 로그에 NoClassDefFoundError가 표시되거나 의존성을 나타내는 로드 실패가 나타나요 — 누락된 의존성.

부하

패킷 가로채기는 공짜가 아니에요. ProtocolLib가 필요한 플러그인이 하나뿐이고 그 플러그인을 사용하지 않는다면, 둘 다 제거하세요. 플레이어가 많은 서버에서는 프로파일링에서 이것이 눈에 띄어요 — Spark.

확인

/protocol dump

버전과 상태를 보여줘요. 플러그인이 호환성 문제를 호소하는데 서버는 작동하는 것처럼 보인다면, 일부 기능은 이미 조용히 비활성화된 상태예요.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기