Mod Structure Checker v1.1.0

Mod Structure Checker v1.1.0 Release Notes

✨ New Features

• Added "Extension Settings" menu to customize file extensions for scanning:
  • Supports text files and images with custom text extensions (e.g., .xs).
  • Expanded default extension list: .json, .yaml, .csproj, .sln, .lua, .tiff, .webp, and more.
• Root Directory Scanning:
  • Files in the root of the selected folder (e.g., D:\Games\RimWorld1.5\Mods\GrowthWallMod) are now included under "Root Directory" in the report.
• Automatic Versioning:
  • Enabled automatic build number generation (Build and Revision) using wildcards (*) in .csproj.
  • UI version (labelAuthor) now dynamically fetched from assembly metadata.

🐛 Improvements & Fixes

• Enhanced Error Handling:
  • Errors are displayed in a reusable ErrorStatusForm window across multiple scans.
  • Removed redundant error messages for each extension when a folder is inaccessible.
  • Added multilingual error tips (English, Russian, Chinese) to ScanErrors.txt.
• Report Optimization:
  • ModFullData.txt now fully includes folder structure, text file contents, and image metadata, even with partial access errors.

⚙️ Technical Changes

• Disabled build determinism (<Deterministic>false</Deterministic>) to support wildcard versioning.

Заметки о выпуске Mod Structure Checker v1.1.0

✨ Новые функции

• Добавлено меню "Настройки расширений" для выбора расширений файлов:
  • Поддержка текстовых файлов и изображений с пользовательскими текстовыми расширениями (например, .xs).
  • Расширен список по умолчанию: .json, .yaml, .csproj, .sln, .lua, .tiff, .webp и др.
• Сканирование корневой директории:
  • Файлы в корне выбранной папки (например, D:\Games\RimWorld1.5\Mods\GrowthWallMod) теперь включаются в отчёт в разделе "Корневая директория".
• Автоматическое обновление версии:
  • Настроено автоматическое создание номера сборки (Build и Revision) с использованием подстановочных знаков (*) в .csproj.
  • Версия в интерфейсе (labelAuthor) теперь динамически берётся из метаданных сборки.

🐛 Улучшения и исправления

• Улучшенная обработка ошибок:
  • Ошибки отображаются в переиспользуемом окне ErrorStatusForm при повторных запусках.
  • Убраны лишние сообщения об ошибках для каждого расширения при недоступности папки.
  • Добавлены советы по устранению ошибок на трёх языках (английский, русский, китайский) в ScanErrors.txt.
• Оптимизация отчёта:
  • ModFullData.txt теперь полностью включает структуру папок, содержимое текстовых файлов и метаданные изображений даже при частичных ошибках доступа.

⚙️ Технические изменения

• Отключён детерминизм сборки (<Deterministic>false</Deterministic>) для поддержки подстановочных знаков.

Mod Structure Checker v1.1.0 发布说明

✨ 新功能

• 添加了“扩展设置”菜单，用于自定义扫描文件扩展名：
  • 支持文本文件和图像，允许用户自定义文本扩展名（例如 .xs）。
  • 扩展默认列表：.json、.yaml、.csproj、.sln、.lua、.tiff、.webp 等。
• 根目录扫描：
  • 所选文件夹根目录中的文件（例如 D:\Games\RimWorld1.5\Mods\GrowthWallMod）现在包含在报告的“根目录”部分中。
• 自动版本控制：
  • 在 .csproj 中使用通配符（*）实现构建号（Build 和 Revision）的自动生成。
  • 界面中的版本（labelAuthor）现在从程序集元数据动态获取。

🐛 改进与修复

• 改进错误处理：
  • 错误在多次扫描中复用 ErrorStatusForm 窗口显示。
  • 删除了文件夹不可访问时每个扩展名的冗余错误消息。
  • 在 ScanErrors.txt 中添加了三语错误解决建议（英语、俄语、简体中文）。
• 报告优化：
  • ModFullData.txt 现在即使在部分访问错误下也能完整报告文件夹结构、文本文件内容和图像元数据。

⚙️ 技术变更

• 禁用了构建确定性（<Deterministic>false</Deterministic>）以支持通配符版本控制。

Mod Structure Checker v1.0.0

Mod Structure Checker

English
Description:
Welcome to the release of Mod Structure Checker — a convenient tool for analyzing and documenting the structure of modifications (mods). This Windows Forms application, developed in C#, allows you to quickly scan mod folders, collect data on directory structures, text files, and images, and save the results to a convenient text file.

Key Features:

• Select a folder with mods and a save location for results.
• Recursive display of directory structures in a tree view.
• Analysis of text files (.xml, .cs, .txt) with content output.
• Collection of image metadata (.png, .jpg, .jpeg, .gif, .bmp) — dimensions and file size.
• Error logging in a separate window with timestamps.
• Unicode (UTF-8) support for correct handling of files in different languages.

Usage:

1. Download the archive with binaries.
2. Extract and run ModStructureCheckerApp.exe.
3. Select the mod folder and (if needed) the save location.
4. Click "Run Analysis" and wait for the process to complete.
5. Results will be saved to ModFullData.txt in the specified directory.

Requirements:

• Operating System: Windows (tested on Windows 10 and above).
• .NET 8.0 Runtime:
  • Required to run the application. Not pre-installed on all systems.
  • For 32-bit (x86) systems: Download from https://dotnet.microsoft.com/en-us/download/dotnet/8.0/runtime-8.0.0-win-x86
  • For 64-bit (x64) systems: Download from https://dotnet.microsoft.com/en-us/download/dotnet/8.0/runtime-8.0.0-win-x64
  • Installation: Run the downloaded installer and follow the on-screen instructions.
  • Note: Check your system type via right-click 'This PC' → 'Properties'.
• Disk Space: Approximately 5-10 MB for the application, plus additional space for generated reports.
• No additional software required.

Notes:

• This is a standalone application, no installation needed.
• In case of errors (e.g., file or directory access issues), they will be displayed in the error status window.
• Source code is available in the repository: https://github.com/ArockMSK/ModStructureCheckerApp

Русский
Описание:
Добро пожаловать в релиз Mod Structure Checker — удобного инструмента для анализа и документирования структуры модификаций (модов). Это приложение с графическим интерфейсом, разработанное на C# с использованием Windows Forms, позволяет быстро сканировать папки с модами, собирать данные о структуре директорий, текстовых файлах и изображениях, а затем сохранять результаты в удобный текстовый файл.

Основные возможности:

• Выбор папки с модами и папки для сохранения результатов.
• Рекурсивное отображение структуры директорий в виде дерева.
• Анализ текстовых файлов (.xml, .cs, .txt) с выводом их содержимого.
• Сбор метаданных изображений (.png, .jpg, .jpeg, .gif, .bmp) — размеры и размер файла.
• Логирование ошибок в отдельном окне с поддержкой временных меток.
• Поддержка Unicode (UTF-8) для корректной работы с файлами на разных языках.

Использование:

1. Скачайте архив с бинарниками.
2. Распакуйте и запустите ModStructureCheckerApp.exe.
3. Выберите папку с модами и (при необходимости) папку для сохранения.
4. Нажмите "Запустить сборку" и дождитесь завершения процесса.
5. Результаты будут сохранены в файл ModFullData.txt в указанной директории.

Требования:

• Операционная система: Windows (тестировалось на Windows 10 и выше).
• .NET 8.0 Runtime:
  • Требуется для работы приложения. На некоторых системах он может отсутствовать.
  • Для 32-битных (x86) систем: Скачайте отсюда https://dotnet.microsoft.com/en-us/download/dotnet/8.0/runtime-8.0.0-win-x86
  • Для 64-битных (x64) систем: Скачайте отсюда https://dotnet.microsoft.com/en-us/download/dotnet/8.0/runtime-8.0.0-win-x64
  • Установка: Запустите скачанный установщик и следуйте инструкциям на экране.
  • Примечание: Проверьте тип системы через правый клик по "Этот компьютер" → "Свойства".
• Место на диске: Примерно 5-10 МБ для приложения, плюс дополнительное место для отчётов.
• Дополнительное ПО не требуется.

Примечания:

• Это автономное приложение, установка не требуется.
• В случае ошибок (например, проблем с доступом к файлам или директориям) они будут отображены в окне статуса ошибок.
• Исходный код доступен в репозитории: https://github.com/ArockMSK/ModStructureCheckerApp

中文 (简体)
描述:
欢迎体验 Mod Structure Checker 发布版 — 一个方便的工具，用于分析和记录修改（模组）的结构。这款基于 C# 开发的 Windows Forms 应用程序，允许您快速扫描模组文件夹，收集目录结构、文本文件和图像数据，并将结果保存到方便的文本文件中。

主要功能：

• 选择模组文件夹和保存结果的路径。
• 递归显示目录结构，以树形视图呈现。
• 分析文本文件 (.xml, .cs, .txt) 并输出其内容。
• 收集图像元数据 (.png, .jpg, .jpeg, .gif, .bmp) — 尺寸和文件大小。
• 在单独窗口中记录错误，支持时间戳。
• 支持 Unicode (UTF-8)，确保不同语言文件的正确处理。

使用方法：

1. 下载包含二进制文件的存档。
2. 解压并运行 ModStructureCheckerApp.exe。
3. 选择模组文件夹和（如果需要）保存路径。
4. 单击“运行分析”并等待过程完成。
5. 结果将保存到指定目录中的 ModFullData.txt 文件。

系统要求：

• 操作系统：Windows（在 Windows 10 及以上测试）。
• .NET 8.0 Runtime:
  • 运行应用程序所需。某些系统中可能未预装。
  • 对于 32 位 (x86) 系统：从 https://dotnet.microsoft.com/en-us/download/dotnet/8.0/runtime-8.0.0-win-x86 下载
  • 对于 64 位 (x64) 系统：从 https://dotnet.microsoft.com/en-us/download/dotnet/8.0/runtime-8.0.0-win-x64 下载
  • 安装：运行下载的安装程序并按照屏幕上的说明操作。
  • 注意：如果不确定系统类型，右键点击“此电脑”→“属性”查看。
• 磁盘空间：应用程序约需 5-10 MB，外加生成的报告所需空间。
• 无需额外软件。

注意事项：

• 这是一个独立应用程序，无需安装。
• 如果出现错误（例如文件或目录访问问题），它们将在错误状态窗口中显示。
• 源代码可在仓库中获取：https://github.com/ArockMSK/ModStructureCheckerApp