요구 사항
Poly 모드를 만들고 실행하려면 다음이 필요합니다.
| 항목 | 버전 | 비고 |
|---|---|---|
| JDK | 25 | Minecraft 26.2이 Java 25를 요구합니다. 컴파일과 게임 실행에 사용합니다. |
| Gradle을 실행할 JDK | 17 이상 | 검증은 JDK 25로 했습니다. 같은 JDK를 쓰는 것이 가장 간단합니다. |
| Minecraft | 기본 26.2 (polyMinecraft로 26.1, 26.1.1, 26.1.2, 26.2 중 선택) | 직접 설치하지 않습니다. 첫 실행 때 Gradle이 Mojang에서 받아 해시를 확인합니다. |
| 인터넷 연결 | — | 첫 실행 때 게임 파일과 라이브러리를 다운로드합니다. |
| IntelliJ IDEA | 선택(2025.2 이상) | Gradle 프로젝트로 열면 됩니다. 자세한 내용은 IntelliJ IDEA를 참고하세요. |
모드 템플릿에 Gradle Wrapper(9.8.1)가 들어 있어서 Gradle도 따로 설치하지 않습니다.
JDK 지정하기
Gradle toolchain은 설치된 JDK 25를 자동으로 찾습니다. Gradle 자체를 특정 JDK로 실행하려면 JAVA_HOME을 그 JDK 폴더로 지정하세요.
- Windows (PowerShell)
- macOS · Linux (bash)
$env:JAVA_HOME = "C:\Program Files\Java\jdk-25" # 설치한 JDK 25 폴더
java -version
export JAVA_HOME=/path/to/jdk-25 # 설치한 JDK 25 폴더
java -version
명령 표기
이 문서의 Gradle 명령은 운영체제마다 탭이 있습니다. Windows는 .\gradlew.bat, macOS·Linux는 ./gradlew입니다. 탭을 하나 고르면 사이트의 모든 명령이 함께 바뀝니다.
- Windows (PowerShell)
- macOS · Linux (bash)
.\gradlew.bat build
./gradlew build
Minecraft 파일
- Poly 모드 로더는 Minecraft 파일을 재배포하지 않습니다. 빌드가 Mojang 서버에서 받아 해시를 확인하고 Gradle 캐시(
~/.gradle/caches/poly-minecraft)에 둡니다. 모든 모드 프로젝트가 이 캐시를 같이 씁니다. - 개발용 실행은 오프라인 계정(
PolyDev)을 씁니다. 싱글 플레이는 되지만 온라인 서버와 Realms는 인증 오류로 거부합니다. 정상입니다.
Minecraft EULA
전용 서버를 실행(runServer)하려면 Minecraft EULA에 동의해야 합니다. Poly 모드 로더는 사용자를 대신해 동의하지 않습니다. 내용을 직접 읽어 보고 동의한다면 run/server/eula.txt에 eula=true를 직접 적으세요.
프로젝트 위치
모드 프로젝트는 OneDrive 같은 동기화 폴더 밖에 두세요. 동기화 프로그램이 Gradle과 Git이 쓰는 파일을 잠글 수 있습니다.