CIT Resewn Continuation

非官方延续版 CIT Resewn，支持 Fabric 和 NeoForge 上的现代 Minecraft 版本。

CIT Resewn Continuation

CIT Resewn Continuation 让 MCPatcher 和 OptiFine 风格的自定义物品贴图继续在较新的 Minecraft 版本中运行，弥补原版 CIT Resewn 已停止更新后的空缺。

本模组面向玩家、资源包用户和整合包作者。如果你仍在使用经典 CIT 资源包，又想在现代 Fabric 或 NeoForge 版本中游玩，同时不想依赖 OptiFine，那么它正适合你。

原版 CIT Resewn 支持的版本最高为 Minecraft 1.21.1。本延续版从这里接续，让相同的 CIT 资源包格式继续适用于更新的 Minecraft 版本。

什么是 CIT Resewn Continuation？

CIT Resewn Continuation 能让现有的兼容 CIT 的资源包继续在较新的 Minecraft 版本中运行。

它支持自定义物品贴图、自定义物品模型、盔甲 CIT、鞘翅 CIT，以及多种旧版 CIT 资源包功能。

许多现有的 OptiFine 风格 CIT 资源包应该无需修改即可使用，不过某些特殊情况仍可能需要测试。

为什么要用它，而不只使用原版物品模型？

Minecraft 的新版物品模型系统很实用，适用于能为物品指定自定义模型数据或其他组件的数据包、服务器、地图和模组。

CIT 仍有其用武之地，因为它支持经典的 OptiFine 风格工作流程：资源包可以根据物品重命名及旧版 CIT 规则作出响应。这既能让现有资源包继续运行，也让基于名称的自定义物品贴图在较新的 Minecraft 版本中依然可用。

简而言之：

• 原版物品模型适合受控的自定义物品。
• CIT 适合现有的 OptiFine 风格资源包和基于重命名的自定义内容。
• 这个模组让这套虽旧却依然受欢迎的工作流程得以延续。

支持的 Minecraft 版本

目前支持的版本包括：

Fabric

• Minecraft 26.1
• Minecraft 26.1.x
• Minecraft 1.21.11
• Minecraft 1.21.10

NeoForge

• Minecraft 1.21.11 测试版
• Minecraft 1.21.10 测试版

支持的加载器取决于发布文件。请确保为你的 Minecraft 版本和加载器下载正确的 jar。

更多版本正在计划中，目前正在测试。

可用功能

已知可用的功能包括：

• 物品模型 CIT，包括为改名物品自定义模型
• 仅纹理 CIT，包括为改名物品自定义纹理
• 现代装备渲染器上的盔甲 CIT
• 鞘翅 CIT
• 旧版 CustomModelData 条件
• 旧版 Damage NBT 条件
• 旧版物品子纹理覆盖，例如 texture.layer1
• 基于模型的 CIT，支持 OptiFine 风格的相对纹理引用，例如 ./texture_name
• 非 UTF-8 的 .properties 文件，使用 Latin-1 回退解析
• 三叉戟投掷 CIT 模型覆盖
• 弓、弩和盾牌子物品模型覆盖
• 首版附魔光效 CIT 支持

NeoForge 状态

NeoForge 支持目前标记为 beta。

物品 CIT、纹理 CIT、模型 CIT、盔甲 CIT 和鞘翅 CIT 已使用大型真实 CIT 资源包和展示地图进行测试。

附魔光效覆盖仍需要额外测试。在 CIT 极其密集、显示大量物品的地图中，性能可能有所不同。

Fabric 支持目前更为成熟。NeoForge 支持较新，将随着更多用户测试而继续获得修复。

安装

Fabric

1. 安装 Fabric Loader。
2. 安装 Fabric API。
3. 为你的 Minecraft 版本下载正确的 CIT Resewn Continuation jar。
4. 将 jar 放入你的 mods 文件夹。
5. 将任何兼容 CIT 的资源包放入你的 resourcepacks 文件夹。
6. 在游戏内启用该资源包。

NeoForge

1. 安装 NeoForge。
2. 为你的 Minecraft 版本下载正确的 CIT Resewn Continuation jar。
3. 将 jar 放入你的 mods 文件夹。
4. 将任何兼容 CIT 的资源包放入你的 resourcepacks 文件夹。
5. 在游戏内启用该资源包。

当发布版本以该方式构建时，默认模块会打包在主 jar 内。除非发布说明明确要求，否则不要安装单独的默认 jar。

下载

已批准的构建可在此处获取：

• Modrinth: https://modrinth.com/mod/cit-resewn-continuation
• CurseForge: https://www.curseforge.com/minecraft/mc-mods/cit-resewn-continuation
• GitHub: https://github.com/EthanVisagie/CIT-Resewn-Continuation-1.21.11

开发构建产物也可能可从本仓库的 GitHub releases 页面获取。

致整合包创作者

欢迎在整合包中使用。

本项目旨在帮助玩家和整合包创作者在较新的 Minecraft 版本上保持现有 CIT 资源包正常工作。

CIT Resewn Continuation 已在 Modrinth 和 CurseForge 上提供。

在公开整合包中使用 beta 版 NeoForge 构建之前，请先使用你的资源包和渲染器/光影配置进行测试。

如果你遇到与资源包的兼容性问题，请提交 issue，并附上资源包名称、Minecraft 版本、加载器和日志。

性能

此分支包含对原始 CIT Resewn 的优化，包括减少不必要的 CIT 渲染工作，以及更快地匹配常见名称模式。

较新版本还减轻了大型 CIT 资源包带来的资源重载压力，并增强了模型加载的健壮性，使格式错误的 CIT 模型 JSON 会被记录并跳过，而不是中止整个模型重载流程。

如果你在 Minecraft 1.21.1 上使用 CIT Resewn 时注意到帧数下降，这个延续版本可能值得在较新版本上尝试。

NeoForge 版本仍在测试和优化中。正常游玩应该没有问题，但极度依赖 CIT 的展示地图，其表现可能与 Fabric 不同。

已知限制

部分边缘情况下的 OptiFine CIT 属性可能仍未完全支持。

具体表现可能因加载器分支和 Minecraft 版本而异。

在将某个版本用于公开整合包前，应先测试光影、渲染器和资源包的组合。

附魔闪光覆盖目前仅提供初步支持，仍需进行更广泛的测试。

测试

可用于验证的资源包和配置包括：

• TooManyRenames
• Barely Default
• FurfSky Reborn
• 大量使用附魔效果的 CIT 资源包
• 护甲和鞘翅 CIT 资源包
• Complementary Reimagined 等光影配置

如果遇到模型损坏、纹理缺失、CIT 匹配错误、资源重载问题或启动崩溃，请提交问题，并附上以下信息：

• Minecraft 版本
• 加载器及其版本
• CIT Resewn Continuation 版本
• 资源包名称和版本
• 相关的 .properties 文件（如有）
• latest.log 或崩溃报告

CIT 文档

大多数现有的 CIT Resewn 资源包和 API 文档仍然适用。

原始文档网站可在此处访问：

https://citresewn.shcm.io

API

API 接口仍基于原始 CIT Resewn 项目。

如果此分支之后发布到 Maven 仓库，我们会在此更新依赖坐标和示例，使其与延续项目相匹配。

普通玩家和整合包用户只需要主 jar 文件。

参与贡献

欢迎提交错误修复、移植修复、资源包兼容性修复，以及经过验证的小幅行为改进。

欢迎贡献的内容包括：

• 修复特定的资源包兼容性问题
• 针对特定加载器的修复
• 性能改进
• 为损坏的资源包或格式错误的 CIT 文件改进日志记录
• 改进文档
• 可复现的测试资源包或最小示例

提交拉取请求时，请附上测试说明。

开发状态

此分支仍在积极维护，支持原始 CIT Resewn 发布范围之后的较新 Minecraft 版本。

近期更新恢复了旧版 CustomModelData、Damage、子纹理、护甲、鞘翅、基于模型的 CIT，以及对非 UTF-8 编码 .properties 文件的兼容性，同时改进了匹配和渲染性能。

我们的目标是在现代 Minecraft 版本中继续支持现有的 OptiFine 风格 CIT 资源包，并尽可能保留原有格式。

致谢

CIT Resewn Continuation 是由 SHsuperCM 开发的 CIT Resewn 的非官方延续项目。

CIT Resewn 是 MCPatcher 的自定义物品纹理功能的实现。没有 SHsuperCM 的工作，就不会有这个项目。

NeoForge 支持也建立在 CIT Reforged 的工作之上；该项目帮助将 CIT Resewn 风格的功能带入 Forge 生态。

感谢原始 CIT Resewn、CIT Reforged、MCPatcher 和 OptiFine CIT 社区创建并维护了这种自定义物品纹理格式，许多资源包至今仍依赖它。

许可证

CIT Resewn Continuation 遵循 MIT 许可证，与原始 CIT Resewn 项目的许可证一致。

详情请参阅 LICENSE 文件。

支持

CIT Resewn Continuation 是免费开源项目。

如果这个模组帮助你在较新的 Minecraft 版本中继续使用资源包，未来可能会提供支持项目的方式。

目前，支持该项目的最佳方式是清晰地报告问题、分享可复现的示例，并帮助测试实际使用中的 CIT 资源包。

你们的支持能为移植、测试、调试令人头疼的 Mixin，以及让 OptiFine 风格的 CIT 在现代 Minecraft 中继续运行提供所需的咖啡因。