GDLauncher logo

GDLauncher에서 Java 버전과 인스턴스별 오버라이드 관리

커스텀 Java 설치를 추가하고, 프로필을 만들고, 인스턴스별 Java 오버라이드를 설정해 각 모드팩이 올바른 Java로 자동 실행되도록.

업데이트됨: May 2026

Minecraft의 Java 사정

Minecraft는 자체 버전에 따라 다른 Java 버전이 필요합니다: 1.16 이전은 Java 8, 1.17은 Java 16, 1.18부터 1.20.4는 Java 17, 1.20.5 이후는 Java 21. 모드는 특정 Java 버전에 대해 컴파일됩니다. Java 17용으로 빌드된 모드는 Java 8 JVM에서 돌아가지 않습니다(바이트코드가 너무 새로움). 반대 방향은 바이트코드 수준에서는 기술적으로 동작하지만, 실제로는 옛 Minecraft 모드 로더(Forge 1.12.2 등)가 최신 Java를 지원하지 않기 때문에 결국 각 MC 버전은 맞는 Java를 원합니다. GDLauncher는 두 가지로 해결: managed Java 설치(Minecraft 버전에 따라 자동 다운로드)와 인스턴스별 오버라이드(특정 인스턴스에 특정 Java 강제).

Managed와 Custom Java

Managed: GDLauncher가 Azul Zulu 빌드에서 Java를 직접 다운로드/설치. Runtime Path 안 managed_javas/에 존재. 디스크 정리하려면 휴지통 아이콘으로 삭제. Custom: 시스템에 이미 설치된 Java를 가리킴(Adoptium Temurin, Oracle JDK, GraalVM 등). GDLauncher는 경로만 검증; 설치는 관리하지 않음. 이미 튜닝된 JDK를 쓰고 싶을 때 유용. 시스템 감지 Java(아무것도 안 해도 찾아지는 것)는 런처에서 삭제할 수 없음, GDLauncher가 소유하지 않기 때문.

프로필

프로필은 'Foo 런타임을 요청하면 이 Java를 사용'이라는 이름 있는 규칙. 시스템 프로필은 Mojang Java 런타임 계층에 매칭(Java 8 → Legacy, Java 16 → Alpha, Java 17 → Beta/Gamma, Java 21 → Delta, Java 25 → Epsilon). 자동 관리 토글이 켜져 있으면 런처가 각 계층에 알맞은 Java를 자동 선택, 끄면 직접 할당. 커스텀 프로필은 특정 경로에 이름을 주고 인스턴스 오버라이드에서 참조할 수 있게 함. 대부분의 사람에겐 커스텀 프로필 불필요, 시스템 프로필 + 자동 관리로 일반 케이스는 처리.

인스턴스별 오버라이드

인스턴스 설정의 Java Path/Profile 섹션에 토글. Off(기본): 인스턴스가 Minecraft 버전 기반(시스템 프로필 경유)으로 런처가 고른 Java를 사용. On: Path(리터럴 파일) 또는 Profile(이름 있는 프로필)을 지정. 오버라이드가 필요한 때: 모드팩이 명시적으로 'Java X.Y.Z에서 실행해야 함'이라 못 박을 때, 특정 JVM(GraalVM, Liberica NIK)을 한 인스턴스에서만 테스트해 보고 기본값은 그대로 두고 싶을 때, 여러 Java 17 설치(Adoptium, Microsoft 등)가 있어 특정 걸 고르고 싶을 때.

실제로 어떤 Java가 쓰였는지 확인

실행 후 인스턴스 오른쪽 클릭 → View Logs. 런처 로그에 호출된 Java 실행 파일의 전체 경로가 적혀 있음. 기대한 오버라이드와 일치하는지 대조.

흔한 Java 오류

UnsupportedClassVersionError: 모드 또는 서버가 실행 중인 Java보다 새 Java용으로 빌드됨. 에러에 'class file version' 번호가 포함되며, 61.0은 Java 17, 65.0은 Java 21을 의미. 프로필 또는 오버라이드로 더 새 Java로 전환. 'Could not reserve enough space for object heap': 32비트 Java가 쓰이는 중(Windows에서 약 1.5 GB 힙 제한), 또는 시스템이 연속된 메모리를 충분히 줄 수 없음. 64비트 JDK를 설치했고 오버라이드가 그것을 가리키는지 확인하고, 그래도 실패하면 RAM 슬라이더를 낮추세요. 'Could not find or load main class': 보통 모드 로더(Forge, NeoForge, Fabric)의 불완전한/손상된 설치 또는 누락된 라이브러리/jvm args 파일이 원인이고, Java 자체의 문제가 아닙니다. 인스턴스 설정에서 로더를 다시 설치하거나 인스턴스를 새로 만드세요. 그래도 지속된다면 오버라이드에서 다른 Java를 시도하세요.

GDLauncher를 사용해 볼 준비가 되셨나요?

GDLauncher를 다운로드하고 모드가 적용된 마인크래프트를 곧바로 즐겨 보세요. 모드팩과 모드를 한 번의 클릭으로 설치할 수 있습니다.

GDLauncher 다운로드