Light.vnTools 二次开发版

项目简介

本项目基于 bungaku-moe/Light.vnTools 进行二次开发，主要新增如下功能：

• 批量处理脚本：提供 decode_mcdat.py，可自动批量解密 .mcdat 文件并识别常见格式，自动重命名后缀。
• 命令行友好：支持 --no-pause 参数，便于脚本/自动化调用，无需人工干预。
• 兼容原版全部功能，支持 .vndat/.mcdat 文件的解包、加密、解密与重打包。

主要差异与增强

• 增加 decode_mcdat.py 脚本，自动批量处理目录下的 .mcdat 文件，自动识别文件类型并重命名。
• LightvnTools.exe 新增 --no-pause 参数，命令行/脚本调用时不会阻塞等待输入。
• 修复了解密输出文件不存在时报错的问题（自动创建输出文件）。
• 开发过程中部分功能和文档由 AI 辅助生成。

Releases 说明

• Releases 页面仅提供了 win-x64 版本。如需其他平台或架构（如 Linux、ARM），请自行 clone 并编译源码。
• Releases 中的 LightvnTools.exe 为打包后的单文件版本，无需安装 .NET 环境即可运行，但文件体积较大。
• 开发和测试建议使用 .NET SDK 直接编译运行，便于调试和二次开发。

环境要求

• .NET 7.0 SDK 或 .NET 8.0 SDK
• Python 3.7 及以上（仅批量脚本需要）

使用方法

1. 单文件/文件夹操作

• 解包/解密
  直接将 .vndat 或 .mcdat 文件拖拽到 LightvnTools.exe 上，或命令行运行：

  LightvnTools.exe yourfile.mcdat

• 重打包/加密
  将解包后的文件夹拖拽到 LightvnTools.exe，或命令行运行：

  LightvnTools.exe unpacked_folder

2. 批量解密与自动识别格式

• 将所有 .mcdat 文件放入同一目录，运行：

  python decode_mcdat.py your_mcdat_dir

• 支持参数 --show-cmd-output 显示详细解密过程。

• 脚本会自动调用 LightvnTools.exe --no-pause，解密后根据文件头自动识别格式并重命名为 .mp3、.png、.txt 等常见后缀。

3. 命令行参数说明

• --no-pause
  仅用于 LightvnTools.exe，脚本/自动化调用时建议加上，避免等待按键退出。

典型用法示例

# 解密单个文件
LightvnTools.exe --no-pause 0.mcdat

# 批量自动解密并识别格式
python decode_mcdat.py ./Data

致谢

• 原项目作者 bungaku-moe/Light.vnTools
• 格式识别部分参考了社区常见魔数表

许可证

本项目遵循原项目 GPL v3.0 协议。

本工具仅供学习与汉化等正当用途，禁止用于任何侵权或商业非法用途。风险自负。

---

点击查看原版英文 README