Skip to content

Installing#

Borea is the community mod manager for KSA. It runs on Windows, Linux and macOS, installs the StarMap loader for you and keeps the mod up to date.

  1. Install Borea from its releases page.
  2. Open KSArmory on Borea and click Install with Borea. You can also search for KSArmory on Borea's Discover page.
  3. Always start the game from Borea. If you start KSA directly, the parts show up in the editor but the weapons do nothing.

By hand#

You need:

  • Kitten Space Agency, build 2026.10.19.5638. Other builds may not work until the mod is updated.
  • StarMap, the community mod loader. KSArmory does not run without it.

Windows and Linux use the same download.

  1. Install StarMap and edit its StarMapConfig.json so it points at your KSA install. Run StarMap from its own folder, because it looks for that file next to itself.
  2. Download KSArmory-<version>.zip from Releases.
  3. Find your KSA user folder:
Platform KSA user folder
Windows Documents\My Games\Kitten Space Agency\
Linux usually ~/.local/share/Kitten Space Agency/ (the folder that has manifest.toml and Logs/ in it)
Proton / Wine inside the prefix, at .../drive_c/users/<user>/Documents/My Games/Kitten Space Agency/
  1. Unzip the archive into the mods folder there. You should end up with mods/KSArmory/KSArmory.dll, with the Meshes, Textures, Sounds, Shaders and KSArmory folders beside it. Unzip it as it is: don't flatten the folders or rename anything. Linux cares about upper and lower case.
  2. Open manifest.toml in the KSA user folder and add:
[[mods]]
id = "KSArmory"
enabled = true

Copying the folder in is not enough. Without this entry the mod does not load, and nothing tells you. 6. Start the game with StarMap: StarMap.exe on Windows, or dotnet StarMap.dll from the StarMap folder on Linux.

Check it worked#

  1. Open Logs/KSArmory.log in the KSA user folder. (With Borea, look in the folder under Documents, not in Borea's instance folder.) The previous session's log is kept as KSArmory.prev.log.
  2. You should see a loading (mod id: KSArmory) line, and about 20 seconds later a ready - Pantsir-S1, ... line. The wait is normal: the mod waits for the game to finish loading.
  3. In the editor, open the Weapons tab, build a craft with the Pantsir-S1 Point Defence System and launch it.
  4. Open KSArmory > Panel from the menu bar. The panel lists the craft and its weapons.

If it doesn't work#

What you see What to check
No KSArmory.log With Borea: that you started the game from Borea, and that you are looking in the Documents folder. By hand: the manifest.toml entry, and that you started StarMap rather than KSA.
The parts are missing from the editor KSA could not read the mod's files. Look in KSA's own log, the newest KittenSpaceAgency.*.log in the same Logs folder.
The parts are there but nothing happens in flight The game was started without StarMap.
A part is untextured or invisible The Meshes or Textures folder is missing or in the wrong place. Unzip again.
Works on Windows, untextured on Linux A file or folder name has the wrong case. Unzip again instead of renaming by hand.
The panel says no weapons system on this craft The weapon is not on the craft you are looking at, or its family is switched off under KSArmory > Built-in weapons.