无限引擎模组安装器

  /\/\   ___   __| | (_)_ __  ___| |_ __ _| | | ___ _ __
 /    \ / _ \ / _` | | | '_ \/ __| __/ _` | | |/ _ \ '__|
/ /\/\ \ (_) | (_| | | | | | \__ \ || (_| | | |  __/ |
\/    \/\___/ \__,_| |_|_| |_|___/\__\__,_|_|_|\___|_|

《无限引擎模组安装器》是一款旨在自动化安装《无限引擎》游戏（如《博德之门》、《冰风谷》和《异域镇魂曲》）模组的工具。它使用名为“weidu.log”的文件来确定要安装哪些模组以及如何安装它们。

安装

mod_installer可以通过crates.io进行安装

cargo install mod_installer

或者您可以从GitHub的最新版本页面获取它，在此。

使用方法

要使用《无限引擎模组安装器》，您需要从命令行运行它。以下是命令的基本结构

mod_installer(.exe) [OPTIONS] 
  --log-file <LOG_FILE> 
  --game-directory <GAME_DIRECTORY> 
  --weidu-binary <WEIDU_BINARY> 
  --mod-directories <MOD_DIRECTORIES>

让我们分析每个部分的意义

• mod_installer(.exe)：这是您正在运行的程序名称。[选项]：这是您可以使用来定制程序工作方式的额外设置（我们将在下面详细介绍这些设置）。

• --log-file <LOG_FILE>：告诉程序“weidu.log”文件的位置。

• --game-directory <GAME_DIRECTORY>：告诉程序您的游戏安装位置。

• --weidu-binary <WEIDU_BINARY>：告诉程序WeiDU程序的位置（WeiDU是用于安装模组的工具）。

• --mod-directories <MOD_DIRECTORIES>：告诉程序找到模组文件的位置。

常见问题解答

《无限引擎模组安装器》查看您提供的“weidu.log”文件。此文件包含您要安装的模组的信息。然后，该工具会遍历此列表并自动安装每个模组。这为您节省了时间和精力，因为您不必逐个手动安装每个模组。

WeiDU日志

WeiDU日志文件包含已安装的模组列表，通常位于您的游戏目录中，如果您之前安装过模组。以下是一个WeiDU日志的示例

// Log of Currently Installed WeiDU Mods
// The top of the file is the 'oldest' mod
// ~TP2_File~ #language_number #component_number // [Subcomponent Name -> ] Component Name [ : Version]
~TEST_MOD_NAME_1/TEST.TP2~ #0 #0 // test mod one

如果您是《无限引擎》游戏的模组制作新手，我们建议您先手动安装模组，以便熟悉这个过程。这将帮助您了解模组的工作原理以及它们如何与您的游戏交互。

开始使用WeiDU日志

如果您正在寻找一个示例weidu.log以开始

检查在线论坛和模组社区。经验丰富的玩家和模组制作者通常会分享他们的模组列表和相应的Weidu日志。寻找你特定游戏中的“模组包”或“推荐模组列表”。这些通常包含预配置的Weidu日志。从少量流行的模组开始，随着你对模组制作过程越来越熟悉，逐渐构建你的日志。一些Infinity Engine游戏的模组管理器可以根据你选择的模组生成Weidu日志。

请记住，Weidu日志是一个强大的工具，但了解你正在安装的内容很重要。在安装模组之前，请始终备份游戏文件，并注意某些模组可能会与其他模组冲突。

演示

我们有一个简短的视频展示了该工具的工作原理

我可以使用哪些选项？

不要慌张你可以使用帮助命令来查找下面列出的所有选项

• -h, --help

  功能：这会显示一个帮助信息，其中包含有关如何使用程序的信息。如何使用：只需将此选项添加到您的命令中即可。示例：mod_installer --help

以下是您可以使用的所有选项的详细说明

• -f, --log-file <LOG_FILE>

  功能：这会告诉程序在哪里找到“weidu.log”文件。如何使用：用您的“weidu.log”文件的路径替换<LOG_FILE>。示例：--log-file C:\Games\Baldur's Gate\weidu.log

• -g, --game-directory <GAME_DIRECTORY>

  功能：这会告诉程序您的游戏安装在哪里。如何使用：用您的游戏文件夹的路径替换<GAME_DIRECTORY>。示例：--game-directory C:\Games\Baldur's Gate

• -w, --weidu-binary <WEIDU_BINARY>

  功能：这会告诉程序在哪里找到WeiDU程序。如何使用：用您的WeiDU可执行文件的路径替换<WEIDU_BINARY>。示例：--weidu-binary C:\WeiDU\weidu.exe

• -m, --mod-directories <MOD_DIRECTORIES>

  功能：这会告诉程序在哪里找到模组文件。如何使用：用您的模组文件夹的路径替换<MOD_DIRECTORIES>。示例：--mod-directories C:\BG_Mods

• -l, --language

  功能：这会设置游戏和模组的语言。如何使用：用您首选的语言代码替换。默认：en_US（英语）示例：--language fr_FR（法语）

• -d, --depth

  功能：这会设置程序应在文件夹中查找模组文件有多深。如何使用：用数字替换。默认：5示例：--depth 3

• -s, --skip-installed

  功能：这会让程序检查已经安装的内容，并跳过这些模组。如何使用：只需将此选项添加到您的命令中即可。默认：默认开启。示例：--skip-installed

• -a, --abort-on-warnings

  功能：这会让程序在遇到任何警告时停止。如何使用：只需将此选项添加到您的命令中即可。默认：默认开启。示例：--abort-on-warnings

• -t, --timeout

  功能：这会设置程序在放弃安装每个模组之前将等待多长时间。如何使用：用秒数替换。默认：3600（1小时）示例：--timeout 7200（2小时）

• -u, --weidu-log-mode <WEIDU_LOG_MODE>

  功能：这会设置WeiDU应该如何记录其操作。如何使用：用WeiDU日志模式替换<WEIDU_LOG_MODE>。默认：--autolog示例：--weidu-log-mode --log

• -x, --strict-matching

  功能：这会让程序在匹配模组版本和组件方面更加严格。如何使用：只需将此选项添加到您的命令中即可。默认：默认关闭。示例：--strict-matching

• -V, --version

  功能说明：此功能显示您正在使用的程序版本。如何使用：如果您想检查版本，只需将此选项添加到您的命令中。示例：mod_installer --version

日志记录

您可以通过设置 RUST_LOG 环境变量来让程序显示更多信息。以下是您可以使用的三种级别：

用于一些附加信息

RUST_LOG=INFO mod_installer [OPTIONS]

用于每个步骤的详细信息

RUST_LOG=DEBUG mod_installer [OPTIONS]

用于所有内容，包括 WeiDU 日志

RUST_LOG=TRACE mod_installer [OPTIONS]