CD Mod管理器

CD Mod管理器

《赤色沙漠》首款通用模组管理器。预装了最受欢迎的生活品质模组,所有模组均可通过逐步预设对话框进行配置。

实用工具

CD Mod Manager v1.22 - 《赤色沙漠》全能模组管理器

CD Mod 管理器 - 版本历史

==================================

v1.22 (2026-03-26) - 可靠性大修 + UI现代化

** 新增:**

  • 内联预设配置:滑块、下拉菜单和开关直接位于模组详情面板。不再为CDCamera、QoL等弹出对话框。
  • ASI 模组支持:从 bin64/ 检测到的 .asi 模组,以青色徽章显示,INI 编辑器。包含 CDSprintHold.asi v1.5。
  • 添加模组功能支持.zip压缩包:自动提取.asi和.ini文件。
  • 显示实验性模组的复选框开关。
  • 为所有模组添加模组卡片悬停效果和正确的缩略图图标。
  • 装备可见性 v1.2:使用正确的原版数据完全重建。默认情况下所有装备都是可见的。模组可以隐藏盾牌、弓、剑,或独立配件。

** 已修复:**

  • text_replace 模式现在可以在首先应用原始游戏数据,然后同时应用。这消除了跨步骤干扰,即一个模组步骤的更改会破坏另一个步骤的步骤模式上下文 (was causing CDCamera to apply 751 replacements 而非预期的72)。
  • 当标准LZ4产生的输出大于目标压缩大小。K4os .NET 游戏原生压缩辅助工具已就绪。PAMT 压缩大小已更新当压缩输出与原始内容不同时。
  • 所有恢复路径现在使用 vanilla_snapshot.json(权威版本)。写入精确的原始PAMT和PAPGT二进制文件。不再有过时的校验和,不再有损坏的comp_size值,不再有孤立的覆盖层引用。基于Steam验证文件重建的纯净版快照。
  • 生活质量必备:新增 section_start/section_end 以限制模式适用范围仅限PC平台部分(之前匹配了所有平台部分的8倍)。
  • CDCamera v1.61:所有1199种模式已基于独特元素上下文重建。在带有CRLF换行符的原始XML中,每个模式仅匹配一次。
  • 设置已清理:移除了5个幽灵模组引用,清除了过时的预设选项。
  • 应用预览对话框:同时处理列表和字典冲突格式。
  • 在操作期间禁用恢复+重新应用按钮(防止并发 PAZ 写操作)。
  • 颜色/字体常量已去重(单一来源位于ui/constants.py)。
  • Windows 上子进程调用不再弹出 CMD 窗口。
  • 智能原版检测:若文件已纯净,则跳过恢复操作。

警告:

  • 标记为[实验性]的模组(残酷战斗,致命AI)具有以下模式:可能与当前游戏版本不匹配。启用风险自负。

v1.21 (2026-03-25) - 校验和链修复(关键)

已修复:

  • 游戏崩溃修复:在每次操作后实施完整的PAZ校验和链更新重新打包。游戏验证了一个3级哈希链(PAZ -> PAMT -> PAPGT)使用 Jenkins Lookup3 校验和。先前,修改 PAZ 文件并不会更新任何校验和,导致"游戏安装问题"崩溃。现在 repack_file() 更新:PAZ 在 PAMT 中的哈希值,PAMT 头部哈希值,PAMT 哈希值在PAPGT中,以及PAPGT在每次文件修改后都会进行自我哈希计算。
  • 恢复修复:现在恢复功能能正确清理覆盖存档文件夹 (0036, 0037, 0038), 从备份/基线/磁盘中恢复原版PAPGT,并为所有已恢复的存档重新计算校验和链。
  • 原版基准快照:首次运行已验证游戏文件时,保存包含所有PAMT/PAPGT校验和及精确原版数据的vanilla_baseline.json PAPGT 二进制文件。当不存在 PAPGT 备份时,用作恢复备用方案。
  • 覆盖层备份跳过:archive_overlay 条目不再触发误报在应用所有模组阶段2中出现"备份失败"警告。 参考:
  • 来自 github.com/MrIkso/CrimsonDesertTools 的校验和算法(PaChecksum.cs)
  • PAMT 结构:HeaderCrc(4) + PazCount(4) + Unknown(4) + PazInfo
  • PAPGT结构:未知(4) + 文件校验码(4) + 组数(1) + ...

v1.2 (2026-03-25) - 关键错误修复 + 稳定性发布

已修复:

  • 生活质量必备:所有6个文本替换模式均基于已修改版本文件而非原版。模糊、镜头抖动、UI缩放、鼠标灵敏度,鼠标阻尼调整现在对纯净游戏文件生效。(12/20 -> 20/20)
  • LOD & 绘制距离调整:模式使用了空格而非制表符缩进,并且缺少游戏中添加的_descLocalStr属性更新。性能模式现在能正确注入gv_useLowQualityProxyLOD参数。
  • 装备可见性:盾牌和弓箭的“显示”图案预计将合并元素格式,但游戏使用了独立的Visible="Out"元素。修复了phm_description_player_kliff.xml的重打包失败问题。
  • 库存与存储扩展器:多步骤叠加预设未能正确解析。resolve_presets 方法仅检查了单个选择ID,而非为多步骤模组构建组合键(例如 "9999_9999_9999_9999")。所有库存/存储组合现在都能正确应用。
  • 设置对话框:选择 bin64 文件夹而非 Crimson Desert 文件夹不再显示令人困惑的“bin64/bin64”错误。路径是自动更正到父目录。
  • PAPGT 恢复:现在正确移除了覆盖模组(体力,背包)恢复 PAPGT 存档索引。先前,恢复操作会遗留陈旧的覆盖层PAPGT中的引用导致“游戏安装问题”崩溃。添加了rebuild_papgt_from_disk()作为无PAPGT备份时的安全回退机制。

稳定性:

  • 新增了文件日志记录(CDModManager.log),支持轮转(2 MB,3个备份)。所有操作现已记录时间戳,以便更轻松地报告错误。
  • 原子化设置.json写入:设置现在会先写入临时文件,然后原子化重命名,防止在崩溃或断电时发生损坏。A .json.bak 备份文件用于恢复。
  • 覆盖清单现在在覆盖文件之前写入(防崩溃顺序)。如果在写入过程中进程崩溃,恢复功能仍可进行清理。
  • PAPGT 重建错误现在会传递给用户,而不是静默处理已忽略。未能成功注册的覆盖式模组将显示错误信息。
  • 文本替换前的备份检查:如果文件备份失败,则打补丁已跳过(防止不可恢复的修改)。
  • GUI 小部件崩溃防护:.after() 回调函数在执行前检查小部件是否存在访问,防止“错误窗口路径”崩溃。
  • 未处理的异常现在会在崩溃前记录到 CDModManager.log 文件中。
  • 对话访问安全性:使用 getattr() 获取对话结果以防止如果对话框被强制关闭,则引发 AttributeError 错误。

v1.1 (2026-03-25)

新增:

  • 耐力管理器 v3.0:使用存档覆盖方法完全重写。现在覆盖所有体力消耗(冲刺、战斗、骑行、攀爬、滑翔、游泳) 通过双重途径实现:技能消耗降低 + 基础池增加。4 种预设:半量 / 四分之一 / 最低 / 无限.
  • 存档覆盖支持:模组现在可以安装预构建的PAZ存档而非修补现有文件。对于二进制数据更可靠。
  • "应用已选模组"现在会先恢复到干净状态,因此取消勾选一个模组实际上移除了它(之前只是跳过了它)。
  • 新增“战斗”模组类别。
  • 已添加库存扩展器和存储扩展器模组。
  • 装备可见性模组,可显示/隐藏盾牌、弓箭、剑,和配件。
  • LOD & 绘制距离调整模组。
  • 更明亮的夜晚 - 增强低光可见度模组。

已修复:

  • 现在直接使用 CDCamera v1.60 二进制预设(包含 324 个预构建数据块)。修复了文本替换模式的问题。马匹摄像机缩放修复生效。
  • 冲刺保持模式已更新至当前游戏版本。
  • 生活质量必备模式已根据当前原版默认设置更新。
  • 电影级图形模式已针对当前游戏进行验证。
  • 配置文件启用状态现在在启动时能够正确加载。

改进:

  • 启动时最大化(全屏)
  • 紧凑型模组卡片 - 所有模组无需滚动即可查看
  • 紧凑的分类标题
  • 卡牌选择保留应用状态颜色
  • 为PAZ归档构建实现了PA校验和(Jenkins Lookup3算法)

v1.0 (2026-03-24)

  • 初始版本
  • 6 个模组:CDCamera、冲刺保持、QoL 必备、电影级画质,路径追踪解锁,隐藏护盾
  • 包含管理和创建选项卡的图形用户界面
  • 配置文件系统,搜索,加载顺序
  • PAZ 浏览器、XML 比较、导入/转换、快速创建工具

包含的模组:

CDCamera - 相机与视野全面改进 v1.60 CDCamera - 相机与视野全面改进 v1.60

可配置的摄像头,带有逐步预设:

  • 8 种相机风格:西部风格(RDR2)、沉浸式(最近)、电影式(宽广)、生化危机2重制版(恐怖风格)、低视角(巫师3/战神)、极低、超低、稳定
  • 6 个视野级别:+10 / +15 / +20 / +25 / +30 / +40 度
  • Steadycam:移动时锁定相机 - 奔跑时不会拉远镜头
  • 居中镜头(灾厄模式):将角色置于屏幕中央,适用于步行、骑马和飞行
  • 战斗缩放:默认 / 更宽 (+50%) / 最大 (+100%)
  • 骑马视角缩放修复 - 骑马时不再出现不稳定的缩放

体力管理器 v3.0 (新版)

减少所有体力消耗——冲刺、战斗、骑行、攀爬、滑翔、游泳。采用双重方法:技能消耗降低 + 基础体力池增加,实现全面覆盖。

  • 半减(50%)- 技能消耗减半,能量池翻倍
  • 四分之一消耗(25%)- 技能消耗减至四分之一,能量池增至四倍
  • 最小消耗 (10%) - 几乎无消耗,池子 10 倍
  • 无限体力 - 零技能消耗 + 巨大储备池

冲刺蓄力

按住Shift键进行冲刺而非切换。适用于步行、骑马、鼠标键盘和游戏手柄(A按钮)。

生活质量必备 - 调整与修复合集

5 个可配置调整项:

  • 屏幕模糊:禁用 / 减少 50%
  • 镜头抖动:禁用 / 减少 50%
  • HUD 缩放:解锁完整的 50-100% 范围(原版锁定为 90-100%)
  • 鼠标手感:零输入延迟 + 扩展灵敏度 / 仅扩展
  • 粒子效果:完整 / 减少50% / 最小化25% (提升帧率)

我将在下次更新中移除色差和其他效果。

电影级画质预设

将所有11项画质设置推至隐藏的电影级层级。原版“超高”将光照、水面和体积雾限制在“高”——此模组解锁了真正的最高画质。

库存扩展器

增加角色物品栏槽位:200 / 500 / 9999。

存储扩展器

增加仓库、营地箱子和银行存储:每个最多可达9999个槽位。

装备可见性

在收起时显示或隐藏盾牌、弓、剑和饰品。

LOD & 绘制距离调整

调整细节层次质量:性能 / 扩展 / 最大。

BrighterNights - 增强低光可见度

增强月光、洞穴照明、LED、光环和室内天花板灯的亮度。让夜间探索和洞穴探险变得舒适,同时不破坏视觉沉浸感。

路径追踪解锁

移除启用光线重建时的强制光照依赖。


安装

  1. 将ZIP文件解压到任意位置
  2. 关闭《赤色沙漠》
  3. 运行CDModManager.exe
  4. 选择你想要安装的模组
  5. 点击应用选中的模组
  6. 启动游戏

取消勾选模组并点击应用即可移除它。或者点击恢复所有以返回原版状态。


功能

  • 一键安装/卸载,自动备份
  • 可配置模组的逐步预设对话框
  • 当模组编辑相同文件时智能合并
  • 模组配置 - 保存和切换不同的配置
  • 自动检测游戏位置
  • 零依赖 - 单个 .exe 文件,无需 Python,无需框架

对于模组作者

一个 .cdmod 只是一个包含文本替换规则的 JSON 文件:

{
  "format": "cdmod-v1",
  "name": "我的模组",
  "patches": [{
    "archive": "0010",
    "entry_path": "actionchart/playercamerapreset.xml",
    "patch_type": "text_replace",
    "替换项": [
      {"old": "视野=\"40\"", "new": "视野=\"60\""}
    ]
  }]
}

你可以在 Mod Manager 下载的 .zip 文件中找到详细的作者指南,它会引导你完成整个过程。 模组管理器还支持:

  • 二进制预设用于精确文件替换
  • PAZ级模组的存档覆盖层(v1.1新增功能)
  • 可配置的预设,带有自动生成的对话框
  • 内置 PAZ 浏览器、XML 比较器和快速创建工具

兼容性

  • Crimson Desert (Steam)
  • Windows 10/11
  • 与ASI模组和ReShade兼容
  • 所有模组均在游戏版本1.4上测试