CIT Resewn 续篇

CIT Resewn 续篇

CIT Resewn 的非官方延续,适用于现代 Minecraft 版本

装饰

CIT Resewn 续作横幅

Fabric NeoForge 积极维护中 欢迎整合包使用 MIT 许可证

Modrinth CurseForge GitHub 问题反馈

面向现代 Minecraft 版本的 CIT Resewn 非官方续作,支持 Fabric 和 NeoForge。

CIT Resewn Continuation

CIT Resewn Continuation 让 MCPatcher 和 OptiFine 风格的 Custom Item Textures(自定义物品纹理)在原始 CIT Resewn 不再更新的新版 Minecraft 上继续工作。

它是为那些仍然依赖经典 CIT 资源包,但希望在不需要 OptiFine 的情况下游玩现代 Fabric 或 NeoForge 版本的玩家、资源包用户和整合包作者而制作的。

原始 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 beta
  • Minecraft 1.21.10 beta

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

更多版本正在规划并测试中。

可工作的内容

已知可工作的领域包括:

  • 物品模型 CIT,包括重命名物品的自定义模型
  • 仅纹理 CIT,包括重命名物品的自定义纹理
  • 使用现代装备渲染器的盔甲 CIT
  • 鞘翅 CIT
  • 遗留的 CustomModelData 条件
  • 遗留的 Damage NBT 条件
  • 遗留的物品子纹理覆盖,如 texture.layer1
  • 带有 OptiFine 风格相对纹理引用的模型支撑 CIT,如 ./texture_name
  • 具有 Latin-1 后备解析的非 UTF-8 .properties 文件
  • 三叉戟投掷 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 文件。

下载

已批准的构建版本可在以下位置获取:

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

面向整合包作者

欢迎在整合包中使用。

此项目旨在帮助玩家和整合包作者在更新的 Minecraft 版本上保留现有的 CIT 资源包功能。

CIT Resewn Continuation 在 Modrinth 和 CurseForge 上均可用。

在公开整合包中使用 beta 版 NeoForge 构建之前,请使用你的资源包和渲染器/着色器设置进行测试。

如果遇到资源包兼容性问题,请提交问题,并附上资源包名称、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。

最近的更新恢复了遗留的 CustomModelDataDamage、子纹理、盔甲、鞘翅、模型支撑 CIT 和非 UTF-8 .properties 兼容性,同时改进了匹配和渲染性能。

目标是在保留原始格式尽可能不变的前提下,让现有的 OptiFine 风格 CIT 资源包能在现代 Minecraft 版本上使用。

致谢

CIT Resewn Continuation 是 CIT Resewn(作者:SHsuperCM)的非官方续作。

CIT Resewn 是 MCPatcher 的 Custom Item Textures 的一种实现。这个项目离不开 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 上保持活力所需的咖啡因提供燃料。