随包资源清单
基本信息
| 属性 | 值 |
|---|---|
| 资源目录 | src/main/resources/ |
| 文件总数 | 8 |
| 数据/配置文件 | 3(AT + 2 份 mixin JSON) |
| 元数据 | 1(mcmod.info) |
| 许可证副本 | 3(COPYING、COPYING.LESSER、LICENSE) |
| 图片 | 1(chunkapi.png) |
| 语言文件 / 模型 / 配方 / textures | 0 |
全部 8 个文件(按路径列出)
| # | 路径 | 字节 | 类型 | 内容 |
|---|---|---|---|---|
| 1 | COPYING |
35149 | 许可证 | GPL-2.0 全文 |
| 2 | COPYING.LESSER |
7652 | 许可证 | LGPL-2.1 全文 |
| 3 | LICENSE |
833 | 许可证 | 本项目许可声明(LGPLv3 短声明) |
| 4 | META-INF/chunkapi_at.cfg |
290 | 数据 | Access Transformer,4 条规则 |
| 5 | chunkapi.png |
381283 | 图片 | mod 图标(对应 mcmod.info 的 logoFile) |
| 6 | mcmod.info |
464 | 元数据 | 唯一的 mod 描述文件 |
| 7 | mixins.chunkapi.early.json |
216 | 数据 | 早期 mixin 配置 |
| 8 | mixins.chunkapi.late.json |
216 | 数据 | 晚期 mixin 配置 |
目录结构
src/main/resources/
├── COPYING
├── COPYING.LESSER
├── LICENSE
├── chunkapi.png
├── mcmod.info
├── META-INF/
│ └── chunkapi_at.cfg
├── mixins.chunkapi.early.json
└── mixins.chunkapi.late.json
⚠️ 没有 assets/ 目录——因此没有 zh_CN.lang / en_US.lang、没有 models/、没有 textures/、没有 recipes/。这与"本 mod 不注册任何方块/物品/实体"完全一致(见分类页)。
⚠️ 没有 pack.mcmeta。
mcmod.info(verbatim)
[
{
"modid": "${modId}",
"name": "${modName}",
"description": "Chunk data, simplified.",
"version": "${modVersion}",
"mcversion": "${minecraftVersion}",
"url": "https://github.com/LegacyModdingMC/ChunkAPI",
"updateUrl": "",
"authorList": [
"FalsePattern"
],
"credits": "Logo by Houstonruss. Initial API feedback by the MEGA team.",
"logoFile": "chunkapi.png",
"screenshots": [],
"dependencies": []
}
]
| 字段 | 值 |
|---|---|
description |
“Chunk data, simplified.”(唯一描述,7 个词) |
url |
https://github.com/LegacyModdingMC/ChunkAPI |
updateUrl |
""(空) |
authorList |
["FalsePattern"] |
credits |
“Logo by Houstonruss. Initial API feedback by the MEGA team.” |
logoFile |
chunkapi.png |
screenshots |
[](空) |
dependencies |
[](空数组) ⚠️ |
⚠️ dependencies 是空数组,但本 mod 实际有硬依赖:core mod 依赖 gtnhmixins(GTNH Mixins,com.gtnewhorizon.gtnhmixins.* 被 8 个类 import)、lombok(@Data、@RequiredArgsConstructor、val、var)、org.jetbrains:annotations(@Contract、@NotNull、@Nullable、@ApiStatus、@Unmodifiable),以及可选的 lookingglass(仅 compileOnly)。这些全部靠构建插件与 GTNH 运行环境提供,未在 mcmod.info 中声明。
⚠️ 4 个字段是构建期占位符:${modId}、${modName}、${modVersion}、${minecraftVersion}。它们由 build.gradle.kts 的 tokens { tokenClass = "internal.Tags" } 生成的 internal.Tags 类提供替换值。internal.Tags 类不在源码里(见 内置原版数据管理器)——所以从源码无法确定 ${modId} 的字面值,只能从 build.gradle.kts 的 mod { modid = "chunkapi"; name = "ChunkAPI" } 推出。
两份 mixin JSON
内容逐字相同,各 6 个键:
{
"required": true,
"minVersion": "0.8.5",
"package": "com.falsepattern.chunk.internal.mixin.mixins",
"refmap": "mixins.chunkapi.refmap.json",
"target": "@env(DEFAULT)",
"compatibilityLevel": "JAVA_8"
}
⚠️ 两份都没有 "mixins" / "client" / "server" 数组——10 个 mixin 类的清单在运行时由 Mixin 枚举注入,见 Mixin 清单。
⚠️ 两者都声明 "refmap": "mixins.chunkapi.refmap.json",但该文件不在 src/main/resources 里(构建期由 mixin 注解处理器生成)。所以包内不会有它,除非构建产物包含。
⚠️ "required": true 意味着 mixin 应用失败会直接崩游戏;配合源码里 8 处 require = 1(每个 @Inject/@Redirect 都要求恰好 1 个注入点),对目标类版本极其敏感。
META-INF/chunkapi_at.cfg
内容与逐条说明见 Access Transformer。
三份许可证副本
| 文件 | 大小 | 内容 |
|---|---|---|
COPYING |
35149 字节 | GPL-2.0 全文 |
COPYING.LESSER |
7652 字节 | LGPL-2.1 全文 |
LICENSE |
833 字节 | 本项目自己的许可声明(首行即 ChunkAPI,非 LGPL 原文) |
三份都与仓库根目录的同名文件逐字节相同(diff -q 全部无差异)。
LICENSE 的完整结构(833 字节):
ChunkAPI
Copyright (C) 2023-2025 FalsePattern, The MEGA Team, LegacyModdingMC contributors
All Rights Reserved
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, only version 3 of the License.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
即"短声明 + 指向 COPYING.LESSER 全文"的双层结构。每个 .java 文件的头部注释都是这段声明的复制(逐字相同,含 Copyright (C) 2023-2025 FalsePattern, The MEGA Team, LegacyModdingMC contributors)。
⚠️ api 包下另有额外条款:“This is an API class covered by the additional permissions in the license.”(出现在 DataManager.java、DataRegistry.java、ArrayUtil.java 三个文件的 javadoc 首行)——但 LICENSE / COPYING.LESSER 里**没有任何一处提到这份"additional permissions"**的具体内容。
图片
chunkapi.png,381283 字节(约 372 KB),对应 mcmod.info 的 "logoFile": "chunkapi.png"。这是包内唯一的图片资源,占整个 src/main/resources 目录体积的绝大部分(目录总计 872 KB 中该文件占 381 KB,其余 7 个文件合计约 29 KB)。credits 字段注明:“Logo by Houstonruss.”
本 mod 不写配置文件
src/main/resources 里没有任何 *.cfg 配置模板,src/main/java 里没有任何 Configuration / @Config / ForgeConfigSpec 引用。本 mod 不生成任何配置文件——唯一的用户可见行为是 读档兼容闸门的弹窗与自动世界备份。
见分类页的"本 mod 没有的东西"。
相关条目
- Access Transformer —
META-INF/chunkapi_at.cfg的 4 条规则 - Mixin 清单 — 两份 JSON 与缺失的 refmap
- 核心 mod 与读档闸门 — 唯一的用户可见行为