KSA Multiplayer v0.4.0 — Linux
==============================

Requires Kitten Space Agency v2026.8.19.5261.
The server additionally requires the .NET 10 runtime.

The client and the server must both be on v0.4.0. The wire format changed
since 0.2.1, and a mismatched client is refused at join with a message saying
which version the server runs.


CLIENT
------

Copy the "Multiplayer" folder into your KSA mods directory:

    ~/Documents/My Games/Kitten Space Agency/mods/

so that you end up with:

    ~/Documents/My Games/Kitten Space Agency/mods/Multiplayer/Multiplayer.dll
    ~/Documents/My Games/Kitten Space Agency/mods/Multiplayer/mod.toml

Start the game. The multiplayer panel appears beside the HUD.

Nothing else is needed — 0Harmony ships with the game.


SERVER
------

The server holds no KSA assemblies of its own. It finds your game
installation at startup and loads the game's managed assemblies from there,
so it has to be told where the game is. Any one of these works, in order of
precedence:

    ./run-server.sh -gamepath /path/to/KSA
    KSA_PATH=/path/to/KSA ./run-server.sh
    "gamePath": "/path/to/KSA"   in server_config.json

Then:

    cd Server
    chmod +x run-server.sh
    ./run-server.sh

Type "help" at the prompt for the console commands. Ctrl+C shuts it down
cleanly.

Edit server_config.json to change the port, player limit, password, message
of the day, or craft sharing. Set "HostPlayerName" to your player name if you
want your own name starred in everyone's player list.

The server opens no window and never touches the display server, so it is
safe to run headless.


TROUBLESHOOTING
---------------

Logs are written to a "logs" folder beside the mod and beside the server.
Debug logging is on by default; the multiplayer panel has a checkbox for it.

If you report a problem, please include the mod version from BOTH machines,
the logs from both clients, and the server console output. Most of the
interesting bugs come from two players being at different points in time, so
say who was flying what and whether anyone was time warping.

    https://github.com/racerx2/KSA-Multiplayer-Mod/issues


LICENCE
-------

PolyForm Noncommercial License 1.0.0 — see LICENSE.
Free for any noncommercial purpose. Commercial use requires a separate
licence from the author.
