본문으로 건너뛰기
버전: Minecraft 26.2

모드 템플릿 받기

Poly 모드 프로젝트는 모드 템플릿에서 시작합니다. 템플릿은 예시 아이템, 블록, 게임 테스트가 든 작은 Gradle 프로젝트입니다. Poly 모드 로더 0.2.0-beta.1용 템플릿은 Poly 모드 로더 웹사이트의 Maven 저장소 https://www.polymc.net/maven/에 있습니다.

다운로드와 압축 풀기​

Poly 모드 로더 0.2.0-beta.1용 템플릿 zip을 다운로드해 압축을 풀고, 폴더 이름을 프로젝트 이름으로 바꿉니다. 이 튜토리얼에서는 crystal-garden이라고 부릅니다.

Invoke-WebRequest https://www.polymc.net/maven/dev/polymodloader/poly-mod-template/0.2.0-beta.1/poly-mod-template-0.2.0-beta.1.zip -OutFile poly-mod-template-0.2.0-beta.1.zip -UseBasicParsing
Expand-Archive poly-mod-template-0.2.0-beta.1.zip -DestinationPath .
Rename-Item poly-mod-template crystal-garden
cd crystal-garden

브라우저로 다운로드해도 됩니다. https://www.polymc.net/maven/ 페이지에 공개된 모든 템플릿 버전의 링크가 있습니다.

들어 있는 것​

poly-mod-template/
├─ settings.gradle.kts          프로젝트 이름, Gradle이 Poly 모드 로더를 찾는 곳
├─ build.gradle.kts             모드 플러그인 dev.polymodloader.mod 0.2.0-beta.1, polyResources
├─ gradle.properties            실행할 Minecraft 버전(선택)
├─ gradlew, gradlew.bat, gradle/   Gradle Wrapper 9.8.1
├─ .run/runClient.run.xml       IntelliJ 실행 구성
├─ src/main/java/com/example/mymod/MyMod.java   엔트리포인트(루비 아이템, 루비 블록, 게임 테스트 2개)
├─ src/main/resources/poly.mod.json             모드 메타데이터
└─ README.md

my_mod, My Mod, com.example.mymod는 자리 표시용 이름입니다. 다음 페이지에서 명령 한 줄로 바꿉니다.

따로 설치하지 않아도 되는 것​

JDK 25(요구 사항 참고) 말고는 설치할 것이 없습니다.

  • 템플릿의 Gradle Wrapper가 Gradle 9.8.1을 다운로드합니다.
  • Gradle이 dev.polymodloader.mod 플러그인과 Poly 모드 로더 자체를 웹사이트의 Maven 저장소에서 다운로드합니다. 템플릿의 build.gradle.kts에는 버전 0.2.0-beta.1이 이미 적혀 있습니다.
  • 첫 실행에서 Gradle이 Mojang에서 Minecraft 26.2을 다운로드하고 해시로 검증합니다. 다음부터는 캐시를 사용합니다.

그래서 첫 빌드에는 인터넷 연결이 필요합니다. 웹사이트의 저장소에 연결할 수 없으면 다른 곳으로 넘어가지 않고 빌드가 실패합니다. 필요한 파일이 모두 Gradle 캐시에 있으면 --offline으로 오프라인에서도 빌드할 수 있습니다.

로컬 Poly 모드 로더 빌드로 시험하기​

Poly 모드 로더 소스에 접근할 수 있는 기여자에게만 해당합니다. 소스 저장소는 지금 비공개입니다. Poly 모드 로더 소스 폴더에서 로컬 빌드를 Maven Local에 게시한 뒤, 모드 프로젝트의 명령에 -PpolyLocalSdk를 붙입니다. 이 속성이 없으면 웹사이트에 이미 있는 버전은 Maven Local이 아니라 웹사이트에서 가져옵니다.

Poly 모드 로더 소스 폴더
.\gradlew.bat publishToMavenLocal                 # Poly 모드 로더 모듈
.\gradlew.bat -p build-logic publishToMavenLocal  # Gradle 플러그인 dev.polymodloader.mod
모드 프로젝트
.\gradlew.bat build -PpolyLocalSdk

다음 단계​

프로젝트 만들기로 넘어갑니다.

Buy me a coffee