실제로 백업해야 하는 것
폴더 하나, 런타임 경로면 됩니다. 그 안에 모든 인스턴스(모드, 세이브, 설정, 스크린샷, 월드 데이터), 공유 Minecraft 에셋, 공유 라이브러리, GDLauncher가 받아둔 Java 런타임, 계정과 설정이 담긴 런처 SQLite 데이터베이스(gdl_conf.db), 그리고 __gdl_logs__/의 앱 전역 로그가 들어 있습니다. 이 폴더만 백업하면 중요한 건 전부 챙긴 겁니다.
Electron 자체 데이터 폴더는 백업할 필요 없습니다. 창 위치나 내부 캐시처럼 런처가 첫 실행 때 다시 만드는 것들만 들어 있어서, 빼도 잃는 게 없습니다.
런타임 경로 찾기
가장 쉬운 방법은 GDLauncher를 열고 Settings → Runtime Path에 표시된 경로를 복사하는 겁니다. 경로를 옮긴 적이 있든 없든 이게 기준입니다.
GDLauncher가 아예 안 열린다면(드라이브 고장, OS 손상 등) 기본 위치는 다음과 같습니다:
- Windows:
%APPDATA%\gdlauncher_carbon\data(Win+R이나 탐색기 주소창에 붙여넣기). - macOS:
~/Library/Application Support/gdlauncher_carbon/data(Finder에서 Cmd+Shift+G, 붙여넣고 Enter). - Linux:
~/.local/share/gdlauncher_carbon/data(XDG_DATA_HOME을 설정했다면$XDG_DATA_HOME/gdlauncher_carbon/data).
Settings에서 런타임 경로를 옮긴 적이 있다면 위 기본 폴더는 없거나 비어 있고, 그 옆의 runtime_path_override 파일이 실제 위치를 가리킵니다. 아무 텍스트 편집기로 열면 한 줄짜리 절대 경로가 진짜 데이터 위치입니다.
백업하기
먼저 GDLauncher를 종료하세요. 런타임 경로의 SQLite 데이터베이스는 런처가 닫혀 있으면 안전하게 복사되지만, 쓰는 중에 가져가면 손상된 사본이 나올 수 있습니다.
그다음 런타임 경로 폴더를 구조 그대로 원하는 백업 위치로 복사하세요. 다른 드라이브, USB, NAS, 오프라인 클라우드 보관소 어디든 상관없습니다. 곧 지울 그 드라이브만 아니면 됩니다.
포맷 후 복원하기
새로 설치한 OS에서:
- GDLauncher를 설치하고 한 번 실행했다가 닫습니다. 기본 폴더가 만들어집니다.
- 백업해둔 런타임 경로 폴더를 새 시스템의 최종 위치로 복사합니다. 예전과 같은 드라이브/경로여도 되고, 더 큰 드라이브 같은 새 위치여도 됩니다.
- GDLauncher를 다시 열고 Settings → Runtime Path에서 방금 복원한 폴더를 지정합니다. 이미 유효한 GDLauncher 데이터가 있는 폴더를 지정하면 런처가 이를 감지해 복사나 중복 없이 그대로 전환합니다.
- 런처를 재시작합니다. 인스턴스, 계정, 설정, Java 설치가 모두 돌아와 있습니다.
백업에 포함되는 것과 아닌 것
런타임 경로를 백업하면 보존되는 것:
- 모든 인스턴스: 모드, 설정, 저장된 월드, 스크린샷, 리소스팩, 셰이더팩, 데이터팩.
- 로그인된 Microsoft 계정(토큰과 함께 런처 데이터베이스에 저장). 첫 실행에서 갱신이 필요할 수 있지만 다시 로그인할 필요는 없습니다.
- 설정: 테마, 언어, 기본 Java 인자, 기본 메모리, 런타임 경로 자체.
- GDLauncher가 받아둔 Java 설치본. 이건 빼고 첫 실행 때 다시 받게 해도 됩니다. 백업은 빨라지고 대신 한 번 다운로드가 발생합니다.
- 앱 전역 로그와 인스턴스별 로그.
보존되지 않는 것(그리고 필요 없는 것):
- Electron 창 상태(크기, 위치). 런처가 새 기본값을 고를 뿐입니다.
- OS 키체인 항목. GDLauncher는 계정을 자체 DB로 관리합니다.
공간이 부족할 때의 최소 백업
런타임 경로 전체가 안 들어가면 <runtime_path>/instances/와 <runtime_path>/gdl_conf.db만 복사하세요. instances에는 월드와 설정이, 데이터베이스에는 계정과 설정이 들어 있습니다. 캐시된 Minecraft 에셋, 라이브러리, Java 설치본은 잃지만 이건 첫 실행에서 다시 받습니다.
정말 최소한만 챙기려면 각 인스턴스의 instance/saves/ 하위 폴더만 복사하세요. 월드 파일만 남습니다. 인스턴스 구성(모드 목록, 버전, 모드로더)은 잃지만 월드 데이터는 살아남아 나중에 새로 만든 인스턴스에 넣을 수 있습니다.
포맷만이 아니라 드라이브나 PC까지 바꾸는 경우
백업은 똑같고 복원만 새 기기에서 하면 됩니다. GDLauncher의 런타임 데이터는 같은 OS 계열끼리는 그대로 옮겨집니다. Windows → Windows, Linux → Linux는 바로 됩니다. Windows ↔ macOS ↔ Linux를 넘나드는 경우에도 월드, 설정, 리소스팩, 대부분의 모드는 그대로 쓰이지만, Java는 OS마다 바이너리가 달라 다시 감지되고 네이티브 라이브러리는 첫 실행에서 다시 받을 수 있습니다.
참고: 수동 복사 대신 앱 안에서 데이터를 옮기는 방법은 GDLauncher의 데이터를 다른 드라이브로 옮기기 문서를 보세요.
플레이 중에 런타임 경로를 동기화하지 마세요
OneDrive, iCloud, Dropbox, Google Drive 데스크톱 등은 GDLauncher와 파일 핸들을 두고 경쟁합니다. 복원한 뒤 이런 도구가 활발히 동기화하는 폴더 안에 런타임 경로를 두지 마세요. "파일이 사용 중" 오류와 간헐적인 세이브 손상이 생깁니다. 런타임 경로는 평범한 로컬 드라이브에 두고 백업은 따로 하세요.