기존 월드를 Minecraft Java 서버에 안전하게 적용하는 방법

Java 서버는 완전한 월드 폴더가 있고 설정이 그 폴더를 정확히 가리킬 때 기존 맵을 불러올 수 있습니다. 시험한다고 현재 월드를 먼저 삭제하지 마세요. 원본과 서버를 각각 보존하고 모든 쓰기를 중단한 뒤 작업 사본을 제한된 환경에서 검증해야 합니다.

실제 Java 월드 루트를 확인하기

압축을 풀고 level.dat를 찾습니다. 이 파일을 바로 포함한 폴더가 월드 루트이며 보통 region, data, playerdata가 함께 있습니다. MyWorld/MyWorld/level.dat라면 안쪽 폴더가 대상입니다. 미해제 ZIP, Bedrock .mcworld, region만 따로 복사한 것은 완전한 Java 월드가 아닙니다.

가능하면 같은 Java 버전으로 사본을 열어 스폰과 알려진 건축물을 확인합니다. 게임 버전, 서버 소프트웨어, 로더, 필수 모드와 데이터팩을 기록하세요.

서버를 완전히 중지하고 양쪽 백업하기

콘솔에서 stop을 실행하고 프로세스 종료를 기다립니다. 실행 중 복사는 청크와 플레이어 데이터가 서로 다른 시점에 저장될 수 있습니다. 원본을 보존하고 업로드용 사본을 만듭니다. 대상에서는 기존 월드, server.properties, 화이트리스트, 권한, 플러그인 데이터를 백업합니다.

기존 월드는 삭제하지 말고 날짜와 함께 보관합니다. 호스팅 패널의 자동 재시작도 전송 중에는 잠시 끕니다.

전체 폴더를 업로드하고 풀기

준비한 루트를 서버 JAR와 server.properties 옆에 공식 파일 관리자, SFTP 또는 직접 복사로 배치합니다. 결과는 server/mapmc-seoul/level.dat 형태여야 하며 이중 폴더나 미해제 ZIP이면 안 됩니다. 짧고 고유한 이름을 사용합니다.

큰 파일의 브라우저 업로드는 명확한 오류 없이 중단될 수 있습니다. 압축 해제 후 용량과 파일 수를 비교하거나 호스트 권장 전송 수단을 사용하세요.

level-name을 정확히 맞추기

서버 중지 상태에서 다음을 편집합니다.

level-name=mapmc-seoul

따옴표, 경로, 확장자 없이 폴더명과 일치해야 하며 Linux는 대소문자를 구분합니다. 일부 패널의 월드 이름 필드가 파일을 덮어쓰므로 저장 후 실제 값을 다시 확인합니다.

버전과 의존성을 재현하기

Minecraft, Java, Paper/Spigot/Fabric/Forge/NeoForge, 로더, 모드, 플러그인, 데이터팩을 맞춥니다. 유일한 사본을 이전 버전에서 열지 마세요. 공식 도움말도 다운그레이드로 인한 손상을 경고합니다. 업그레이드 역시 복제본에서 시험합니다.

검증 중에는 화이트리스트를 사용합니다. 기본 지형이 보여도 모드 블록, 추가 차원, 플러그인 데이터가 빠질 수 있습니다.

접속 전에 시작 로그 읽기

콘솔 처음부터 읽고 기대한 월드명이 나오는지 확인합니다. 데이터 버전, 필수 모드, 권한, level.dat 오류가 있으면 중지합니다. 패널의 온라인 표시는 올바른 월드 로드를 증명하지 않습니다.

빈 월드가 생기면 건축하거나 삭제하지 말고 level-name, 이중 폴더, 업로드 완료, 실행 인스턴스, 패널 덮어쓰기, 작업 경로를 확인하고 logs/latest.log를 보존합니다.

플레이어 데이터와 재시작 검증하기

관리자나 화이트리스트 계정으로 스폰, 알려진 좌표, 네더, 엔드, 인벤토리, 엔더 상자, 발전 과제, 점수판, 데이터팩, 권한을 확인합니다. 인증 모드 변화는 다른 UUID를 만들어 인벤토리 손실처럼 보일 수 있습니다.

작은 변경을 저장하고 정상 종료 후 재시작합니다. 같은 월드와 변경이 돌아올 때만 공개하며, 플레이어가 최근 진행을 확인할 때까지 이전 백업을 유지합니다.

공개 전 확인 목록

• 업로드 폴더 바로 아래 level.dat가 있습니다.
• 원본과 이전 서버의 독립 백업이 있습니다.
• 변경 중 프로세스가 완전히 중지되었습니다.
• level-name과 폴더명이 정확히 같습니다.
• 버전, 로더, 의존성을 점검했습니다.
• 로그, 차원, 플레이어, 저장, 재시작을 검증했습니다.

목표는 단순히 “Done”을 보는 것이 아니라 올바른 세계가 로드되고 계속 안전하게 저장된다는 것을 확인하는 것입니다.