패널에서 버전을 변경하면 선택한 서버 소프트웨어가 설치됩니다. 기존 월드, 모드, 플러그인이 이와 함께 계속 작동하는지는 별도로 확인해야 합니다. 따라서 먼저 복원 가능한 초기 상태를 준비하고 사본으로 테스트를 진행하세요.
세 가지 서로 다른 변경 사항 구분하기
| 변경 사항 | 시작 전 가장 중요한 질문 |
|---|---|
| 동일한 서버 소프트웨어의 새 빌드 | 이 빌드의 변경 사항과 알려진 문제를 확인했습니까? |
| 새로운 Minecraft 버전 | 월드 포맷, 데이터팩, 확장 기능이 이 버전으로 전환될 수 있습니까? |
| 다른 로더 또는 서버 유형 | 대상이 기존 콘텐츠와 그 데이터 포맷을 지원합니까? |
모드팩 업데이트에는 이 세 가지 변경 사항이 동시에 포함될 수 있습니다. 따라서 팩 버전, Minecraft 버전, 로더, Java 런타임을 각각 따로 기록해 두세요. 가능하면 처음에는 한 가지 변경만 선택하여 오류를 특정 단계에 명확히 대응시킬 수 있도록 하세요.
초기 상태 백업하기
수동으로 전체 사본을 만들기 위해 서버를 중지하세요. 월드, 설정, 모드 또는 플러그인과 그 데이터를 백업하세요. 외부 데이터베이스는 이에 맞춘 별도의 백업이 필요합니다. 기존 버전과 시작 매개변수를 기록해 두세요. 이 상태를 기존 환경에서 다시 열 수 있는지 테스트하세요. 자세한 내용은 백업 가이드에 있습니다.
테스트를 위해서는 설치의 별도 사본이 필요합니다. 이 사본이 실제 운영 중인 플러그인 데이터베이스에 기록되어서는 안 됩니다. 접근을 제한하고, 플레이어들이 어느 인스턴스가 실제 운영 서버인지 계속 알 수 있도록 하세요.
목표 소프트웨어 선택하기
바닐라(Vanilla)는 모드 플랫폼이 필요하지 않습니다. Paper와 Purpur는 그에 맞는 플러그인을 위한 것이며, Forge, NeoForge, Fabric, Quilt는 서로 다른 모드 생태계를 형성합니다. 결정적인 기준은 언제나 해당 프로젝트가 특정 로더와 게임 버전에 대해 공식적으로 지원을 발표했는지입니다. 모드의 이름과 알맞은 파일 확장자만으로는 충분하지 않습니다.
NeoForge와 Forge는 서로 대체할 수 없습니다. NeoForge 안내서에는 클라이언트와 서버의 준비 과정이 설명되어 있습니다. 무조건 가장 높은 Java 버전을 설치하지 마세요. 선택한 서버 빌드와 모드팩이 요구하는 런타임을 사용하세요. 서버의 Java 버전에 관한 저희 가이드가 해당 버전을 파악하는 데 도움이 됩니다.
월드 포맷: Java 26.1부터의 변경 사항 유의하기
최신 서버의 월드 디렉터리 구조는 오래된 튜토리얼과 다릅니다. 마이그레이션에 관한 Paper 문서는 26.1 이전 버전용 안내와 현재 절차를 명확히 구분하고 있습니다. 따라서 world_nether 폴더와 world_the_end 폴더가 분리된 오래된 안내는 새 서버에 자동으로 맞지 않습니다.
이는 특히 소프트웨어를 변경한 후 오버월드는 정상으로 보이지만 네더나 엔드가 비어 보이는 경우에 중요합니다. 먼저 버전, 원래의 레이아웃, 실제 파일을 확인하세요. 추정되는 경로 오류를 고치기 위해 차원을 다시 생성하지 마세요. 모드 콘텐츠가 있는 월드에서는 로더를 제거하면 블록, 아이템, 차원이 추가로 사용할 수 없게 될 수 있습니다.
패널에서 변경 진행하기
- 지정된 테스트 인스턴스에서 서버 버전 선택 화면을 여세요.
- 실제로 제공되는 Minecraft와 서버 소프트웨어의 조합을 선택하세요.
- 확인 대화 상자를 읽고 실제로 테스트 사본을 편집하고 있는지 확인하세요.
- 변경을 확인하고 설치가 완전히 끝날 때까지 기다리세요.
- 처음 시작할 때 새 런타임이 시작되는 시점부터 콘솔을 확인하세요. 마지막 중단 메시지만 보지 말고 처음 발생한 오류를 기록해 두세요.
Paper 업데이트 안내서는 Paper 서버를 위한 추가적인 참고 자료입니다. 사용 가능한 로더와 빌드는 다를 수 있으며, 패널에 항목이 있다고 해서 여러분의 개인적인 모드 조합이 지원된다는 의미는 아닙니다.
변경 전후에 동일한 항목 테스트하기
변경하기 전에 알려진 장소와 기능에 대한 간단한 목록을 작성하세요. 변경 후에는 동일한 차원의 동일한 좌표, 플레이어 인벤토리, 엔더 상자, 권한, 포털, 그리고 핵심 모드나 플러그인을 확인하세요. 일반 플레이어 계정도 접속시켜 보세요. 특별 권한을 가진 관리자는 모든 권한 오류를 발견하지 못합니다.
테스트 월드에서 중요하지 않은 부분을 하나 변경해 보세요. 서버를 정상적으로 종료한 후 다시 시작하여 그 변경 사항과 기존 데이터가 모두 유지되는지 확인하세요. 그런 다음에야 실제 운영 전환을 위한 점검 시간을 계획하세요. 테스트 이후 원본에서 계속 플레이가 이루어졌다면, 전환 직전에 새로운 백업이 필요합니다.
변경이 실패했을 때
의존성이 누락된 경우 테스트 사본에서 문서화된 조합을 수정하세요. 모드 블록이 사라진 경우 테스트를 중단하고 백업해 둔 초기 상태를 복원하세요. 이 손상된 사본을 이후 시도를 위한 새로운 기준으로 저장하지 마세요.
되돌아가는 방법은 소프트웨어와 데이터 상태를 함께 복원하는 것입니다. 이미 업그레이드된 월드를 이전 서버 버전으로 그냥 시작하지 마세요. 마이그레이션된 플러그인 데이터베이스 역시 별도의 복원이 필요할 수 있습니다.
FAQ
변경 시 파일이 그대로 유지되나요?
파일이 그대로 남아 있다는 사실만으로는 그 파일을 읽을 수 있는지, 혹은 모든 게임 콘텐츠가 보존되는지에 대해 알 수 없습니다. 결정적인 것은 대상 소프트웨어로 직접 확인하는 것입니다.
Forge 모드를 Paper에서 계속 사용할 수 있나요?
Paper는 Forge 모드를 불러오지 않습니다. 필요한 기능에 맞는 대안을 찾고 월드 마이그레이션은 별도로 테스트하세요. 동일한 기능이라고 해서 동일한 데이터를 의미하지는 않습니다.
모든 클라이언트가 같은 버전이어야 하나요?
테스트할 때는 서버에서 지원하는 클라이언트 버전과 필요한 모드를 사용하세요. 프로토콜 호환성이 추가로 있다고 해서 모드나 월드 호환성이 보장되는 것은 아닙니다.
관련 가이드
다른 언어로 읽기
Deutsch · English · Español · Français · Nederlands · Português · Русский
Change the Minecraft version (Java set automatically): view an example
Our own captures from a demonstration environment. The version and setup shown may differ from your server.
- Open Manage, then Version.
- Choose the target version, here 26.2, and enter the server name to confirm.
- Click Switch version. We set the matching Java version automatically.
GSH-Testserver · 2026-09-28
Switch server software (Paper → Fabric): view an example
Our own captures from a demonstration environment. The version and setup shown may differ from your server.
- Open Manage and Change Game Type. Choose the new server software, here Fabric.
- Enter the server name to confirm and click Change game type.
- A restore point is created automatically first. Wait until the switch is complete.
GSH-Testserver · 2026-09-28