Login

u/ChemODun

▲ 24 r/X4Foundations

For Modders: XML Diff and Patch. A VS Code extension that automatically generates and applies RFC 5261-compatible XML patch files using XPath selectors, watching modified XML files and producing diffs on save.

Features

  • Auto-diff on save: Save a modified XML file and a diff is generated against the original (vanilla) version automatically.
  • Auto-patch on save: Save a diff file and it is applied to the original to regenerate the modified file.
  • Multiple folder pairs: Configure any number of modifiedFolder/diffFolder pairs under a single originalFolder, each with an optional pathPrefix.
  • Glob pattern support: All folder paths accept *, ?, and ** glob wildcards so a single config entry can cover multiple mod directories.
  • Explorer context menu: Right-click XML files or folders for Reset to Original, Reconstruct from Diff, and Regenerate Diff commands.
  • Watch modes: onSave, onTheFly (debounced filesystem watcher), or contextMenuOnly.
  • Settings sidebar: A dedicated explorer panel lets you add, edit, and remove folder pairs per scope (User / Workspace / Folder) without editing JSON directly.
  • XSD validation: Optionally validate generated diff files against a schema, with configurable fail behavior.
  • Empty diff handling: Choose to write, delete, warn, or warn-and-delete when a save produces no diff operations.
  • Orphan cleanup: Regenerating a diff folder removes diff files that no longer have a corresponding modified file.

Requirements

Set xmlDiffAndPatch.originalFolder to the path containing the baseline XML files, then add at least one entry to xmlDiffAndPatch.folderPairs.

Minimal workspace settings example

{
  "xmlDiffAndPatch.originalFolder": "C:/Games/X4 Foundations/data",
  "xmlDiffAndPatch.folderPairs": [
    {
      "modifiedFolder": "${workspaceFolder}/src",
      "diffFolder": "${workspaceFolder}/diff",
      "pathPrefix": "libraries"
    }
  ]
}
  • originalFolder: Path to the vanilla/baseline XML files. Always required.
  • folderPairs: Array of pairs to process. Each pair needs modifiedFolder and diffFolder; pathPrefix is optional (see below).
  • Use "." to refer to the workspace folder itself.
  • modifiedFolder and diffFolder must not point to the same directory.
  • originalFolder, modifiedFolder, and diffFolder support glob patterns (*, ?, **). pathPrefix does not support globs: it must be a plain file-system path segment.

Installation

Visual Studio Code Marketplace: XML Diff and Patch

X4: Foundations Usage

X4: Foundations uses RFC 5261 XML patches to allow mods to modify game data without replacing entire files. This extension automates the diff/patch cycle:

  1. Set originalFolder to the extracted X4 game-data folder.
  2. Add a folder pair pointing at your mod's source XML and the diff output directory.
  3. Edit and save your modified XML: the extension writes the RFC 5261 patch automatically.
  4. Include the diff files in your mod package.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Credits

  • Egosoft - for the game itself (In fact - for the series of games)!
  • Members of the x4_modding discord channel - for their answers, support, ideas, and inspiration!

Changelog

[0.6.0] - 2026-05-17

  • Added
    • Initial public version
u/ChemODun — 6 days ago
▲ 26 r/X4Foundations

For Modders: Context Menu API - An API mod for X4: Foundations that extends the modding surface beyond what SirNukes Mod Support APIs covers, targeting menus and context frame modes not exposed by that API.

An API mod for X4: Foundations that extends the modding surface beyond what SirNukes Mod Support APIs covers, targeting menus and context frame modes not exposed by that API. Currently it supports the Information panel context frames on Map screen, and the Personnel Management, Inventory, Spacesuit Upgrades, and Transaction Log context frames on Player Info screen.

Overview

The mod intercepts createContextFrame on the supported menus and fires a signal before the frame is built. Consumers respond synchronously (within the same MD tick / Lua call) by appending entries via the builder API.

Two integration paths exist, both with equivalent capabilities:

  • MD API - for Mission Director scripts. Uses Get_Actions / Add_Action cue signals.
  • Lua API - for Lua UI scripts. Register a callback via cmAPI.registerLuaCallback(fn); the function returns a list of entry tables, which the API renders using the same pipeline as MD entries.

Requirements

Installation

Guide

Refer to Guide for usage details:

 

Credits

Acknowledgements

  • EGOSOFT - for the X series.
  • kuertee - for the UI Extensions and HUD that makes this extension possible.
  • SirNukes - for the Mod Support APIs that power the UI hooks and options menu.

Changelog

[1.00] - 2026-05-14

  • Added
    • Initial public version.
u/ChemODun — 9 days ago
▲ 36 r/X4Foundations

"Impossible is possible" was taken previously. "Infinity and beyond" didn't fit. So, let’s keep it simple: "Notifications on Map - Always Prepared!" Say hello to a new mod that enables the Notifications Window while in Map mode!

Makes the Notification window available while the Map is open. Normally, game notifications are suppressed when the Map is displayed - this mod restores them, so you never miss an alert while managing your empire.

Features

  • Notifications in map mode: The notification window is shown while the map is open, just as it would be in normal flight view.
  • It still made by Egosoft: The mod does not create a new notification system, it simply "reveals" the existing one in map mode, by forcing it to be shown and adjusting its position to minimize interference with the map UI.
  • Notifications still suppressed in other modes: Notifications are only shown in map mode - they remain hidden in other modes (e.g. station view).
  • Configurable: The feature can be toggled on or off from Options Menu > Extension options > Notifications on Map without restarting the game.
  • Compatible with X4 8.00 and 9.00, but currently published for 9.00 only.
  • Can work with SWI - please check instructions in Forum tab on Nexus mods.

Requirements

  • Please use only latest version of the UI Extensions and HUD for appropriate game version!
  • X4: Foundations: Version 8.00 and UI Extensions and HUD: Version v8.0.4.5 or higher (in v8.x branch) by kuertee.
  • X4: Foundations: Version 9.00 beta 9 or higher and UI Extensions and HUD: Version v9.0.0.0.8.6 or higher (in v9.x branch) by kuertee.
  • Mod Support APIs: Version 1.95 or higher by SirNukes:
  • Options Helper version 1.0 or higher by Chem O\`Dun:

Installation

  • Steam Workshop: Notifications on Map - currently only for 8.00, due to limitations of Steam Workshop for X4 mods.
  • Nexus Mods: Notifications on Map - there are separate versions for 8.00 (8.00.xx) and 9.00 (9.00.xx), so make sure to download the correct one for your game version.

Usage

The notification window will not appear in map mode until you enable it from the extension options. Open Options Menu > Extension options > Notifications on Map and toggle Show Notifications in Map Mode to your preference. The change takes effect immediately - no need to restart the game.

Extension Options

Open Options Menu > Extension options > Notifications on Map to configure the mod.

General

  • Show Notifications in Map Mode: Enable or disable the notification window while the map is open. Default: on.

Debug

  • Debug Mode: Sets the logging verbosity. Options: None (default), Debug, Trace. Useful for troubleshooting only - leave at None during normal play.

Credits

Acknowledgements

  • EGOSOFT - for the X series.
  • kuertee - for the UI Extensions and HUD that makes this extension possible.
  • SirNukes - for the Mod Support APIs that power the UI hooks and options menu.

Changelog

[8.00.02]/[9.00.02] - 2026-05-10

  • Fixed
    • Extra windows were displayed when switched from flight mode.

[8.00.01]/[9.00.01] - 2026-05-10

  • Added
    • Initial public version.
u/ChemODun — 13 days ago
▲ 18 r/X4Foundations

Limitations

Because Egosoft rejected the proposal to develop and expose a C.GetMapRenderedSectors(holomap) function for retrieving the list of sectors currently rendered on the map, this mod falls back to the vanilla approach and works only with stations visible on screen.
As a result, in most cases the data covers only a limited number of stations - significantly fewer than the total across all known sectors.

Visible Production Stations

Adds a Visible Production Stations tab to the Object List panel in the map. Lists all production stations currently visible on the map - both player-owned and NPC - with per-station production data and quick-navigation buttons.

Features

  • Player and NPC stations: Both player-owned and NPC stations are included. Player stations always show the full ware breakdown; NPC stations show ware details when the Logical Station Overview visibility rules allow it.
  • Station icon with issue indicator: The station class icon is shown next to the station name and tinted in warning colour when any production module has an issue.
  • Production ware breakdown: Expand a station row to see per-ware produced, consumed, and net total amounts per hour (player stations and NPC stations where ware data is accessible).
  • Ware icons: Each ware row shows the ware icon alongside its name for quick visual identification.
  • Production issue indicators: If any production modules for a ware are waiting for resources or waiting for storage, the ware name is highlighted in warning colour and a mouseover tooltip lists the exact issue counts per state.
  • Active module count: The module count column shows how many modules are currently running out of the total installed (e.g. 3/5).
  • Ware grouping: Wares are grouped into Products (not consumed on-site), Intermediates (produced and consumed on-site), and Resources (pure inputs, not produced on-site).
  • Limited info for NPC stations: When ware data is not accessible, the expand shows working/total module count and per-issue-type counts for intermediate and production stages.
  • Quick-navigation buttons: Logical Station Overview and Station Production Overview (when the mod is installed) icons are available on each station row.
  • Expand/collapse all: A button in the column header row expands or collapses all station rows at once.
  • Filter by issues: Option to show only stations that currently have at least one production issue.
  • Compatible with X4 8.00 and 9.00.
  • Save-safe: can be added or removed at any time without affecting saved games.

Installation

Visible Ware Overview

Adds a Wares on Visible Stations tab to the Object List panel in the map. Lists all wares present at stations currently rendered in the map view, grouped by transport type (Container, Solid, Liquid, Condensate), with total stock, production and consumption per hour, and station count. Each ware row is expandable to a per-station breakdown.

Features

  • Player and NPC stations: Both player-owned and NPC stations are included. Player stations always show the full ware breakdown; NPC stations show ware details when the Logical Station Overview visibility rules allow it.
  • Grouped by transport type: Wares are organised under section headers: Container Storage, Solid Storage, Liquid Storage, and Condensate Storage.
  • Per-ware summary row: Each ware shows a ware icon with name, total production per hour (green), total consumption per hour (red), total stock across all visible stations, and the number of stations that handle it.
  • Expandable to per-station detail: Click the + button on a ware row to expand it and see a sub-row for each station that handles that ware. The sub-row shows the station name with sector below, per-station production/h, consumption/h, and current stock.
  • Logical Station Overview button: Each station sub-row has a button to open the Logical Station Overview for that station.
  • Expand/collapse all: A button in the column header row expands or collapses all ware rows at once.
  • Empty state: If no ware data is found for the visible stations, a clear message is shown.
  • Cached data: Ware and station data are refreshed periodically to avoid redundant lookups every render.
  • Configurable refresh interval: The data refresh interval (1-10 ticks, default 3) can be adjusted in Extension options.
  • Compatible with X4 8.00 and 9.00.
  • Save-safe: can be added or removed at any time without affecting saved games.

Installation

Credits

Acknowledgements

  • EGOSOFT - for the X series.
  • kuertee - for the UI Extensions and HUD that makes this extension possible.
  • SirNukes - for the Mod Support APIs that power the UI hooks and options menu.

Changelog

[8.00.01] - 2026-05-05

  • Added
    • Initial public version.
u/ChemODun — 17 days ago
▲ 78 r/X4Foundations

Adds an All Ships with Filters tab to the Property Owned menu in the map. The tab shows all owned ships in three sections: Fleets, Stations with Assigned Ships (subordinate ships only, without module or construction rows), and Unassigned Ships. Supports multi-dimensional filtering by ship type, size, sector, dock status, default behaviour, current order, and failed orders.

Features

  • All Ships tab: A dedicated tab in the Property Owned menu lists every owned ship in three sections - Fleets, Stations with Assigned Ships, and Unassigned Ships - using the same ship rows as the vanilla view (hull bars, action buttons, sub-expansion).
  • Stations section: Shows only the subordinate ships assigned to each station, hiding module and construction rows for a cleaner list.
  • Multi-dimensional filtering: Add up to one filter per available dimension. Each filter row has a category dropdown and, once a category is selected, a value dropdown. Multiple filter slots appear automatically; remove a slot by setting its category back to None.
  • Filter dimensions: Type (ship purpose), Size (hull class), Sector, Docked (yes/no), Default Behaviour, Current Order, Failed Orders.
  • Fleet handling: A fleet is shown whenever the fleet commander or at least one subordinate passes the active filters. Fleet unit group entries are always preserved so the expand/collapse button remains functional.
  • Expand/collapse all: When the list contains expandable entries (fleets or stations with subordinates), a master +/- button appears in the filter header row to expand or collapse all at once.
  • Compatible with X4 8.00 and 9.00.

Requirements

Installation

Usage

Open the map, switch to the Property Owned panel, and click the All Ships with Filters tab in the tab strip.

Filter rows

The top of the tab contains one or more filter rows. Each row has:

  • A category dropdown - choose the dimension to filter by (Type, Size, Sector, Docked, Default Behaviour, Current Order, Failed Orders). Setting this back to None removes only that slot; the remaining slots are preserved. Changing it to a different category removes all slots after it, since their value selections may no longer be meaningful.
  • A value dropdown - appears once a category is chosen; select the specific value to match. Choosing None here shows all ships regardless of that dimension's value.

Additional filter slots appear automatically when all existing slots have an active category. All active filters are applied simultaneously (AND logic).

Expand/collapse all

When the ship list contains expandable entries (fleet leaders or stations with subordinates), a +/- button appears in the filter header row. Clicking it expands or collapses every expandable entry at once.

Sections

  • Fleets: Fleet leaders and their subordinates. A fleet is visible if the commander or any subordinate passes the active filter. When a fleet is shown but only some subordinates match, the subordinate list is pre-filtered so only matching ships appear inside the expanded fleet. The fleet leader row itself is always shown even if the commander does not match, as long as at least one subordinate does.
  • Stations with Assigned Ships: Only stations that have at least one assigned ship passing the filter are shown. The subordinate ship list inside each station is pre-filtered to matching ships only; module and construction rows are never shown.
  • Unassigned Ships: Ships not assigned to a fleet or station that pass the active filter.

Extension options

Options Menu > Extension options > All Ships with Filters:

  • Debug mode: Controls log verbosity. Options: None (default), Debug, Trace. Use Debug or Trace only when troubleshooting - these write to the game log on every refresh.

Credits

Acknowledgements

  • EGOSOFT - for the X series.
  • kuertee - for the UI Extensions and HUD that makes this extension possible.
  • SirNukes - for the Mod Support APIs that power the UI hooks and options menu.

Changelog

[8.00.02] - 2026-04-28

  • Added
    • Initial public version.

P.S.

There were two comments where people asked about the all ships on tab and possibility to see all docked ships - there is a solution :-)

u/ChemODun — 25 days ago
▲ 110 r/X4Foundations

Adds an Unassigned Plus tab to the Property Owned menu in the map, placed next to the vanilla Unassigned Ships tab. A dropdown at the top of the tab lets you auto-group unassigned ships into folders by Type, Size, Order, Sector, or any combination of all four - with optional collapsible groups and hierarchical nesting.

Features

  • Unassigned Plus tab: A dedicated tab in the Property Owned menu lists all unassigned ships with the same ship rows as the vanilla view - hull bars, action buttons, and sub-expansion all work exactly as in the vanilla tab.
  • Flexible grouping: Ships can be grouped by any single dimension or any combination of up to four dimensions: Type (Purpose), Size, Order, Sector. All permutations are available in the dropdown.
  • Hierarchical groups: When multiple grouping dimensions are selected, enable the Hierarchical checkbox to render groups as a nested tree of headers rather than flat concatenated labels.
  • Collapsible groups: Enable the Collapsible checkbox to add +/- toggle buttons to group headers. A master expand/collapse button appears in the section header row. Collapsed state is preserved when re-opening the tab.
  • Group ordering: Purpose groups follow a logical role order (Fight, Auxiliary, Trade, Mine, Salvage, Build, Other); Size groups are sorted largest-first; Order and Sector groups are sorted alphabetically.
  • Save configuration: When the Save Tab configuration on change option is enabled (default: on), the current grouping mode, hierarchical, and collapsible settings are persisted to the save file and restored on the next session.
  • Hide vanilla tab: Optionally hide the original Unassigned Ships tab to reduce clutter.
  • Tab positioning: The tab is placed immediately after the vanilla Unassigned Ships tab.
  • Compatible with X4 8.00 and 9.00.

Requirements

Installation

Usage

Open the map, switch to the Property Owned panel, and click the Unassigned Plus tab in the tab strip.

Grouping dropdown

The first row of the tab contains a Group by: dropdown.

Available options:

  • None - no grouping; ships listed flat, same as vanilla.
  • Type - group by ship role: Fight, Trade, Mine, Salvage, Build, Auxiliary, Other.
  • Size - group by hull class: XL, L, M, S, XS.
  • Order - group by the ship's current order name.
  • Sector - group by the ship's current sector.
  • Type, Size / Size, Type / ... - multi-dimension grouping; all permutations of up to all four dimensions are available.

Hierarchical checkbox

Visible when any grouping is active. When checked, multi-dimension groups are rendered as a nested tree: the first dimension forms top-level group headers, each of which contains sub-headers for the second dimension, and so on. When unchecked, the combined label (e.g. "Fight / Small") is used as a single flat header.

Collapsible checkbox

Visible when any grouping is active. When checked, each group header gains a +/- toggle button. The section header row also gains a master button to expand or collapse all groups at once. Groups start expanded; collapsed state is remembered until the grouping mode changes.

Collapse all button

When collapsible groups are enabled, a master toggle button appears in the section header row. Clicking it collapses or expands all groups at once.

Sorting

The sorting buttons take effect immediately when on grouped objects, mostly inside a groups.
But in addition the sorting by size and sector has also effect on groups itself.

Extension options

Options Menu > Extension options > Unassigned Plus:

  • Hide Original Unassigned Ships Tab: When enabled, the vanilla Unassigned Ships tab is removed from the tab strip. Disabled automatically if the vanilla tab was already hidden by another mod.
  • Save Tab configuration on change: When enabled (default), the current grouping mode, Hierarchical, and Collapsible settings are saved to the game save whenever they change and restored automatically on the next session.

Credits

Acknowledgements

  • EGOSOFT - for the X series.
  • kuertee - for the UI Extensions and HUD that makes this extension possible.
  • SirNukes - for the Mod Support APIs that power the UI hooks and options menu.

Changelog

[8.00.01] - 2026-04-27

  • Added
    • Initial public version.
u/ChemODun — 26 days ago