88 行
3.8 KiB
Markdown
88 行
3.8 KiB
Markdown
# EdNaven_Fabric — 源码工程
|
||
|
||
由 `EdNaven_Fabric-3.3-LATEST.jar` 反编译整理而来的 Gradle 源码工程，结构对齐 Southside 工程
|
||
（`settings.gradle` + `gradle.properties` + `build.gradle` + `src/main/java` + `src/main/resources`），
|
||
目标是 `gradle build` 后产出可直接丢进 `mods/` 目录的 Fabric mod jar。
|
||
|
||
## 基本信息
|
||
|
||
| 项 | 值 |
|
||
|---|---|
|
||
| Mod ID | `ednaven_fabric` |
|
||
| 版本 | 3.3-LATEST |
|
||
| Minecraft | 1.20.6 |
|
||
| Fabric Loader | ≥ 0.18.4 |
|
||
| Java | **21**（mixins.json 的 compatibilityLevel 就是 JAVA_21） |
|
||
| 入口 | `tech.naven.fabric.NavenModInitializer`（空壳，真实逻辑在 Mixin） |
|
||
| Mixin 包 | `tech.naven.Y`（33 个 client Mixin + `x`） |
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
EdNaven-fabric/
|
||
├── build.gradle # Fabric Loom 构建脚本
|
||
├── settings.gradle
|
||
├── gradle.properties # 版本变量与 JDK 21 路径
|
||
├── libs/ # 原 jar 内嵌依赖（javacv/ffmpeg/skija/javacpp/collection）
|
||
└── src/main/
|
||
├── java/
|
||
│ ├── tech/naven/ # 核心：fabric 入口 + Y(Mixin 包) + utils
|
||
│ └── <中文包名>/ # EdNaven 的水面混淆层（anti-tamper），不可删
|
||
└── resources/
|
||
├── fabric.mod.json
|
||
├── ednaven_fabric.mixins.json
|
||
└── ednaven.accesswidener
|
||
```
|
||
|
||
## 构建
|
||
|
||
需要 **JDK 21** 与网络（首次构建会下载 Minecraft、Intermediary 映射、Fabric Loader、Loom）。
|
||
|
||
```powershell
|
||
cd "C:\Users\zh201\WorkBuddy\2026-08-26-21-28-31\EdNaven-fabric"
|
||
|
||
# 用本地已有的 Gradle 8.5（工程目录下没放 wrapper）
|
||
& "C:\Users\zh201\WorkBuddy\2026-08-26-21-28-31\gradle-8.5\bin\gradle.bat" build
|
||
|
||
# 想生成 wrapper 的话（首次构建成功后执行）
|
||
& "C:\Users\zh201\WorkBuddy\2026-08-26-21-28-31\gradle-8.5\bin\gradle.bat" wrapper --gradle-version 8.5
|
||
```
|
||
|
||
产物：`build/libs/EdNaven_Fabric-3.3-LATEST.jar`（**用这个**，不要拿 `-dev` 或 `-sources` 的）。
|
||
`gradle packageMod` 会额外打成 `EdNaven_Fabric.zip` 方便分发。
|
||
|
||
## 三个关键设计（改动前必读）
|
||
|
||
### 1. mappings 必须是 Intermediary，不能用 Yarn
|
||
反编译出来的源码里 Minecraft 类全是 **Intermediary 中间名**：
|
||
|
||
```java
|
||
import net.minecraft.class_310; // = Minecraft
|
||
import net.minecraft.class_638; // = ClientWorld
|
||
```
|
||
|
||
所以 `build.gradle` 里是 `mappings "net.fabricmc:intermediary:1.20.6:v2"`。
|
||
**换成 Yarn 会导致全量编译失败**——Yarn 会把 `class_310` 命名成 `Minecraft`，源码里的 import 全部失效。
|
||
|
||
### 2. libs/ 里的内嵌依赖要打回 `META-INF/jars`
|
||
`fabric.mod.json` 用 `jars` 字段声明了 9 个内嵌依赖（javacv、ffmpeg、skija、javacpp、collection），
|
||
源码里的视频播放 / 字体渲染（`io.github.humbleui.skija.*`、`org.bytedeco.javacv.*`）都依赖它们。
|
||
|
||
`build.gradle` 的 `jar` 任务里已经有：
|
||
```groovy
|
||
from('libs') { into 'META-INF/jars' }
|
||
```
|
||
**删掉这行，运行时会 NoClassDefFoundError。**
|
||
|
||
### 3. 中文包名是混淆层，不能随手删
|
||
`src/main/java` 下的中文包名（如 `аее`、`хаpр`）是 EdNaven 自己的水面混淆（anti-tamper），
|
||
核心 Mixin 会引用它们。Java 允许 Unicode 标识符，编译没问题，但**必须保持 UTF-8 编码**
|
||
（构建脚本里已设置 `options.encoding = 'UTF-8'`）。
|
||
|
||
## 已知限制
|
||
|
||
- 反编译产物可能存在个别 CFR 输出问题（不可达语句、重复局部变量、泛型擦除导致的强转缺失等）。
|
||
首次构建若报编译错误，按错误逐条修即可，通常集中在少数几个文件。
|
||
- 未做反混淆重命名：类名仍是 `class_310` 与中文包名。想要 Southside 那种全英文可读命名，
|
||
需要额外做「Intermediary → Yarn」的重命名 + 中文包名重构，属于独立工作量。
|