🛠️ 開發者環境配置與 Loom 建置 (MC 26.2)
📌 倉庫原始碼聲明:本 Wiki 中的文件反映了倉庫中的當前原始碼狀態,可能包含領先於 CurseForge 與 Modrinth 上公開發布版本的最新未發布提交或開發中功能。
| 工具鏈資訊面板 | 技術參數 |
|---|---|
| 子專案目錄 | Magnet v26.2/magnet/ |
| Java JDK 目標 | Java 25 (release = 25) |
| Gradle Loom 外掛 | net.fabricmc.fabric-loom 版本 1.15.5 |
| Minecraft 目標版本 | 26.2 |
| Fabric Loader 版本 | 0.19.1 |
| Fabric API 版本 | 0.150.1+26.2 |
| DasikLibrary 版本 | 1.8.23 |
| YACL 版本 | 3.9.5+26.2-fabric |
💻 環境準備與工作區配置
- Java Development Kit (JDK 25):
- 現代 Minecraft 26.x 專案必須基於 Java 25 進行編譯。
- 請設定環境變數
JAVA_HOME,或在gradle.properties中指定org.gradle.java.home=E:/JDK25。
- Git 複製專案:bash
git clone https://github.com/Rifaditya/Instant-Gratification-Magnet-Let-me-get-that-.git cd "Instant-Gratification-Magnet-Let-me-get-that-/Magnet v26.2/magnet"
⚙️ 屬性設定 (gradle.properties)
properties
org.gradle.parallel=false
org.gradle.java.home=E:/JDK25
# Mod Properties
mod_name=Magnet, Let me get that!
mod_version=1.3.9+26.2
maven_group=net.instantgratification
archives_base_name=Magnet-Let-me-get-that
# Dependencies
minecraft_version=26.2
parchment_minecraft_version=26.2
parchment_version=2026.01.22
# Fabric
fabric_version=0.150.1+26.2
fabric_loader_version=0.19.1
# Loom
fabric.loom.suppressJavaCompatibilityChecks=true
loom.suppressJavaCompatibilityChecks=true
dasik_library_version=1.8.23🔨 Gradle 建置指令
bash
# 清理先前的建置快取
./gradlew clean
# 執行自動化單元測試
./gradlew test
# 編譯正式發布 JAR 並觸發自動歸檔
./gradlew build --no-daemon📦 自動化發布歸檔與 Modrinth 同步
MC 26.2 的 build.gradle 內建註冊了 archiveReleaseJar 生命週期任務:
groovy
tasks.register('archiveReleaseJar') {
dependsOn 'build'
doLast {
def archiveDir = file("${project.rootDir}/../../Archive Jar of all versions/MC 26.2")
archiveDir.mkdirs()
def jarFile = tasks.named('jar', Jar).get().archiveFile.get().asFile
if (jarFile.exists()) {
copy {
from jarFile
into archiveDir
}
println "[AUTO-ARCHIVE] Successfully copied ${jarFile.name} to central Archive directory: ${archiveDir.absolutePath}"
}
}
}
tasks.named('build') {
finalizedBy 'archiveReleaseJar'
}建置成功後,產出的 JAR(Magnet-Let-me-get-that-1.3.9+26.2.jar)會自動鏡像至中央歸檔資料夾(Archive Jar of all versions/MC 26.2/),並自動部署至本機 Modrinth 啟動器測試配置目錄中。
