이동되는 것
Runtime Path 안의 모든 것: 인스턴스(모드, 월드, 설정), Minecraft 공유 에셋, Minecraft 공유 라이브러리, GDLauncher가 다운로드한 Java, 런처 데이터베이스, 앱 전역 로그. 본질적으로 GDLauncher가 머신에 만든 모든 무거운 것. 이동하지 않는 것: App Data Path(창 상태, Electron 캐시, 최상위 설정). OS 표준 위치에 남고 보통 건드리지 않습니다.
예상 크기
인스턴스 없는 깨끗한 설치는 약 1 GB(주로 Minecraft 에셋과 Java 설치). 각 모드팩은 대략 자신의 다운로드 크기만큼 추가하므로 큰 팩 몇 개면 50 GB를 넘기기 쉽습니다. OS 파일 매니저에서 현재 데이터 경로 크기를 보면 마이그레이션 시간을 짐작할 수 있습니다.
이미 수동으로 이동한 경우
gdlauncher_carbon/data를 Settings를 거치지 않고 손으로 다른 위치에 복사했다면 GDLauncher를 새 위치로 가리킬 수 있습니다. 유효한 GDLauncher 데이터가 이미 있는 경로를 입력하면 마이그레이션이 건너뛰어지고 GDLauncher는 설정만 갱신. 다른 머신으로 옮긴 뒤 새 설치가 이주된 데이터를 가리키게 할 때 유용.
마이그레이션이 실패하면
도중에 문제가 생기면 진행 모달에 에러가 나타납니다. 흔한 원인: 대상 드라이브 공간 부족(소스 데이터와 같은 정도의 빈 공간이 필요, 에러 메시지에 부족 바이트 표시). 권한 거부(Windows에서 Program Files나 C:\ 루트는 관리자 권한 필요, Linux/macOS에서는 사용자 소유 경로여야 함; 사용자 소유 폴더 선택). 대상이 읽기 전용(일부 네트워크 드라이브는 기본 읽기 전용으로 마운트; GDLauncher 외부에서 그곳에 파일을 만들 수 있는지 먼저 확인). 마이그레이션 실패 후 GDLauncher는 원래 위치로 폴백하고 에러 메시지를 표시합니다. 자세한 건 __gdl_logs__의 파일에서 볼 수 있습니다.
runtime_path_override 마커
성공적인 이동 후 GDLauncher는 App Data Path(Runtime Path 안이 아니라) 안에 runtime_path_override라는 작은 텍스트 파일을 씁니다. 내용은 새 Runtime Path. 매 실행마다 이 파일을 읽어 데이터 위치를 파악합니다. 실수로 지우면 런처가 기본 위치로 폴백하고, Settings → Runtime Path에서 옮긴 폴더를 다시 가리킬 때까지 옮긴 데이터를 보지 못합니다('이미 사용 중'으로 인식되어 복사 없이 전환).
플레이 중 Runtime Path 동기화 금지
OneDrive, iCloud, Dropbox 등은 파일 핸들을 두고 GDLauncher와 경쟁합니다. Runtime Path가 이런 도구들이 적극적으로 동기화하는 폴더 안에 있으면 이상한 '파일 사용 중' 오류와 가끔의 세이브 손상이 발생합니다. 연속 동기화되는 드라이브가 아니라 오프라인 백업되는 드라이브(스냅샷, restic, Backblaze 등)에 Runtime Path를 두세요.