[UNOFFICIAL]TaCZ Refabricated

TaCZ Refabricated — 非官方 Fabric 移植版

这是非官方社区移植版，并非 TACZ 官方发布，也与 TACZ 开发团队无关，未经过其审核或获得其认可。

Timeless and Classics Guns: Zero (TaCZ) 是一款枪械模组，提供可自定义的枪械——包括配件、瞄具、弹药类型和动画——以及枪械制作工作台，并支持第三方枪械包。本项目将该模组移植到较新 Minecraft 版本的 Fabric 上。它本身不会添加新枪械或内容，目标是让原有模组及其枪械包生态继续运行。

以下两项已包含在此 jar 中——无需单独安装：

• 内置的 TacZ Mesh Loader (TML)，可直接使用高多边形 mesh 枪械包；
• 仅含代码的 LRTactical 兼容层，用于支持刀具、近战和投掷物枪械包。

目前可以游玩，但仍在积极测试中——可能存在 Bug，请备份世界。部分 R3
物品仍待游戏内验证（见“已知问题”）。

鸣谢

与原版相比的改动

这不仅仅是重新编译——目标版本移除或重做了多个 API：

• 重新实现瞄准镜渲染（上游使用的模板缓冲区已不复存在）。部分视觉效果与原版有所不同——这是已知的取舍。
• 网络通信迁移至当前的数据包、编解码器和登录同步系统。
• 资源、数据包、配方和模型加载已适配新格式。
• 修复枪械包兼容性问题，并提供旧版转换器（/tacz convert）。
• 高多边形 mesh 枪械开箱即用——详见下方 TML 介绍。
• 可选的实验性镜内瞄准镜渲染器（Scope PIP），默认关闭。
• 游戏内配置现在可以正常保存（Forge Config API Port 26.x 的回归问题曾导致配置仅保存在内存中，重启后设置会重置）。

运行要求

所有版本线均需要：Fabric Loader 0.19.3+、Fabric API。版本号格式示例：1.1.8+fabric.26.2.R3。仅支持 Fabric——没有 Forge/NeoForge 版本，也不要混用 Forge 版 TaCZ、LRTactical 或 TML jar。

可选：Mod Menu（游戏内配置界面）、JEI 或 REI（工作台配方及内置弹药查询功能，安装其中一个即可）、Iris（光影）、Carry On 2.11+（搬运枪械制作工作台）。

内置 TacZ Mesh Loader (TML)

高模资源包会声明 "model_type": "mesh"，并提供 poly_mesh 几何体，而不是用方块拼出枪械。无需安装外部附加组件即可渲染——此 jar 声明了 provides: taczmeshloader。

• 包含：枪械、配件、弹药和方块的 poly_mesh 渲染；世界渲染（其他玩家、掉落物、物品展示框、基座）；第一人称和世界场景中的GPU 静态烘焙（使用逐帧骨骼矩阵，而非逐顶点 CPU 变换），在 Iris 下也仍由 GPU 处理；近距离完整细节豁免，避免密集模型的枪械在你面前变成方块；GPU 渲染通道失败时自动回退到 CPU 路径。
• 不包含：网格瞄准镜（玻璃部件必须保持为方块，与外部附加组件相同）、自动生成 LOD、导入时的焊接/索引处理。
• 调优：MeshGpuBaking、MeshGpuWorld、MeshGpuLightCacheSize、MeshGpuBakeBudgetPerFrame、MeshWorldFullDetailDistance 和三项网格法线诊断选项位于游戏内界面（模组菜单 → Timeless and Classics Guns → 齿轮图标 → 渲染；法线诊断需要按 F3+T）。其余选项（MeshEnable、距离/顶点预算、MeshPolyInShadow、MeshLogStats）位于 config/tacz-client.toml 的 [mesh_loader] 中。完整列表：docs/MESH_LOADER.md。

已知限制：世界场景中的纹理会从资源包的原始路径读取，而非 uv/ 变体——如果资源包只在 uv/ 下提供纹理，模型在世界中会显示为缺失纹理（第一人称视角正常）；关闭网格 GPU 烘焙：世界场景可避免此问题。

瞄准镜画中画配置选项

瞄准镜画中画是一种可选的实验性镜内渲染器：瞄准镜筒外的视野保持 1×，只有镜片内的画面会放大。默认路径完全不使用画中画——世界只渲染一次，放大效果来自常规全屏缩放，与上游版本完全一致。

所有面向玩家的画中画选项都位于游戏内界面（模组菜单 → Timeless and Classics Guns → 齿轮图标 → 渲染；选项都在同一个可搜索列表中，没有“客户端”子级）。保存后立即生效——但 ScopePipShadowScale 除外，它需要重启游戏或切换维度才能生效。

仅限 TOML 配置（编辑 config/tacz-client.toml，然后重启）：ScopePipMinAiming
Progress、ScopePipDebug* 诊断选项（正常游玩时请关闭 ScopePipDebugTrace——它会卡住渲染线程）、ScopePipReleaseIdlePipeline /
ScopePipIdleReleaseDelayFrames，以及 AimingSwayIntensity（默认值 1.0，瞄准晃动倍率）。

最简起步配置——原版渲染器：

[render]
ScopePipEnable = true          # ScopeMaskEnable (default on) must stay on
ScopePipRerender = true        # for 6x-8x optics
ScopePipAllowShaderPacks = true   # only if you use Iris

此功能仍处于实验阶段，可能存在 Bug——高倍率镜片图像较柔和、使用光影时镜片与主视图之间可能出现色偏；启用二次渲染并使用光影包时，帧率可能降至约一半。如果显示异常，请先将 ScopePipEnable 设回 false 并重新测试，再提交问题报告；请附上 ScopePip* 参数值、光影包名称，以及 Sodium/Iris/Voxy 的版本。在无法接入的渲染器（例如 Sulkan）下，目镜遮罩会回退，PIP 也会被禁用。

内置 LRTactical 兼容支持

此 jar 已提供 lrtactical id 及其 Fabric 运行时层——请勿添加原版 jar。近战武器、消耗品、起爆器和五类投掷物（爆炸 / 粘性 / 烟雾 / 震撼 / 效果云）均可加载并运行，工作台配方也可用。这只是部分框架支持，并非原版的完整 Fabric 移植：尚未实现 flash_shield，也未附带原版美术和音频资源（内容包需自备资源）；兼容性取决于数据布局，请逐个内容包进行验证。

配方查看器

JEI 或 REI（安装其中一个即可）会添加工作台配方分类和内置的
弹药查询：打开一项弹药条目，即可查看所有使用该弹药的已加载枪械。
服务器同步枪械包后，查询结果会重新生成。这项功能仅由代码实现——无需单独安装
弹药查询附加组件（仅适用于 R2 及更新版本的文件）。

配置

几乎所有设置都可以在游戏内完成：模组菜单 → Timeless and Classics Guns → 齿轮 →
渲染（瞄准镜、PIP 和网格选项都在这里）。保存后会写入
config/tacz-client.toml，因此只有调试/高级选项才需要手动编辑——编辑后必须重启。

安装枪械包

枪械包应放入 .minecraft/tacz/——不要放进 tacz_backup（该文件夹仅用于存放转换器的输入文件）。压缩包可直接加载，文件夹也可以。无论采用哪种方式，gunpack.meta.json 都必须位于枪械包根目录（{"namespace":"your_pack"}），
否则该枪械包会被静默跳过。旧布局的枪械包应放入 tacz_backup/，再使用
/tacz convert 进行转换；请保留备份并查看日志。此移植版报告的版本为
1.1.8 加上 +... 构建元数据；SemVer 比较版本时会忽略这些元数据，因此要求
>=1.1.8 的枪械包仍可加载。

已知限制：需要 TacZ:Arcana 的枪械包

包含 recursion/taczpack.dat 或 data/<ns>/expansions/taczexpands.data，
且不含 .png / .ogg / geo_models/ / textures/ 的枪械包，其资源经过加密，仅供单独的、仅支持 Forge 且不开源的 TacZ:Arcana 模组使用。
这些资源会显示为紫黑色纹理，且没有模型。没有任何 TACZ 构建版本包含这些资源的解密功能——无论是原版、上游版本还是此移植版都没有。这并非此处的问题，转换器也无法修复。

已知问题

• 瞄准镜 PIP 仍处于实验阶段，默认关闭；第二次渲染加上光影包会使帧率降低约一半。
• TML：世界场景中的仅 uv/ 纹理路径问题（见上文）。
• 仍有待在游戏内验证：网格枪身在目镜内的裁切、PIP 第二次渲染时镜片内的网格烘焙、瞄准距离补偿，以及光影包下世界网格的光照表现。
• LRTactical 尚未完整实现——缺少 flash_shield 和部分系统。
• 与 Player Animation Library 一起使用时，趴下动作循环后，短暂的第三人称交叉淡入淡出可能会保留过时的姿势。

许可协议

这些资源禁止商用且禁止演绎：请勿出售，也不要修改后再分发——请改为发布自己的枪械包。代码许可不涵盖美术资源，与第三方枪械包兼容也不代表你有权重新分发该枪械包。完整声明请见源代码仓库中的 LICENSES.md。

问题反馈

请向此项目反馈问题，切勿联系 TACZ Dev Team、上游 Fabric 移植版维护者、LesRaisins 或 VellEagle——他们不为此移植版提供支持。请提供：
准确的文件版本；Minecraft、Fabric Loader、Fabric API、Forge Config API Port 和 Java 版本；JEI/REI、Carry On、Iris/Sodium 版本；受影响的枪械包及其合法的公开页面；完整的 latest.log 或崩溃报告；确认是否仅使用此模组及其两个必需前置库时仍能复现；如遇 PIP/网格问题，还请提供配置值和光影包信息。

免责声明

本内容按“原样”提供，不附带任何形式的保证。使用风险由你自行承担，
包括崩溃、数据丢失、地图损坏，以及与其他模组或第三方内容包发生冲突。此项目为非商业社区项目。