TaCZ Tweaks (Refabricated)

非官方社区移植版

**这是 TaCZ Tweaks 的非官方社区移植版，与 MUKSC、TaCZ 开发团队或

TaCZ Refabricated Unofficial、TaCZ Renovated 的维护者均无关联，未经过他们审核，

也未得到他们的认可。**

本项目的功能

TaCZ Tweaks (Refabricated) 将 MUKSC 的 TaCZ Tweaks 中可配置的游戏玩法和数据驱动
系统带到了Fabric 和 NeoForge。请搭配适用于对应加载器的
非官方 TaCZ 移植版使用。

它为 TaCZ 增添了枪械操作选项、移动控制、全局平衡调整、弹射物与近战交互、声音和粒子规则、服务器
配置同步，以及一系列提升体验的设置。

为何使用此项目

原项目面向 Forge 1.20.1。通过这些移植版，Fabric 和 NeoForge
玩家及服务器所有者也能使用同一套丰富的调整功能。请下载与你的环境相匹配的文件；
支持的游戏版本和所需前置模组以该文件列出的信息为准。

主要功能包括：

• 可配置卸弹、上膛、枪机循环、装填、冲刺和水下射击；
• 枪械倾斜、灵敏度、匍匐移动、命中标记和命中音效控制；
• 全局伤害、爆头、护甲穿透、弹射物、散布、射速和后坐力调整；
• 支持弹射物防护附魔及其与盾牌的交互；
• 支持枪械近战，以及兼容的近战武器与方块交互；
• 可配置撞击、掠过、持续播放和依环境变化的声音；
• 由数据驱动的子弹交互、粒子、声音和近战规则；
• JSON 配置持久化，以及服务器到客户端的配置同步；
• 通过 YACL 在游戏内配置，并可选集成模组菜单。

与原版项目相比有哪些变化

这是一个持续维护的衍生移植版，并非原样重新上传。针对移植版本所做的工作包括：

• 替换特定于加载器的事件、网络、权限、标签和资源重载 API；
• 根据 Fabric TaCZ 移植版实际提供的方法和描述符调整 mixin；
• 重新设计声音转换逻辑，避免将可变请求状态附加到共享资源标识符上；
• 接入当前的盾牌、弹射物防护、匍匐渲染和方块破坏事件流程；
• 恢复数据驱动管理器和旧版架构转换；
• 同步由服务器控制的设置，并清理与生命周期相关的缓存；
• 增加静态审查、编解码器和行为测试、专用服务器日志检查及图标来源检查。

需求与安装

本项目支持 Fabric 和 NeoForge。请安装与你的
加载器相匹配的文件，并同时安装该文件依赖项
部分列出的所有前置模组。请勿根据项目标题或
本说明推断游戏版本或所需模组。

模组菜单为可选项。兼容性集成同样为可选项，只有安装了
对应项目后才会启用。

多人游戏中，服务器和相关客户端必须使用相互兼容的文件及
配置。

可选兼容性

此移植版提供与 Sound Physics Remastered、First Aid New 及
Pillager’s Gun 的可选集成。支持范围仅限各上传文件的
元数据和项目文档明确列出的版本。与第三方项目兼容并不代表拥有该项目，
也不代表获得其认可或重新分发其资源的许可。

支持与错误报告

请通过本项目的议题模板报告移植版相关问题：

• 支持与故障排查
• 错误报告
• 兼容性报告

一份有用的报告应包含准确的版本号、完整日志、最简复现步骤、
客户端/服务端信息、相关配置，以及所有必需的第三方内容包。
请不要要求原作者为此移植版本引入的问题提供支持。

致谢、源代码与许可证

• 原始项目及作者：MUKSC/TaCZTweaks
• Fabric TaCZ 前置模组：TaCZ Refabricated Unofficial
• NeoForge TaCZ 前置模组：TaCZ Renovated
• 移植源代码及分支说明：TaCZTweaks Unofficial/docs/BRANCHES.md)
• 许可证：GNU 通用公共许可证 v3.0
• 第三方声明：THIRD_PARTY_NOTICES.md

图标和随附的第三方资源均保留其文档中注明的作者信息及许可证。
与外部内容的兼容性不会改变该内容的许可证。

AI 使用说明

本项目页面描述由生成式 AI 辅助起草，并经项目维护者审核。
获得许可的上游项目图标并非由 AI 生成或修改。