22 lines
1.2 KiB
Markdown
22 lines
1.2 KiB
Markdown
# resourcepacks/ — 素材包目录
|
||
|
||
> 素材包（纹理/模型/语言/音效覆盖）放这里；也接受放到 [`../mods/`](../mods/README.md)（主投放点）。
|
||
> 格式见 [`../文档/设计.md`](../文档/设计.md) §1.3（内容包统一格式）。
|
||
|
||
## 已就位的素材包
|
||
|
||
- **`texture-pack-default1.20.5-26.2/`** — 原生 Minecraft 1.20.5 资源包（pack.mcmeta，pack_format 34/46），
|
||
含 atlases / blockstates（1198）/ models（3928）/ textures / font / lang(en_us) 完整结构。
|
||
客户端/服务器启动时自动加载，作为默认材质来源（初版材质基线）。
|
||
|
||
## 支持两种格式（自动识别）
|
||
|
||
1. **原生格式**（推荐，用户下载的包直接放）：根目录 `pack.mcmeta` + `assets/<ns>/...`，自动视为素材包，无需转换。
|
||
2. **扩展格式**（可选）：`manifest.json`（`"type": "resource"`，可声明 `priority`），包结构同 Mod 格式。
|
||
|
||
## 规则
|
||
|
||
- 优先级：`功能 Mod 资源 > 素材包 > 光影包（仅渲染阶段） > 默认嵌入素材`。
|
||
- 同类型冲突：`priority` 大者优先，相同则后加载者覆盖并告警。
|
||
- 开发模式支持热重载（改图 → 图集重建 → mesh 重传，见 场景/热更新.md）。
|