SuperAPI AI 工具集

minecraft-multiloader

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:该技能面向需要一套共享代码库同时产出 NeoForge 与 Fabric 制品的 Minecraft 模组项目,基于 Architectury 框架。若项目只支持单一加载器,或任务是 Paper/Bukkit 插件开发,则不适用。

主要能力:Architectury 由 architectury-loom(扩展 Fabric Loom 的 Gradle 插件)、architectury-api(跨平台运行时抽象)和 @ExpectPlatform 注解组成。项目结构分为 common/(共享代码,不含加载器专属 API)、fabric/(Fabric 代码与入口)、neoforge/(NeoForge 代码与入口)。共享代码使用 Architectury 的 DeferredRegister 注册物品;平台差异通过 @ExpectPlatform 声明契约,并在各平台子项目中以同包同名 <类名>Impl 实现。

使用方式:在 gradle.properties 中设置 mod_version、minecraft_version、enabled_platforms=fabric,neoforge,以及 architectury_version、fabric_loader_version、fabric_api_version、neoforge_version、loom_version 等版本锚点,需从同一生成或已知可用的项目线固定。构建用 ./gradlew build 同时产出两个 JAR;开发运行用 ./gradlew :fabric:runClient、./gradlew :neoforge:runClient、./gradlew :neoforge:runServer;数据生成用 ./gradlew :neoforge:runData。编辑 gradle.properties 后可运行 ./scripts/check-version-sanity.sh --root <project> 做静态预检。

限制:该静态检查器只做语法与版本族预检,不解析依赖、不证明加载器兼容性,也不能替代 Fabric 与 NeoForge 的实际构建和冒烟测试。技能不发布可复制的依赖矩阵。Minecraft 26.x 未混淆,其 Loom/重映射设置与 1.21.11 不同,不能只改 minecraft_version;26.x/Java 25 应使用官方 Architectury Template Generator,且仅当其版本选择器提供确切目标时。common/ 中不得使用 net.neoforged.* 或 net.fabricmc.*,资源应放在 common/src/main/resources/assets/。具体版本号与兼容组合暂未提供。