安装与使用 Anno 1800 Mod Loader 技术手册

安装与使用 Anno 1800 Mod Loader 技术手册

anno1800-mod-loader The one and only mod loader for Anno 1800, supports loading of unpacked RDA files, XML merging and Python mods. 项目地址: https://gitcode.com/gh_mirrors/an/anno1800-mod-loader

安装指南

注意事项

本加载器功能已集成至游戏，本项目非必需。官方版本及其更新特性，请访问：jakobharder/anno1800-mod-loader。

步骤简述

1. 下载: 访问项目最新版本，下载loader.zip。
2. 解压: 将解压后的文件放置于Anno1800.exe同级目录，如默认的Uplay路径C:\Program Files (x86)\Ubisoft\Ubisoft Game Launcher\games\Anno 1800\Bin\Win64。
3. 覆盖: 当提示替换python35.dll时，请同意替换。
4. 依赖: 确保已安装Visual Studio 2019运行库，点击下载。
5. 模组安装: 模组需单独安装，并遵循本文档中的“项目使用说明”。

注意点

• 模组按照字母顺序加载。
• 模组位置优先级：文档（shell:Personal\Anno 1800\mods）高于游戏安装目录下的mods。

项目使用说明

基础使用

• 模组位置: 可从两处加载模组，游戏安装目录的mods或文档中对应的mods文件夹。
• 高级管理: 经验丰富者可通过mklink创建符号链接以方便管理不同模组仓库。

创建模组

1. 在Anno 1800/mods内为新模组建立目录，例如myMod。
2. 复制并调整游戏内部的XML结构到该目录相应的路径，如将修改的资产文件置于data/config/export/main/asset/assets.xml下。
3. 编辑或创建ModOps结构的XML文件来定义改变，确保采用正确XPath和类型进行节点操作。

ModOp示例

• 使用Type属性指定操作类型（合并、移除、添加等）。
• 通过XPath或GUID精确定位目标XML节点。
• 示例：替换特定资产的名称：

  <ModOp Type="replace" GUID='1337' Path="/Values/Standard/Name">
      <Name>新的测试名</Name>
  </ModOp>
  

分割XML补丁

利用<Include File="补丁文件.include.xml"/>指令在多个文件间分配补丁逻辑，提升可维护性。

API使用文档

该项目提供了XML补丁功能，不直接提供传统意义上对外API接口。Mod开发者通过编写XML补丁文件间接与系统交互，无需额外API调用。

项目构建

开发者环境准备包括：

• 必备软件: Bazel, Visual Studio 2022。
• 步骤:
  1. 安装所需软件。
  2. 克隆项目，调整配置如有需要。
  3. 使用Bazel命令编译Python DLL (bazel build //libs/python35:python35.dll)。

测试与调试

• 游戏保护机制限制了直接调试，但可通过日志(mod-loader.log)查看错误信息，并使用xml-test工具模拟游戏加载过程进行补丁效果验证。

此文档旨在指导用户理解与应用Anno 1800 Mod Loader，简化模组制作与管理流程，实现游戏体验的个性化定制。

anno1800-mod-loader The one and only mod loader for Anno 1800, supports loading of unpacked RDA files, XML merging and Python mods. 项目地址: https://gitcode.com/gh_mirrors/an/anno1800-mod-loader