【夸克/迅雷】【搬运】【汉化】DsCppModManager 模组管理器

Gioing · 发表于 2026-8-15 20:11

全中文界面 · 一键管理 Lua / C++ / pak 模组 · 支持 pak 模组热装载 · 模组缩略图预览

适用游戏：《龙之剑：觉醒》 DragonSword : Awakening ｜汉化增强版 v0.80（2026-08-14，持续迭代中）

◆ 工具简介

DsCppModManager 是一款在 游戏标题菜单中直接开关、配置模组的管理工具，外观与操作手感和游戏自带设置窗口完全一致，无需额外学习。
原版作者为 SummerSpring，本贴为 全中文汉化增强版：界面汉化 + 多项功能增强，并随附 验证过的 UE4SS 固定版本，开箱即用。

支持三类模组，放进 plugins 文件夹即可被自动识别管理：

Lua 模组：`plugins\模组名\Scripts\main.lua`
C++ 模组：`plugins\模组名\dlls\main.dll`
pak（内容）模组：`plugins\模组名\*.pak`（可再放入与 pak 同名的图片作为缩略图）

◆ 汉化内容

界面全中文：标题栏、标签页、选项、按钮、弹窗、状态提示全部汉化（原版为韩文界面）；
中文使用手册：随包附带 `MANUAL_CN.md` 中文说明书；
中文插件开发指南：随包附带 `PLUGIN_GUIDE_CN.md`，方便想自制模组的玩家；
汉化仅针对界面与文案，不修改任何模组加载逻辑。

◆ 新增功能（汉化增强版独有）

—— pak（内容）模组热装载 ——

在管理器中开启 / 关闭 pak 资产模组无需重启游戏（引擎级挂载 / 卸载直调已打通）；
未载入过的资产 即时生效；已驻留内存的资产在 重启游戏后自动刷新；
引擎层卸载完整：挂载顺序提升、`~mods` 链接清理、列表移除均已实测通过。

—— Lua 热重载用户开关（v0.80）——

面板「基本」中新增 Lua 热重载复选框，默认关闭（开关 Lua 模组后重启生效，最安全）；
勾选后开关 Lua 模组即时生效（注入 Ctrl+R 全量重载，内置 15 秒冷却防止频繁重载击穿引擎）；
偏好自动持久化，重启游戏仍保留。

—— 模组缩略图系统（v0.72~0.77）——

pak 模组自动显示 与 pak 同名的图片（png / jpg / jpeg）作为缩略图，一眼认出模组；
统一缩放到 72×72（可配），点击缩略图在屏幕中央按原始尺寸放大预览，超屏自动等比缩小，再点关闭；
配置写在 `thumbnails.json`（size / zoomSize / enabled），改完重开面板即生效。

—— 其它增强与修复 ——

面板模组显示名追加括号备注（v0.71），同名 / 变体模组一眼可辨；
安全模式修复（v0.78）：安全模式 pak 残留、缩略图悬垂指针、关闭 Lua 模组崩溃三处问题修复；
中文文件夹名兼容修复（v0.78.1）：TarteMeter 等 Lua 模组在中文名 / 子文件夹布局下路径失效问题已修复（动态推导模组目录，不再硬编码）；
Lua 全量重载加入防抖冷却，连续开关不再击穿音频系统（v0.79）。

◆ UE4SS 版本说明（重要）

本汉化包随附的 UE4SS 为 RE-UE4SS 实验通道固定版本：

版本：UE4SS v3.0.1 Beta #0（Git SHA：c838a8ac，2026-07-15 构建）；
本管理器为 C++ 模组，其 DLL 使用该版本 UE4SS 的导出表链接，更换其它版本的 UE4SS 可能导致模组加载被拒（游戏正常、管理器不出现）；
实验通道是滚动构建，网上现下的实验版不保证与 c838a8ac 一致——请使用本包内固定版本；
UE4SS 为 MIT 开源项目（RE-UE4SS，Narknon），许可证全文随包附于 `LICENSE`。

◆ 分包说明（两个压缩包的区别）

1️⃣ DsCppModManager.zip（约 200 KB）—— 仅管理器本体

内容：`Assets\`、`dlls\main.dll`、`enabled.txt`、中文手册、插件指南、缩略图配置等；
适用：已经装好 UE4SS，只需安装 / 升级管理器本体的情况；
安装：解压出 `DsCppModManager` 文件夹，整体放入 `<游戏>\DS\Binaries\Win64\ue4ss\Mods\`。

2️⃣ DsCppModManager(含ue4ss）.zip（约 7.4 MB）—— 管理器 + UE4SS 固定版（已含注入器）

内容：`dwmapi.dll`（UE4SS 注入器）+ `ue4ss\` 文件夹（内含 `UE4SS.dll` v3.0.1 Beta c838a8ac、`UE4SS-settings.ini`、`LICENSE`、`Mods\`——管理器与 UE4SS 自带模组都在里面）；
适用：首次使用 / 全新安装，或想整套替换为验证版 UE4SS 的情况；
安装：将 zip 内容整体解压到 `<游戏>\DS\Binaries\Win64\`——`dwmapi.dll` 直接放入 `Win64\`，`ue4ss\` 文件夹放入 `Win64\ue4ss\`。

提示：若你的游戏 `Win64\` 下已有旧版 UE4SS 文件（dwmapi.dll / ue4ss 文件夹），请先备份并删除旧文件再使用本包，避免新旧混用。

◆ 安装指南

关闭《龙之剑：觉醒》；
按上面分包说明选择压缩包并解压；
确认目录结构正确（两种布局任选其一）：
- 轻量包：`<游戏>\DS\Binaries\Win64\ue4ss\Mods\DsCppModManager\`
- 含 UE4SS 包：`dwmapi.dll` → `<游戏>\DS\Binaries\Win64\`；`ue4ss\` 文件夹 → `<游戏>\DS\Binaries\Win64\ue4ss\`
启动游戏，标题菜单出现 「模组管理器」选项即安装成功；
首次启动后，在「模组选择」中把需要的模组逐个打开；提示"需要重启"的模组重启后生效；
如需卸载：删除 `ue4ss\Mods\DsCppModManager\` 文件夹即可，不残留任何文件。

◆ 使用指南

—— 界面 ——

标题菜单 → 模组管理器 打开面板（ESC 或右上角 X 关闭，暂仅支持标题画面进入）；
「模组」标签：基本（版本号 / 打开插件文件夹）+ 模组选择（逐行开关模组）；
「顺序」标签：按住行上下拖动即可自定义模组显示顺序（松手保存）；
滚动：鼠标滚轮或按住空白处拖动；滚动条平时隐藏。

—— 开关的两层生效机制 ——

加载层：`enabled.txt` / `mods.txt`——游戏重启后决定 UE4SS 是否加载该模组；
运行时层：`dsruntime.txt`——立即决定已加载模组当前是否活动；
管理器开关时会同时写两个文件；打开本次会话未加载的模组会弹"需要重启游戏"提示，文件已记录、下次启动自动开启。

—— 详细选项控件（模组作者声明后自动生成）——
开/关开关、数字步进器、下拉框、按键绑定、颜色选择、复选框、执行按钮、滑块，共 8 种；选项较多的模组自动折叠（展开 ▼ 一键展开）；更改即写入文件，模组每秒轮询生效。

—— 安全机制（自动保护）——

检测到游戏更新或上次运行崩溃时，自动关闭全部模组并列出最后有记录的模组（仅供参考），防止旧模组导致再次崩溃；
被关闭的模组列表保存在 `safemode_last.txt`，在面板中重新开启即可。

—— 放置模组的位置 ——
所有模组统一放在 `Mods\DsCppModManager\plugins\` 下；支持把 `.zip` 压缩包直接放进 plugins（运行时自动解压，超 200MB 不自动解压）；开启 pak 模组时会在 `Content\Paks\LogicMods\`（或 `~mods\`，取决于作者声明）建立硬链接，文件仅存一份不占双倍空间。

◆ 预览图