Modding tools. XML diff and patch for X4 - Foundations

Modding tools: XML diff and patch for X4: Foundations

This toolset is a simple XML diff and patch tools for X4: Foundations. It is designed to help modders to compare and patch XML files.

The format of diff XML files is compatible with the appropriate diff.xsd format definition. It is means - you can you this tool to create diff files for any XML files used in game.

Also, you can use appropriate tool to patch XML files with diff files, this action has reason to check how your diff file will be applied to the vanilla XML file. Or better understand, what other modders did in their mods.

Important note

It is highly recommended to use the diff.xsd file to validate the diff XML files. It is especially important when you creating them by XMLDiff.exe.

But there is one significant limitation of the current version of the diff.xsd file (distributed with game version 8. 00HF3/4)- it has strict rules for the replace operation. It has to support only one element in the replace element. It is means - if your files have more than one element in the replace element, the validation will fail. So, not use the diff.xsd file for validation in this case at all.

If the diff.xsd file if it located in the "current" folder it will be used automatically. If you want to use another diff.xsd file, you can specify it with the -x option.

How to use

• []Download the latest release from:

  [] GitHub releases page - there is an archive file XMLDiffAndPatch.zip.[/]

  []NexusMods - there is an archive file XMLDiffAndPatch.zip.[/]

[]Extract the archive file to any useful location.[/]

[]Inside will be a folder named XMLDiffAndPatch with two executables - XMLDiff.exe and XMLPatch.exe.[/]

How to create a diff file

There is a command line help for the XMLDiff tool:

XMLDiff 1. 0. 1

Developed by Chem O`Dun

-o, --original_xml            Required. Original XML file or directory.

-m, --modified_xml            Required. Modified XML file or directory.

-d, --diff_xml                Required. Output diff file or directory.

-x, --xsd                     Path to diff.xsd (default: diff.xsd).

-l, --log-to-file             Enable file logging at the specified level: error|warn|info|debug. Console always logs at info level.

-a, --append-to-log           (Default: false) Append to existing log file instead of overwriting.

--only-full-path              (Default: false) Generate only full absolute XPath (no // shorthand).