装备隐藏器 - 盔甲、武器、头盔及其他装备的可见性切换

装备隐藏器 - 盔甲、武器、头盔及其他装备的可见性切换

这个模组让你能够通过可自定义快捷键，在《红色沙漠》中隐藏已装备的装备视觉效果。可按类别分别开启/关闭武器、盾牌、弓、护甲、工具和提灯的可见性。非常适合用于拍摄更整洁的截图或打造角色美观造型。

视觉效果

装备隐藏器 - 盔甲、武器、头盔及其他装备的可见性切换预览查看大图

注意：近期更新中新增的内置选项

该游戏已添加原生可见性选项，覆盖了本模组的部分功能。

自 v1.02.00 版起 - 头盔可见度 位于 设置 > 语言与游戏性：

  • 始终显示 / 战斗中显示 / 过场动画中隐藏 / 始终隐藏

自 v1.03.00 版本起 - 武器展示 位于 设置 > 其他 > 语言与游戏玩法：

  • 显示近战武器： 全部 / 仅选中的
  • 显示远程武器： 总是 / 仅在使用时

如果内置选项已满足你的需求，则你不再需要此模组来启用这些功能。

主要特色

  • 切换、显示或隐藏每个类别的装备，支持自定义快捷键
  • 20 个内置分类 涵盖武器、盾牌、弓、盔甲部件、饰品、工具和灯笼
  • 全局显示全部/隐藏全部快捷键，可同时控制所有类别
  • 用户预设：10 个自定义零件组，配有独立的切换热键
  • 通过 INI 文件完全可配置，包含每个类别的单独设置
  • 独立切换 模式：共享同一快捷键的类别会各自独立切换状态，保持可见/隐藏的混合配置
  • 全透明开源

要求

不要通过 MOD 管理器安装。 如果你愿意的话可以这么做，但如果出问题，不要在这里提交错误报告。

模组管理器通常会将 .asi 文件放入自己的子文件夹中。终极 ASI 加载器会递归扫描子目录，因此即使管理器报告模组已“禁用”或“卸载”，.asi 仍会继续加载。常见症状：在你认为模组已移除后，装备依然保持隐藏状态。

手动安装：请按照下方的安装步骤操作。要卸载， 请直接从 bin64 文件夹中删除 CrimsonDesertEquipHide.asi 和 CrimsonDesertEquipHide.ini（无需通过管理器）。如果管理器将文件移动到了 bin64/plugins/ 或 bin64/backup/ 这类子文件夹中，请同样从该子文件夹中删除这些文件。

安装

步骤 1：安装 ASI 加载器

你需要一个 ASI 加载器来加载 .asi 模组。如果你已经有一个（例如从其他模组获得的），请跳到第二步。

下载 x64 版本的 Ultimate ASI Loader，并将以下 DLL 文件之一放入您的 bin64 文件夹中：

  • winmm.dll - 推荐，适用于大多数设置
  • version.dll - 如果 winmm.dll 冲突时的替代方案
  • dinput8.dll - 另一个备选方案

如何验证： 完成步骤 2 后，启动游戏一次。如果 bin64 文件夹中没有出现 CrimsonDesertEquipHide.log 文件，则说明 ASI 加载器未加载。请尝试将 DLL 重命名为上面列出的其他变体之一。

注意： 如果你使用的是更新版本的 Ultimate ASI Loader，并且日志文件未生成，请尝试使用来自 v9.1.0 的 win64（x64）构建版本。

步骤 2：安装模组
  1. 从文件部分下载最新版本
  2. 将 CrimsonDesertEquipHide.asi 和 CrimsonDesertEquipHide.ini 解压到你的 bin64 文件夹中
步骤 3：启动并游玩

启动游戏。按 V（默认键）切换装备可见性。默认情况下，INI 配置为在游戏加载时隐藏盾牌、头盔和面具。

文件放置
<Crimson Desert>/bin64/
├── CrimsonDesert.exe              (游戏可执行文件)
├── winmm.dll                      (ASI 加载器)
├── CrimsonDesertEquipHide.asi    (此模组)
├── CrimsonDesertEquipHide.ini    (该模组的配置文件)
└── ...
与 OptiScaler 一起使用

如果你使用 OptiScaler 进行帧生成或缩放，标准 ASI 加载器（例如 winmm.dll）会与 OptiScaler 自身的 dxgi.dll 冲突。请按照以下步骤操作：

  1. 删除 bin64 中的 winmm.dll（或您放置的任意 ASI 加载器 DLL）。OptiScaler 将负责处理模组加载。
  2. 打开 OptiScaler.ini，找到 [Plugins] 部分，并将 LoadAsiPlugins = true 设置为真
  3. 在 bin64 文件夹中创建一个 plugins 文件夹
  4. 将 CrimsonDesertEquipHide.asi 和 CrimsonDesertEquipHide.ini 移动到 plugins 文件夹中
<Crimson Desert>/bin64/
├── CrimsonDesert.exe
├── OptiScaler.ini                (LoadAsiPlugins = true)
├── dxgi.dll                      (OptiScaler)
├── plugins/
│  ├── CrimsonDesertEquipHide.asi
│  ├── CrimsonDesertEquipHide.ini
│  └── ...                        (其他 ASI 模组也放在这里)
└── ...

这适用于任何 ASI 模组，而不仅仅是当前这个。如果你还有其他 .asi 模组（例如 CDSprintHold），也把它们一起移到 plugins 文件夹中。

配置

该模组可以通过编辑 CrimsonDesertEquipHide.ini 文件进行配置：

[General]
; 日志级别：跟踪、调试、信息、警告、错误
LogLevel = Info

; 隐藏头盔/斗篷/面具时防止秃头
; 头发/胡须有时可能会消失；重新切换头盔（显示然后隐藏）可以恢复。
BaldFix = true

; 防止隐藏装备在状态转换期间短暂闪烁
GlidingFix = true

; 当使用相同 ToggleHotkey 的类别具有不同的 DefaultHidden
; 数值，设置为 true 以使每个类别独立切换其自身状态。
IndependentToggle = false

; 一次性强制显示/隐藏所有分类（空值=禁用）
ShowAllHotkey =
HideAllHotkey =

[Shield]
Enabled = true
ToggleHotkey = V
ShowHotkey =
HideHotkey =
DefaultHidden = true
Parts = CD_MainWeapon_Shield_L, CD_MainWeapon_Shield_R, ...

[Helm]
Enabled = true
ToggleHotkey = V
ShowHotkey =
HideHotkey =
DefaultHidden = true
Parts = CD_Helm, CD_Helm_Acc, ...

[UserPreset1]
Enabled = false
ToggleHotkey =
ShowHotkey =
HideHotkey =
DefaultHidden = false
Parts =

热键类型

每个类别支持三个独立的热键绑定：

  • 切换快捷键 - 在隐藏和可见之间切换
  • 显示快捷键 - 始终强制显示
  • 隐藏热键 - 始终强制隐藏

[General] 中的全局覆盖：

  • ShowAllHotkey - 强制显示所有类别
  • HideAllHotkey - 强制隐藏所有分类

快捷键格式

  • 命名键：V、F3、小键盘 1、鼠标 4、手柄 A 等
  • 修饰键：Ctrl、Shift、Alt（或 LCtrl、RCtrl 等）
  • Multiple combos: V，Gamepad_LB+Gamepad_Y（单独按 V 或按住 LB 再按 Y）
  • 空值禁用绑定

详见 支持的输入名称 参考中的完整列表。

使用控制器

DetourModKit 通过 XInput API 原生支持手柄输入。直接在 INI 文件中使用手柄按钮名称：

; 使用游戏手柄 Y 键切换
ToggleHotkey = Gamepad_Y

; 使用一个修饰符组合
ToggleHotkey = Gamepad_LB+Gamepad_Y

; 多个独立连击（逗号表示“或”）
ToggleHotkey = V，Gamepad_LB+Gamepad_Y

仅限 XInput： Xbox 控制器可直接使用。对于 PS4/PS5/Switch 控制器，需使用 XInput 翻译层（如 DS4Windows、DualSenseX、BetterJoy）或 Steam Input 将控制器模拟为 XInput。详情请参阅手柄兼容性。

每角色部件覆盖

每个类别的 部件 列表可按主角单独覆盖，通过添加名为 [类别名称:角色名称] 的区块实现。支持的角色名称：Kliff、Damiane、Oongka。只有 部件 键按角色区分；启用的、默认隐藏 及快捷键设置仍沿用基础区块的全局配置。

设置每个角色 零件 值的三种方法：

  • 部分缺失，或 Parts = (空) - 继承基础 [CategoryName] 列表
  • Parts = CD_Xxx, CD_Yyy, ... - 当该角色被控制时使用此明确列表
  • Parts = NONE - 禁用该角色的类别（即使启用基础也隐藏全部）

示例：在达米安身上保持灯笼可见

[Lantern]
Enabled = true
ToggleHotkey = L
DefaultHidden = true
Parts = CD_Lantern, CD_Lantern_Ring

[Lantern:Damiane]
Parts = NONE

Kliff 和 Oongka 的灯笼快捷键仍然有效，但 Damiane 的灯笼从未隐藏。

示例：每个角色拥有不同的武器套装

Kliff 没有 1H 斧头或钉头锤的刀鞘网格，但 Damiane 有：

[OneHandWeapon]
Parts = CD_MainWeapon_Sword_R, CD_MainWeapon_Sword_L, ...

[OneHandWeapon:Damiane]
Parts = CD_MainWeapon_Sword_R, CD_MainWeapon_Sword_L, ..., CD_MainWeapon_Axe_R, CD_MainWeapon_Axe_L, CD_MainWeapon_Mace_R, CD_MainWeapon_Mace_L

活动角色的检测通过遍历实时 WorldSystem 指针链，定位当前控制的角色并解码其内置身份字段来实现。屏幕上可见的每个队员会独立追踪各自的角色部件列表，因此隐藏 Damiane 的盔甲后再切换回 Kliff，Damiane 的盔甲会保持隐藏状态，而 Kliff 会按照自身配置渲染。前一个控制角色的隐藏状态在切换过程中会被保留，直到你手动关闭该功能。

用户预设

INI 文件包含三个 UserPreset 章节（UserPreset1， UserPreset2， UserPreset3），让你创建具有独立可见性控制的自定义部件组。

当一个预设被 启用 并包含部位时，它将对这些部位进行 完全控制。

  • 只有预设自身的快捷键控制其部件
  • 内置分类切换（例如 V 表示护盾/头盔/面具）不会 影响当前激活预设中的部件
  • 零件可以同时出现在内置类别和预设中——启用时预设优先
  • 如果希望预设的零件在启动时隐藏，则在其上设定 DefaultHidden = true
[UserPreset1]
Enabled = true
ToggleHotkey = F5
DefaultHidden = true
Parts = CD_Helm, CD_Cloak, CD_Shoulder

在这个示例中，按下 V 仍然会切换护盾和面具，但头盔只会响应 F5，因为 UserPreset1 拥有它。

已知问题

  • 卡顿或帧数下降 - 部分用户报告在拥挤区域出现性能问题。*我这边无法复现。*临时解决方案： 尝试使用不同的 ASI 加载器 DLL（如将 winmm.dll 替换为 version.dll）。
  • 飞行斗篷视觉异常 - CD_Cloak_Flight 变体导致视觉异常和头发挤压。已从默认设置中移除；请自行承担风险在 INI 中重新添加（参见 [Cloak] 注释）。
  • 胸部/腿部闪烁 - 隐藏胸甲可能导致角色移动时裤子/腿部出现闪烁。后续补丁缩小了可见性挂钩触发的事件范围，因此 CascadeFix 缓解方案不再有效。CascadeFix 在当前最新游戏补丁中已失效 - 请勿启用；保持 CascadeFix = false（默认值）。 它不再能抑制闪烁，并可能出现异常行为。修复工作正在进行中。此前，CascadeFix = true 能在赤膊状态下尽力减少闪烁（更换护甲时自动重新隐藏；从赤膊状态装备胸甲需手动切换显示/隐藏）。
  • 切换可能需要 1-3 秒才能生效。
  • 重大游戏更新可能会导致模组失效，直至新版本发布。
  • 仅在 Steam 版本上测试过。

故障排除

如果你遇到问题：

  • 在 INI 文件中将 LogLevel = Debug 设置为调试级别
  • 请查看游戏目录中的日志文件（CrimsonDesertEquipHide.log）
  • 对于内存模式错误，该模组需要更新到当前游戏版本

重要：移除或禁用 ASI 模组。 Ultimate ASI 加载器会递归扫描子目录。将 .asi 文件移至子文件夹（如 plugins/backup/）无法 阻止其加载。要完全禁用某个 ASI 模组，请将其 完全移至游戏根目录之外，或重命名文件扩展名（如 .asi.bak）。

鸣谢与源代码

使用 DetourModKit 构建核心功能。

  • ThirteenAG 提供的终极 ASI 加载器
  • 安全钩：cursey
  • Brodie Thiesfield 为 SimpleIni 所作
  • Frans 'Otis_Inf' Bouma 针对 v1.05.00 版本的 AOB 偏移诊断
  • Pearl Abyss 开发了《红色沙漠》

所有《红色沙漠》的模组和工具均可在本 GitHub 仓库 中找到。欢迎贡献或提出改进建议！