GDLauncher logo

잠긴 인스턴스란?

CurseForge나 Modrinth에서 모드팩을 설치하면 해당 인스턴스는 기본으로 잠금(locked) 상태가 됩니다. 인스턴스 옆에 자물쇠 아이콘이 표시되고, 팩의 구성을 바꾸는 동작, 개별 모드 추가/제거/업데이트, 이 비활성화됩니다. 플레이는 그대로 가능하고 Java나 RAM 설정 변경, 스크린샷, 그 밖의 모든 작업은 영향이 없습니다. 잠금은 팩이 관리하는 모드 세트만 보호합니다.

잠금이 있는 이유는 모드팩이 테스트되고 버전이 고정된 모드 모음이기 때문입니다. 팩 제작자는 의도적으로 모드 조합과 특정 버전을 골라 둡니다. 모드 하나만 새 버전으로 바꿔도 그 옛 버전에 의존하는 다른 모드가 망가질 수 있습니다. 잠금은 이런 실수를 미리 막아 줍니다.

잠금 중에 할 수 있는 것·없는 것

잠금 상태에서도 다음은 가능합니다:

  • 인스턴스 실행과 플레이.
  • RAM, Java 인수, Java Override 변경.
  • 스크린샷 촬영, 로그 보기.
  • Edit Instance에서 인스턴스 이름과 아이콘 변경.
  • Settings → Change Modpack Version으로 팩 전체를 새 버전으로 업데이트.

잠금 상태에서 불가능한 것:

  • Addons 탭에서의 모든 추가, 모드, 셰이더, 리소스 팩, 데이터 팩, 월드 모두 해당됩니다. 잠금 상태에서는 모든 애드온 종류에서 Add 버튼이 비활성화됩니다.
  • 팩이 관리하는 모드/애드온의 제거 또는 비활성화.
  • 팩이 관리하는 모드를 개별 새 버전으로 업데이트.

Mods와 Addons 탭에서는 비활성 동작 옆에 “이 인스턴스는 잠겨 있어 변경을 적용할 수 없습니다” 라는 힌트가 보입니다. Addons 브라우저에서 설치하려고 해도 Install 버튼 단계에서 동일하게 차단됩니다.

세 가지 상태: Locked / Unlocked / Unpaired

이 세 단어는 GDLauncher 안에서 구분되어 쓰이고 의미가 다릅니다.

  • Locked (잠금): 인스턴스가 CurseForge/Modrinth 모드팩과 연결되어 있고 팩 관리 모드 세트가 읽기 전용. 모드팩 설치 직후의 기본 상태.
  • Unlocked (잠금 해제): 모드팩과의 연결은 유지(팩 이름과 버전은 계속 추적됨)하면서 모드 세트를 자유롭게 편집할 수 있는 상태. GDLauncher가 팩을 계속 기억하므로 새 버전으로 업데이트도 가능합니다. 대신 모드 정합성은 본인이 책임집니다.
  • Unpaired (연결 해제): 모드팩과의 연결이 완전히 풀린 상태. 인스턴스는 커스텀 인스턴스가 되며 파일은 그대로지만 GDLauncher는 팩 업데이트를 추적하지 않고 모드팩 인스턴스로 취급하지도 않습니다. Unlocked → Unpaired는 한 방향입니다.

인스턴스 잠금 해제 방법 (Unlock)

  1. 인스턴스를 열고 톱니 아이콘 클릭(또는 인스턴스 오른쪽 클릭 → Settings).
  2. 설정 페이지 상단의 Modpack Info 섹션으로 이동. 팩의 아이콘, 이름, 현재 버전 아래에 버튼들이 있습니다.
  3. Unlock 버튼(자물쇠 아이콘 옆 “Unlock”) 클릭. 곧바로 잠금 해제 상태로 바뀝니다.

해제 후에는 섹션 표시가 “Unlocked”로 바뀌고 열린 자물쇠 아이콘으로 표시됩니다. 같은 화면에서 다시 잠글 수도 있지만, 직접 모드 세트를 손대기 시작한 뒤에 다시 잠글 실용적인 이유는 별로 없습니다.

연결 해제 방법 (Unpair)

  1. 같은 Modpack Info 섹션에서 Unpair 버튼(가지 아이콘)을 클릭.
  2. 열리는 모달에서 확인. GDLauncher가 영구 작업이라는 점을 알려 줍니다.

연결 해제가 끝나면 Modpack Info 섹션 자체가 사라집니다. 이후로 인스턴스는 커스텀 인스턴스가 되고 Change Modpack VersionReinstall 옵션은 더 이상 적용되지 않습니다.

Reinstall과 Unlock의 차이

Modpack Info 섹션에는 Reinstall 동작도 있습니다. Unlock과는 별개이며 목적도 다릅니다. Reinstall은 현재 버전의 모드팩을 다시 설치해 매니페스트가 정한 대로 팩 관리 모드와 설정을 덮어씁니다. jar가 손상되거나 설정이 사라진 경우, 월드를 잃지 않고 복구할 때 사용합니다.

동작팩 관리 모드에 미치는 영향팩 연결
Unlock그대로, 다만 편집 가능해짐유지
Unpair파일은 남지만 “팩 모드”가 아님해제
Reinstall매니페스트 버전대로 초기화유지
Change Modpack Version새 버전의 매니페스트로 교체유지(버전이 바뀜)

언제 잠금을 풀어야 하는가, 풀지 말아야 하는가

잠금을 푸는 게 적절한 경우:

  • 팩 관리 모드 중 하나에 치명적인 버그나 보안 수정이 있는데 팩 자체가 업데이트되지 않은 경우.
  • 팩에 포함되지 않은 모드/셰이더/리소스 팩/데이터 팩/월드를 추가하고 싶은 경우. Addons 탭의 Add 버튼이 잠금으로 인해 비활성화되므로, UI에서 설치하려면 잠금 해제가 필요합니다.
  • 더 이상 유지보수되지 않는 팩을 직접 이어가는 경우.

잠금을 유지하는 편이 좋은 경우:

  • 팩이 활발히 유지보수 중이라면 팩 작성자에게 버전 정합성을 맡기고 다음 팩 릴리스를 기다리는 게 낫습니다.
  • 큐레이션된 경험을 그대로 즐기고 의도한 모드 세트에서 벗어나고 싶지 않을 때.

실제로는 “잠시 잠금 해제 → 원하는 것 설치 → 잠금 해제 상태로 그대로 유지”의 흐름이 일반적입니다. 직접 추가한 항목은 다시 잠그더라도 그대로 남습니다 (잠금은 팩 관리 세트에만 적용되기 때문). 다만 한 번 직접 손대기 시작하면 다시 잠글 실용적인 이유는 별로 없습니다.

잠금이 아닌 것

잠금은 권한 시스템이나 보안 경계가 아닙니다. GDLauncher UI 안에서 모드를 실수로 변경하지 않게 하는 가드레일일 뿐입니다. 인스턴스 폴더는 디스크 위의 일반 폴더이며, mods 디렉터리에 직접 쓰는 도구나 수동 파일 복사는 잠금을 완전히 우회합니다.

그렇게 추가된 jar는 Mods 탭에서 팩 관리 모드와 함께 보입니다. 그 파일을 제거하려면 UI가 아니라 파일 시스템에서 직접 처리해야 합니다.

간단한 문제 해결

  • ”모드 하나만 업데이트할 수 없어요.”, 잠금이 원래대로 작동하는 중. Settings → Unlock으로 풀거나, 팩 전체를 업데이트하는 Change Modpack Version을 사용하세요.
  • ”잠긴 인스턴스에서 Update All이 비활성화돼 있어요.”, 같은 이유. Change Modpack Version을 쓰거나 먼저 Unlock하세요.
  • ”다시 잠갔는데 직접 추가한 모드가 Mods 탭에 그대로 있어요.”, 잠금은 팩 관리 모드에만 적용됩니다. 사용자 추가 모드는 항상 보입니다.
  • ”Reinstall로 직접 편집한 설정이 덮어쓰였어요.”, 의도된 동작. Reinstall은 팩 매니페스트로 초기화합니다. Reinstall 전에 편집한 설정은 백업해 두세요.