X4 Procurement Planner

Built From

This site's ship/ware data is generated from these exact versions of the game and every installed DLC, alongside this tool's own version:

Future Plans

A few bigger features on the roadmap, not built yet:

User Accounts & Saved States

Right now, sharing a fleet list, ship loadout, or price override preset means generating a one-off link (see the Share button above). The plan is to eventually add real user accounts, so you can save and recall your own fleet lists, ship loadouts, and price override presets directly -- without needing to keep track of links.

Language Support

Ship and ware names/descriptions are currently only pulled from the game's English-language files. Support for reading other languages X4 itself supports is planned.

Running this locally against your own game install

The hosted website covers the base game and all DLCs. The eventual goal of this is to run against a local install with any combination of DLCs/mods you want to use. However, this is untested so who knows if it works. If you want to try it, here's how:

1. Clone the repository (see the GitHub link above) and install Python dependencies: pip install -r requirements.txt.
2. Obtain XRCatTool (an egosoft first-party X4 catalog-extraction tool -- not included in this repository) and place it at XTools_1.11/XRCatTool.exe under the repo root, or modify the repo code to point to your cli path. [link to the current XRCatTool download to be added here]
3. Run python src/extract_game_data.py to pull ship/equipment/ware data out of your local X4 installation's .cat/.dat catalogs. By default this expects the game installed at C:\Program Files (x86)\Steam\steamapps\common\X4 Foundations -- edit GAME_ROOT at the top of that script if yours lives somewhere else.
4. Run python src/generate_ships_table.py to build data/x4.db from the extracted files.
5. Run python src/api.py and open http://127.0.0.1:8000/.