JDK 25 설치와 환경변수 설정

NeoForge 26 모드를 개발하려면 가장 먼저 JDK(Java Development Kit)를 설치해야 합니다. 이 챕터에서는 Adoptium Temurin JDK 25를 Windows에 설치하고, JAVA_HOME과 PATH 환경변수를 올바르게 구성하는 전 과정을 다룹니다.

왜 JDK 25인가

NeoForge 26은 Java 25 이상을 요구합니다. Minecraft 1.21.x 기반의 NeoForge 26.1은 최신 Java 기능(레코드, 패턴 매칭, 가상 스레드 등)을 적극 활용하도록 설계되었고, Gradle 빌드 스크립트도 --release 25 플래그를 기본으로 사용합니다.

⚠️ JDK 21 이하 사용 시

NeoForge 26은 JDK 25+를 요구합니다. JDK 21로 빌드하면 다음 오류가 발생합니다:

error: Source option 25 is not supported. Use --release 25 or later.

반드시 JDK 25를 설치하세요.

1단계: Adoptium Temurin JDK 25 다운로드

Adoptium은 Eclipse 재단이 관리하는 OpenJDK 배포판입니다. 상업적 제약 없이 무료로 사용할 수 있고, LTS 및 최신 버전 모두 제공합니다.

1. 브라우저에서 아래 URL로 이동합니다:

   https://adoptium.net/temurin/releases/?version=25
   

2. Operating System: Windows, Architecture: x64, Package Type: JDK, Version: 25 로 필터를 맞춥니다.

3. .msi 파일을 클릭해 다운로드합니다. (예: OpenJDK25U-jdk_x64_windows_hotspot_25_xx.msi) 원본 보기

2단계: 설치 마법사 실행

다운로드한 .msi 파일을 실행합니다.

1. Welcome 화면에서 Next를 클릭합니다.
2. Custom Setup 화면에서 다음 두 항목이 체크되어 있는지 확인합니다:
   • Set JAVA_HOME variable — 이 항목이 핵심입니다. 체크하지 않으면 수동으로 환경변수를 설정해야 합니다.
   • Add to PATH — java 명령어를 어디서든 실행할 수 있게 합니다.
3. 설치 경로는 기본값(C:\Program Files\Eclipse Adoptium\jdk-25...)을 그대로 사용합니다.
4. Install을 클릭하고 완료될 때까지 기다립니다.

원본 보기

1 / 7

3단계: 환경변수 확인

설치가 끝나면 PowerShell을 새로 열고 아래 명령어로 환경변수를 확인합니다.

# JAVA_HOME 경로 확인
$env:JAVA_HOME
 
# java 실행 파일 경로 확인
(Get-Command java).Source
 
# 버전 확인
java -version

정상적으로 설치되었다면 다음과 같은 출력이 나옵니다:

C:\Program Files\Eclipse Adoptium\jdk-25.0.x.x-hotspot

C:\Program Files\Eclipse Adoptium\jdk-25.0.x.x-hotspot\bin\java.exe

openjdk version "25" 2025-09-16
OpenJDK Runtime Environment Temurin-25+... (build 25+...)
OpenJDK 64-Bit Server VM Temurin-25+... (build 25+..., mixed mode, sharing)

출력 첫 줄에 openjdk version "25"가 포함되어 있으면 설치 성공입니다.

4단계: JAVA_HOME 수동 설정 (설치 시 체크 누락한 경우)

설치 마법사에서 Set JAVA_HOME variable을 체크하지 않았다면 수동으로 설정합니다.

# 현재 사용자 환경변수에 JAVA_HOME 추가
[System.Environment]::SetEnvironmentVariable(
    "JAVA_HOME",
    "C:\Program Files\Eclipse Adoptium\jdk-25.0.x.x-hotspot",
    "User"
)
 
# PATH에 bin 디렉토리 추가
$currentPath = [System.Environment]::GetEnvironmentVariable("PATH", "User")
[System.Environment]::SetEnvironmentVariable(
    "PATH",
    "$currentPath;$env:JAVA_HOME\bin",
    "User"
)

설정 후 PowerShell을 새로 열어야 변경사항이 반영됩니다.

대안: SDKMAN / Scoop

여러 JDK 버전을 자주 전환해야 한다면 SDKMAN(WSL/Git Bash 환경) 또는 Scoop(Windows 네이티브)을 사용할 수 있습니다. 단, 이 코스에서는 MSI 설치 방식을 기준으로 설명합니다.

검증 체크리스트

• java -version 출력 첫 줄에 openjdk version "25" 포함
• $env:JAVA_HOME이 JDK 25 설치 경로를 가리킴
• (Get-Command java).Source가 JDK 25 bin\java.exe를 가리킴

세 항목 모두 확인되면 다음 챕터로 넘어갈 준비가 된 것입니다.