Описание
### **项目描述 / 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.
---
#### **1. 优化类模组（兼容性修改） / Optimization Mods (Compatibility Adjustments)**
- **钠（Sodium）**
- Modrinth 原版：[Sodium](https://modrinth.com/mod/sodium)
Original Modrinth version
- 来源：为 25w14craftmine 定制的分支
Source: Custom fork for 25w14craftmine
- [IMS212/sodium-fabric@april](https://github.com/IMS212/sodium-fabric/tree/april)
- [Lonmo0208/Sodium@Sodium-25w14Cratfmine](https://github.com/Lonmo0208/Sodium/tree/Sodium-25w14Cratfmine!)
- **钠额外（Sodium Extra）**
- Modrinth 原版：[Sodium-Extra](https://modrinth.com/mod/Sodium-Extra)
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- [Lonmo/sodium-extra@25w14CraftMine](https://gitee.com/Lonmo/sodium-extra/tree/25w14CraftMine/)
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.
- **锂（Lithium）**
- Modrinth 原版：[Lithium](https://modrinth.com/mod/Lithium)
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- [Lonmo0208/lithium](https://github.com/Lonmo0208/lithium)
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.
- **Iris 光影**
- Modrinth 原版：[Iris-Shaders](https://modrinth.com/mod/Iris)
Original Modrinth version
- 来源：混合分支（含异步加载优化）
Source: Hybrid fork with async loading
- [IrisShaders/Iris@craftmine](https://github.com/IrisShaders/Iris/tree/craftmine)
- [Lonmo0208/Iris@25w14Craftmine-Async](https://github.com/Lonmo0208/Iris/tree/25w14Craftmine-Async)
- 修改内容：集成光影材质异步加载（代码由我原创贡献，参考自 Neoculus）
Changes: Integrated **asynchronous resource loading** (original code contribution by me, inspired by [Neoculus](https://github.com/Yuqi154/NeOculus/blob/1.21.1/src/main/java/net/irisshaders/iris/shaderpack/ShaderPack.java)).
---
#### **2. BUG 修复模组 / Bug Fix Mods**
- **Craftmine Fixes**
- Modrinth 原版：[25w14craftmine-Bug-Fixes](https://modrinth.com/mod/craftmine-fixes)
Original Modrinth version
- 覆盖原因：使用 GitHub 最新构建以修复更多问题
Override Reason: Latest GitHub build resolves unfixed issues
- 来源：[zly2006/25w14craftmine-Bug-Fixes](https://github.com/zly2006/25w14craftmine-Bug-Fixes)
- 许可证：LGPL-3.0（[查看协议](https://github.com/zly2006/25w14craftmine-Bug-Fixes?tab=LGPL-3.0-1-ov-file)）
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](https://modrinth.com/mod/BetterF3)
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- [Lonmo0208/BetterF3](https://github.com/Lonmo0208/BetterF3)
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.
- **生物血量显示（TslatEntityStatus）**
- Modrinth 原版：[TslatEntityStatus](https://modrinth.com/mod/TslatEntityStatus)
Original Modrinth version
- 来源：为 25w14craftmine 适配的分支
Source: Fork for 25w14craftmine
- [Lonmo0208/TslatEntityStatus@25w14craftmine](https://github.com/Lonmo0208/TslatEntityStatus/tree/25w14craftmine)
- 修改内容：仅修复兼容性问题，未改动功能
Changes: Pure compatibility fixes, no functional alterations.
- 前置模组修改：
Dependency modifications:
- **Architectury**（原 Modrinth：[链接](https://modrinth.com/mod/architectury-api)）
Adjusted version checks in `fabric.mod.json`.
- **ForgeConfigAPIPort**（原 Modrinth：[链接](https://modrinth.com/mod/forge-config-api-port)）
Adjusted version checks in `fabric.mod.json`.
- 覆盖原因：修改版本检测逻辑
Override Reason: Adjusted version checks in `fabric.mod.json`.
- **FallingTree（伐树模组）**
- Modrinth 原版：[FallingTree](https://modrinth.com/mod/fallingtree)
Original Modrinth version
- 覆盖原因：修改版本检测逻辑
Override Reason: Adjusted version checks in `fabric.mod.json`.
---
#### **4. 第三方模组 / Third-Party Mods**
- **TechReborn（科技复兴）**
- 来源：CurseForge
Source: [CurseForge](https://www.curseforge.com/minecraft/mc-mods/techreborn)
- 许可协议：MIT（[查看协议](https://github.com/TechReborn/TechReborn/tree/1.20?tab=License-1-ov-file)）
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 | [链接](https://modrinth.com/mod/architectury-api) | 调整版本标识符Adjusted version identifiers |
| FallingTree | [链接](https://modrinth.com/mod/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 页面](https://modrinth.com/shader/complementary-reimagined)
- [Discord 发布消息](https://discord.com/channels/774352792659820594/883067831485366304/1356710831152169242)
- **许可证**：
- [LGPL-3.0](https://github.com/ComplementaryDevelopment/ComplementaryReimagined/blob/main/License.txt)
- 源码仓库：[ComplementaryReimagined](https://github.com/ComplementaryDevelopment/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](https://creativecommons.org/licenses/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.