【1.1.0-3.4.1】客户端mod加载器v1.0.8（NLog）

认真看帖，游戏愉快，一目十行，保证头疼.

本Mod加载器有NLog和BepInEx两种方式加载。二选一即可。

本贴为较旧的NLog版的安装教程，较新的BepInEx版请左转：【1.1.0-3.3.0】客户端mod加载器v1.0.8（BepInEx）-ODDBA社区

重要提示：街区版本（Client.0.13.0.1.21531）及以后的NLog加载系统失效！

之后的客户端只能使用BepInEx系统进行加载。

名词说明：

• 游戏主文件夹：塔科夫客户端的文件夹，存在塔科夫主程序EscapeFromTarkov.exe、离线服务器(Aki.)Server.exe、离线启动器(Aki.)Launcher.exe。下文简称 “EFT”

• 本加载器DLL主体（NLog）：“EFT\EscapeFromTarkov_Data\Managed\NLog.EFT.ClientModLoader.dll”

• Nlog配置文件：“EFT\EscapeFromTarkov_Data\Managed\Nlog.dll.nlog”

• （安装过程无关）客户端mod存放文件夹：“EFT\ClientMods\”，将客户端mod.dll放在这个文件夹里面

Nlog版安装方法有三：

一键安装：

解压至游戏主文件夹下，然后双击即可：

手动安全安装（仅SPT-2.3.1以前）：

1.在这个帖子中下载NLog模组管理器：NLog 模组管理器 （初版）-ODDBA社区

2.下载本加载器DLL主体：

3.按照NLog模组管理器帖子中的方法安装本加载器。

4.在游戏主文件夹EFT下创建文件夹ClientMods，或者，等打开一次游戏后自动创建。

5.将想玩的mod放入该文件夹内，游戏启动后则自动加载。不想玩的mod直接删除即可，注意先退出游戏。

纯手动不用任何其他工具安装：

1. 先打开一次游戏，确认无mod能玩。

2. 在手动安装步骤中下载本加载器DLL主体。

3. 加载器DLL解压至“EFT\EscapeFromTarkov_Data\Managed\”（见下图二），切勿创建文件夹套娃。

4. SPT-2.3.1以后项目组不再使用NLog加载离线补丁，因此没有配置文件Nlog.dll.nlog，可从一键安装包中解压得到。2.3.1以前需要编辑配置文件加入条目，见下图一。

5. 打开一次游戏，此时应该会自动创建客户端mod存放文件夹“EFT\ClientMods\”，将客户端mod放在这个文件夹里面就会生效。（移除mod前务必关闭游戏）

客户端Mod加载过程：

1. 游戏NLog组件读取配置文件“EFT\EscapeFromTarkov_Data\Managed\Nlog.dll.nlog”，加载本加载器。

2. 本加载器主体NLog.EFT.ClientModLoader.dll 读取文件夹 “EFT\ClientMods\”下的所有客户端mod并依次加载，日志文件为“EFT\ClientMods\log.txt”

故障自助排查(NLog)：

• 正确安装加载器后，每次启动游戏都会更新 “EFT\ClientMods\log.txt” 文件的内容和修改时间。

• 如果此文件没有更新或者不存在，说明加载器没正确安装。需要检查Nlog.dll.nlog文件中是否已写入”ClientModLoader“（下图一）。

• 以及 EFT\EscapeFromTarkov_Data\Managed\下是否有本加载器主文件 NLog.EFT.ClientModLoader.dll 。（下图二）

• 终极故障排查（客户端的错误日志，希望你用不上）：“EFT\Logs\【最后一个文件夹】\【一长串日期-版本号】 errors.log”

图一：配置文件内容

代码：

    <target name="ClientModLoader" xsi:type="ClientModLoader" />

图二：加载器所在文件夹

已测试客户端0.12.10.2.11856（spt-aki 1.1.0） 至0.12.12.32.20765（spt-aki 3.4.1）都可使用。

重要提示：街区版本（Client.0.13.0.1.21531）及以后的NLog加载系统失效！

之后的客户端只能使用BepInEx系统进行加载。

更新日志：

• v1.0.3：修复了游戏退出时再次加载mod的bug。添加一键安装程序。

• v1.0.4：防止重复加载mod。注：SPT-AKIv2.3.1起不再使用Nlog方式加载，届时只需要更新加载器即可继续使用我的客户端Mod系列。

• v1.0.6:  为客户端0.12.12.15.17639更新。

• v1.0.7:  移除组件，提高兼容性。

• v1.0.8:  修复bug

加载器原理：

在ClientMods文件夹下搜索所有dll文件，实例化其所有的 public class ModEntry

欢迎moder加入客户端mod开发：