火龙MOD网
首页游戏库玩家合集工具辅助
游戏库/致命公司/趣味与魔改/3D模型替换通用框架接口 (ModelReplacementAPI)

3D模型替换通用框架接口 (ModelReplacementAPI)

适用版本:v68 / 2026最新版MOD 版本:v2.4.20文件大小:105.6 KB更新日期:2026-11-17

### 【模组详细说明与实操指南】

# 模型替换API v2.4.20

## 指示

有关进行模型替换的更多信息,请参阅 wiki:https://github.com/BunyaPineTree/LethalCompany_ModelReplacementAPI

## 视图模型支持

现在支持视图模型,并且可以从角色的模型自动生成视图模型,但由于并非所有模型都具有高质量的手,或者可以很好地映射到游戏中的手,因此视图模型将在选择加入的基础上实现。

在完成自定义视图模型支持并制定指南后,SDK 将进行更新,这将允许人们选择在他们的模型中使用自定义或自动视图模型。

与此同时,我向 ModelReplacementAPI 添加了一个配置选项,它将自动为每个模型替换生成视图模型。这可以用作调试工具,以查看模型的手臂是否映射得足够好,或者使用自定义视图模型会更好。

### 启用视图模型的说明

要启用此功能,请使用 v2.4.0 启动游戏一次以生成配置文件。然后,您可以使用像 r2modman 这样的 mod 管理器在 `\BepInEx\config\meow.ModelReplacementAPI.cfg` 中手动更改配置,或者通过 LethalConfig 在游戏中更改配置。

请注意,如果您在游戏中启用此配置选项,则必须放置一个新模型才能生成视图模型。

## 蒙面支持

蒙面敌人现在将采用玩家的模型替代品。

如果他们模仿某个玩家,那么他们将采用该玩家的模型,否则他们将随机采用任何玩家的模型替换(或缺少)。

## 已知问题

- More Company 突破人数上限的角色饰品与外观装扮在布娃娃上表现得很奇怪

- ~~由于实施后处理删除,某些情况会阻止启用 noPostProcessing 的模型出现在相机上。 MirrorDecor 就是一个例子,它不会立即显示您的模型。截至目前,可以通过取下模型替换件并重新安装来解决此问题。~~

- 目前,部分摄像机不显示基础玩家模型

- ~~支持无后期处理层需要找到两个不经常或从未使用的层来渲染没有后期处理的模型。这次我进行了彻底的搜索,以防止出现紫色轨道,但仅仅因为我搜索的图层上没有任何内容,并不意味着永远不会出现任何内容。如果您发现物品看起来不正确,请告诉我。~~

- 查看模型橡皮筋

- 视图模型中保存的项目可能面向不同的方向,位于不同的位置,并掉落到您正下方以外的位置。

- 使用视图模型丢弃死去的玩家可能会导致意想不到的结果

- 模型替换尚不支持吸管者死亡动画。

- Zeekers 将分色过滤器重新实现为 FullScreenCustomPass,它不允许像以前的实现那样进行选择性剔除。这从根本上打破了我们对模型进行后处理删除的方式。

## 变更日志

- v2.4.20

- 修复了拿着腰包时出现的错误垃圾邮件。

- v2.4.19

- 感谢 Wheatly126 对项目偏移的改进。

- 感谢baerchen201修复了死于新敌人时导致游戏冻结的错误。

- v2.4.18

- 修复了如果用户尝试使用“generate viewmodels = false”拾取项目时渲染会中断的错误。

- v2.4.17

- 感谢 Wheatly126 的改进,应该可以修复腰包

- V2.4.16

- 感谢 Wheatly126 的性能改进。

- V2.4.15

- 非常感谢 Wheatly126 修复了与持有物品、武器、喷气背包相关的错误,并解决了第一人称视图模型的橡皮筋问题。

- 感谢 TheSlowlyy 解决了控制台中的一些错误。

- v2.4.14

- 处理控制台中记录的一些错误。

- v2.4.13

- 感谢 1A3Dev 修复了玩家断开连接的错误。

- v2.4.12

- 感谢 1A3Dev 修复了 MoreCompany 外观可见性问题。

- v2.4.11

- 使用最新版本的 MoreCompany 重建

- v2.4.10

- 法官大人,我求你了,雏菊。

- v2.4.9

- 修复了布娃娃碰撞问题。

- 修复了当尸体被放入公司巡洋舰内部时莫名其妙爆炸的可能性。

- 修复了第三人称时天气效果消失的问题。

- 从控制台中删除了一些错误消息。

- v2.4.7

- 修复了消失的树木

- v2.4.6

- 感谢 DiFFoZ 发现了一个降低性能的错误。

- v2.4.5

- LOD 问题应该得到解决。

- 感谢 1A3 修复了控制台中屏蔽的相关错误消息。

- v2.4.1

- 删除了蒙面名牌

- 修复了与其他移除HUD的模组不兼容的问题

- 修复了导致 MoreCompany 角色饰品与外观装扮无法在第一人称视角中看到的错误

- v2.4.0

- 添加了 ViewModel 支持

- 添加了屏蔽支持

- 实施阴影

- v2.3.9

- 解决了 LCVR 和 TooManyEmotes 同时存在时出现的不兼容性问题。

- v2.3.8

- 从控制台中删除了 MoreCompany 外观错误。

- 删除了偶尔会导致隐藏错误的调试行。

- 修复了表情中间的角色大小问题。

- 固定橡皮筋(?)

- v2.3.7

- 看不见的腐尸尸体变得可见。非常感谢 SylviBlossom 定位问题并提供解决方案。

- v2.3.6

- 玩家的可见度应超过一米。

- v2.3.5

- LODS 不再以第三人称显示

- First person arms no longer appear with TooManyEmotes emotes

- v2.3.4

- 修复了通过脚本而不是 SDK 设置的模型没有后处理的问题

- 修复 TooManyEmotes 相机拖尾问题

- v2.3.3

- 现在可以实际看到玩家了

- v2.3.2

- 这次修复了向下看的错误吗?

- 修复了紫色导轨

- 修复了名称标签丢失的问题

- v2.3.1

- 现在无需 MoreCompany 即可工作

- v2.3.0

- 模组制作者现在可以将其模型替换排除在 Lethal Company 的后期处理之外,以提高自定义着色器质量。

- 小幅性能改进

- v2.2.1

- 更多渲染更改应该可以修复未放置在正确位置的项目。

- MirrorDecor、LCThirdPerson 和 emote mods 应该不再有冲突。

- 当你低头看时,第一人称模式中的模型不应该再可见

- 删除模型替换后,您现在应该能够看到基础游戏宇航服服装。

- 感谢 Naelstrof 更改了 UnityJigglePhysics LateUpdate 的执行顺序,这应该可以消除船舶中的抖动。

- v2.2.0

- 渲染更改以使模型对相机更加稳健。

- 录制相机支持和第三人称模组应该不再有冲突。

- 具有转换后的标准材质的模型将不再具有硬质的基础游戏法线贴图

- v2.1.2

- 修复了布娃娃和死亡命令未激活的问题

- v2.1.0

- 对模组制作者的本机 UnityJigglePhysics 支持。

- 项目旋转重构以修复未正确握住的项目。

- MirrorDecor 现在支持 3rdPerson 和 LCThirdPerson,感谢 Adamasnaldo 的修复。

- v2.0.4

- 未注释的调试

- v2.0.3

- TooManyEmotes OnEmote 命令修复

- v2.0.2

- 已知问题部分

- 修复了某些模型的渲染器消失的问题

- OnEmote 命令现在每个表情仅触发一次

- v2.0.1

- MoreCompany cosmetic fixes

- v2.0.0

- 彻底修改了 BoneMap 系统,使用 .unitypackage 转移到统一编辑器工作流程

- Added the ability to set rotation offsets to items,

- Added extra registry options. See the wiki for more info.

- Changed how the model replacement is rendered. No more skeletons separating from bodies.

- Thanks to Linkoid for refactoring and improving materials and adding support for materials that already utilize a setup HDRP shader.

- Added OnEmote commands, and will provide support for other events (like taking damage) down the line

- Note that mods that target v1.x.x will not be compatible with further updates of ModelReplacementAPI as a consequence of moving to the unity workflow, but this shouldn't happen again.

- v1.4.1

- Added RegisterModelReplacementOverride(Type bodyReplacement) to the API to prevent body replacements from constantly being removed and put back on when you want every player to have the same body replacement.

- v1.4.0

- Added support for LCThirdPerson

- Fixed bug that caused incompatibility with the More Suits mod. Thanks to Linkoid for the fix.

- v1.3.2

- Fixed models appearing in first person for users without the 3rdperson mod.

- v1.3.0

- Added support for 3rdperson.

- v1.2.4

- Fixed an issue where the bone offset tool was not setting the held item offset

- v1.2.3

- Fixed the same bug a second time, hopefully for real this time.

- Fixed MoreCompany cosmetics not parenting correctly.

- Possibly fixed players being invisible after death.

- v1.2.2

- Fixed a bug related to held items. Thanks to Mina for reporting a fix.

- v1.2.0

- Added support for ModelReplacementTool, removed a bug that spawned gameobjects periodically.

- v1.1.0

- Fixed some errors with bone mapping and biblically accurate angels.

- v1.0.0

- Release

### 【联机规则与注意事项】

* **联机兼容性**:【核心运行前置】(为其他模组提供底层支持,作为依赖项时全员随同安装)

* **前置依赖需求**:BepInEx-BepInExPack-5.4.2100

* **当前模组版本**:`2.4.20`

* **适配版本**:针对《致命公司》2026 最新稳定版(v68+)整理适配