CN_25w14Craftmine++

项目描述 / Project Description
这是一个为愚人节快照 25w14craftmine 定制的趣味光影整合包，包含兼容性修复与性能优化。所有覆盖文件均已标注来源与修改原因。
This is a "25w14craftmine" Fun-Oriented Shader Modpack designed for the April Fools' snapshot, focusing on compatibility fixes and performance optimizations. All overrides include clear sources and modification reasons.

启动器兼容性说明：
启动器导入整合包需要最新预览版的 HMCL 启动器，或等待下一个正式版的 PCL2 启动器。当前 PCL2 正式版暂不支持，其预览版兼容性未知，其他启动器（如 MultiMC）的导入能力也尚未验证。CurseForge 平台目前无法直接启动该整合包。若未来启动器开始支持解析并下载 25w14craftmine 的 NeoForge 版本，则可正常导入整合包。目前已知唯一兼容的是 HMCL 最新预览版，它能正确解析 25w14craftmine 的 NeoForge 环境。

Launcher Compatibility Notes:
To import this modpack, you need the latest pre-release version of HMCL or the next stable update of PCL2. The current stable version of PCL2 does not support it, and the compatibility of its pre-release version is unknown. Other launchers (e.g., MultiMC) have not been verified for importing. The CurseForge platform currently cannot launch this modpack directly. If launchers add support for parsing and downloading NeoForge for 25w14craftmine in the future, the modpack will be importable. As of now, the only confirmed compatible launcher is the latest HMCL pre-release, which can properly parse the NeoForge environment for 25w14craftmine.

---

#### 1. 优化类模组（兼容性修改） / Optimization Mods (Compatibility Adjustments)
- 钠（Sodium）
- Modrinth 原版：Sodium
Original Modrinth version
- 来源：为 25w14craftmine 定制的分支
Source: Custom fork for 25w14craftmine
- IMS212/sodium-fabric@april
- Lonmo0208/Sodium@Sodium-25w14Cratfmine

- 钠额外（Sodium Extra）
- Modrinth 原版：Sodium-Extra
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- Lonmo/sodium-extra@25w14CraftMine
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.

- 锂（Lithium）
- Modrinth 原版：Lithium
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- Lonmo0208/lithium
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.

- Iris 光影
- Modrinth 原版：Iris-Shaders
Original Modrinth version
- 来源：混合分支（含异步加载优化）
Source: Hybrid fork with async loading
- IrisShaders/Iris@craftmine
- Lonmo0208/Iris@25w14Craftmine-Async
- 修改内容：集成光影材质异步加载（代码由我原创贡献，参考自 Neoculus）
Changes: Integrated asynchronous resource loading (original code contribution by me, inspired by Neoculus).

---

#### 2. BUG 修复模组 / Bug Fix Mods
- Craftmine Fixes
- Modrinth 原版：25w14craftmine-Bug-Fixes
Original Modrinth version
- 覆盖原因：使用 GitHub 最新构建以修复更多问题
Override Reason: Latest GitHub build resolves unfixed issues
- 来源：zly2006/25w14craftmine-Bug-Fixes
- 许可证：LGPL-3.0（查看协议）
License: LGPL-3.0

- 其他 BUG 修复模组
- CraftMine Biome Fix & CraftMineFix
- 修改原因：针对 25w14craftmine 的特定错误修复
Reason: Specific bug fixes for 25w14craftmine

---

#### 3. 功能性模组（需版本适配） / Functional Mods (Version Adjustments Required)
- 更好的 F3（BetterF3）
- Modrinth 原版：BetterF3
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- Lonmo0208/BetterF3
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.

- 生物血量显示（TslatEntityStatus）
- Modrinth 原版：TslatEntityStatus
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- Lonmo0208/TslatEntityStatus@25w14craftmine
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.

- 前置模组修改：
Dependency modifications:
- Architectury（原 Modrinth：链接）
Adjusted version checks in fabric.mod.json.
- ForgeConfigAPIPort（原 Modrinth：链接）
Adjusted version checks in fabric.mod.json.
- 覆盖原因：修改版本检测逻辑
Override Reason: Adjusted version checks in fabric.mod.json.

- FallingTree（伐树模组）
- Modrinth 原版：FallingTree
Original Modrinth version
- 覆盖原因：修改版本检测逻辑
Override Reason: Adjusted version checks in fabric.mod.json.

---

#### 4. 第三方模组 / Third-Party Mods
- TechReborn（科技复兴）
- 来源：CurseForge
Source: CurseForge
- 许可协议：MIT（查看协议）
License: MIT

---

#### 5. 其他覆盖模组（来自 Modrinth 的修改版本） / Additional Overrides (Modified Modrinth Mods)
- 覆盖原因：部分模组原生于 Modrinth，但因需适配 25w14craftmine 的特殊版本，仅修改了 "fabric.mod.json" 中的 Minecraft 版本标识符，未更改任何功能代码。由于技术限制，无法逐一列出所有相关模组，但它们均可在 Modrinth 平台找到原始版本。
Override Reason: Some mods originally hosted on Modrinth require adjustments to the Minecraft version identifiers in "fabric.mod.json" for compatibility with 25w14craftmine, with no functional code modified. Specific mod names cannot be fully listed due to technical constraints, but all original versions are publicly available on Modrinth.

- 示例模组 / Example Mods：
| 模组名称 / Mod Name | 原 Modrinth 链接 / Original Modrinth Link | 修改内容 / Changes |
|---------------------|------------------------------------------|--------------------|
| Architectury | 链接 | 调整版本标识符
Adjusted version identifiers |
| FallingTree | 链接 | 调整版本标识符
Adjusted version identifiers |

---

### 多版本支持说明 / Multi-Version Support Notes
- 部分模组兼容性：
- 部分适用于 Minecraft 1.21.5 的 Fabric/NeoForge 模组可与 25w14craftmine 兼容，但需根据加载器类型调整配置文件。
- Partial Compatibility:
Some mods designed for Minecraft 1.21.5 (Fabric/NeoForge) are compatible with 25w14craftmine, but require configuration adjustments based on the loader.

- Fabric 版本适配：
- 无需修改的模组：若模组原生支持 1.21.5 且 无需修改 fabric.mod.json 即可兼容 25w14craftmine，且 Modrinth 平台已提供适配版本，则直接通过 Modrinth 依赖引用，无需内嵌覆盖。
- 需修改的模组：若需调整 fabric.mod.json 中的版本标识符，则必须内嵌在覆盖文件夹中分发。
- Fabric Version Adaptation:
- Unmodified Mods: If a mod natively supports 1.21.5 and works on 25w14craftmine without fabric.mod.json changes, and a compatible version exists on Modrinth, it will be referenced via Modrinth dependencies without embedding in overrides.
- Modified Mods: Mods requiring version identifier adjustments in fabric.mod.json must be embedded in the overrides folder.

- NeoForge 版本适配：
- 当前 没有模组官方支持 25w14craftmine 的 NeoForge，因此：
- 若模组基于 1.21.5 NeoForge 且代码兼容 25w14craftmine，则必须修改 neoforge.mods.toml 中的 NeoForge 版本标识符 和 Minecraft 版本标识符，并内嵌在覆盖文件夹中分发。
- 即使模组代码兼容，仍需显式声明版本适配以避免加载错误。
- NeoForge Version Adaptation:
- No mod officially supports 25w14craftmine on NeoForge, thus:
- If a mod is built for 1.21.5 NeoForge and is code-compatible with 25w14craftmine, it must have the NeoForge version identifier and Minecraft version identifier in neoforge.mods.toml modified, and be embedded in the overrides folder.
- Even code-compatible mods require explicit version declarations to prevent loader errors.

- 示例 / Example：
```toml
# 原配置 / Original
[[dependencies.modname]]
modId = "minecraft"
versionRange = "1.21.5"

[[dependencies.modname]]
modId = "neoforge"
versionRange = "[21.5.61-beta,)"

# 修改后 / Modified
[[dependencies.modname]]
modId = "minecraft"
versionRange = "25w14craftmine"

[[dependencies.modname]]
modId = "neoforge"
versionRange = "[0.25w14craftmine.5-beta,)"

---

#### 6. 附加资源 / Additional Resources
- Complementary Shaders (Reimagined) by IMS21
- 来源：由 IMS21 在 Iris Discord 服务器发布的不稳定版本，遵循 LGPL-3.0 协议分发。
Source: Unstable build released by IMS21 in the Iris Discord server, distributed under LGPL-3.0.
- 链接：
- Modrinth 页面
- Discord 发布消息
- 许可证：
- LGPL-3.0
- 源码仓库：ComplementaryReimagined

- 社区汉化资源包 (Community Chinese Localization Resource Pack)
- 来源：由社区成员提供的中文汉化资源包，可直接使用。
Source: Chinese localization resource pack provided by the community, ready to use.
- 授权说明：
- 汉化内容基于原版资源包协议（通常为 CC BY-NC-SA 4.0），未修改原功能。
License Note: Localization adheres to the original resource pack's license (typically CC BY-NC-SA 4.0), with no functional alterations.

---

#### 7. 通用声明 / General Notes
- Modrinth 原有模组：所有修改的依赖项均来自官方 Modrinth 页面，改动仅限于版本标识符调整，未修改功能代码。
Mods with Modrinth Origins: All modified dependencies originate from official Modrinth pages. Changes are strictly limited to version identifier adjustments.
- 开源合规性：钠、锂、Iris 的分支保留原始许可（LGPL-3.0/MIT），完整代码已公开在仓库中。
Open-Source Compliance: Forks retain original licenses (LGPL-3.0/MIT). Full source code is publicly accessible.
- 透明度：所有自定义代码（如异步加载）均可在提交历史中查证。
Transparency: All custom code (e.g., async loading) is documented in commit histories.