
ViaVersion — Minecraft 서버에서 다양한 버전의 클라이언트를 지원하는 플러그인
ViaVersion을 사용하면 더 최신 버전의 클라이언트를 가진 플레이어가 더 낮은 버전의 서버에 접속할 수 있습니다. 서버가 26.1.2에서 실행 중이고 플레이어가 이전 버전의 게임을 실행했다면, 플레이어 쪽에서 아무 조작 없이도 접속됩니다. 이…
ViaVersion을 사용하면 더 최신 버전의 클라이언트를 가진 플레이어가 더 낮은 버전의 서버에 접속할 수 있습니다. 서버가 26.1.2에서 실행 중이고 플레이어가 이전 버전의 게임을 실행했다면, 플레이어 쪽에서 아무 조작 없이도 접속됩니다. 이 플러그인은 무료이며 오픈 소스입니다.
ViaVersion — Minecraft 서버에서 다양한 버전의 클라이언트를 지원하는 플러그인
Minecraft 버전: 26.1.2
로더: Paper
플러그인 버전: 5.9.0
Java: 25
ViaVersion을 사용하면 더 최신 버전의 클라이언트를 가진 플레이어가 더 낮은 버전의 서버에 접속할 수 있습니다. 서버가 26.1.2에서 실행 중이고 플레이어가 이전 버전의 게임을 실행했다면, 플레이어 쪽에서 아무 조작 없이도 접속됩니다. 이 플러그인은 무료이며 오픈 소스입니다.
작동 원리
플러그인은 클라이언트와 서버 사이의 네트워크 패킷을 가로채어 프로토콜 간에 실시간으로 변환합니다.
가장 완전한 지원은 Paper에서 제공됩니다. BungeeCord와 Velocity에서는 ViaVersion을 백엔드 서버가 아니라 프록시 자체에 설치합니다.
명령어
모든 명령어는 채팅 또는 서버 콘솔에 입력합니다. 게임 내에서 실행하려면 운영자 권한이 필요합니다.
명령어 표
명령어 | 기능 |
| 접속 중인 플레이어와 그들의 클라이언트 버전 목록 |
| 플레이어 간 충돌을 방지하는 자동 명령을 켜고/끕니다 |
| 플레이어의 패킷을 콘솔에 출력합니다 — 지원팀 요청 시에만 |
| Netty의 ResourceLeakDetector를 켭니다 — 지원팀 요청 시에만 |
| 접속 시 새 업데이트 알림을 켜고/끕니다 |
| 지원팀에 문의할 때 사용할 진단 정보가 담긴 링크를 생성합니다 |
| 특정 플레이어 또는 전체에 대한 상세한 연결 정보 |
| 모든 플레이어와 초당 패킷 수 목록 |
| 설정을 다시 불러옵니다; 접속한 모든 플레이어를 강제 퇴장시킵니다 |

alt: /viaver list 명령어 출력
설정
파일: plugins/ViaVersion/config.yml. 첫 실행 시 자동으로 생성됩니다.
block-versions — 특정 버전의 접속을 차단합니다. 연산자 < 와 >를 지원합니다, 예: block-versions: ["<1.17"].
block-disconnect-msg — 차단된 버전으로 인한 연결 해제 시 표시되는 메시지. Minecraft color codes를 지원합니다.
logging.log-blocked-joins — 차단된 버전의 접속 시도를 콘솔에 기록합니다. 기본값은 false입니다.
send-supported-versions — true일 때 서버가 핑 응답에서 지원되는 버전 목록을 클라이언트에 알립니다.
패킷 제한
기본적으로 플레이어는 초당 800패킷을 초과하면 강제 퇴장됩니다. 추가로 시간 창 기준의 동작이 추적됩니다 — 예를 들어, sustained-max-per-second: 200, sustained-period-seconds: 7 및 sustained-threshold: 4일 때, 플레이어가 7초 중 4초 동안 초당 200패킷을 초과하면 강제 퇴장됩니다. 제한을 끄려면 — enabled: false.
추가 매개변수
hologram-patch — 더 낮은 버전의 서버에서 1.9+ 클라이언트를 위한 홀로그램 높이를 수정합니다. 기본값은 false입니다. HolographicDisplays 같은 플러그인의 홀로그램이 잘못된 높이에 표시된다면 이 매개변수를 켜세요.
serverside-blockconnections — 1.13+ 클라이언트를 위한 블록 연결의 서버 측 처리를 켭니다. 기본값은 true입니다. 울타리, 유리판, 문의 올바른 표시에 영향을 줍니다. blockconnection-method 매개변수는 처리 방식을 결정합니다: packet — 패킷 수준, world — 월드 수준 (실험적).
use-1_15-instant-respawn — 값이 true일 때 1.15+ 클라이언트는 사망 화면 없이 즉시 리스폰됩니다. 기본값은 false입니다.
armor-toggle-fix — 1.19.4+ 클라이언트에서 이미 사용 중인 슬롯의 갑옷 교체 버그를 수정합니다. 기본값은 true입니다.
enforce-secure-chat — 접속 시 1.19+ 클라이언트에 전송되는 secure chat 값을 결정합니다. 서버가 1.19 이상에서 실행 중이라면 변경하지 않는 것을 권장합니다.
결론
ViaVersion은 단순하지만 중요한 한 가지 문제, 즉 클라이언트와 서버의 버전 불일치를 해결합니다. 관리자가 오래된 플러그인에 대한 의존성 때문에 서버를 업데이트할 수 없는데 플레이어들은 이미 더 최신 버전을 사용 중이라면 — 이 플러그인은 클라이언트 측 변경 없이 문제를 해결합니다. 기본 사용에는 설정이 필요하지 않습니다.
설치
일반적인 설치는 약 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.








