AutoCollectColony

A mod for Sector Space that automatically collects credits and items from your colonies, so you never have to fly back and use the tax-collector item by hand. Each collection posts a chat event listing the credits and items received.

It is an SSFML / Fabric-style mixin mod that hooks into the game at runtime, so no game files are modified permanently.

Source: github.com/jpreed00/AutoCollectColony

What it does

• Once a player-owned colony's market reaches 100%, the mod deposits that colony's tax credits and items straight into your ship's cargo.
• Collections run on a timer (about every 2 minutes, after a short delay on load) and only for planets that are currently loaded — the current sector plus adjacent ones, matching how the vanilla station colony-collector module behaves.
• After a successful collect, the colony's market is reset to 0% (same as the game's own tax-collect routine), and you get class XP plus a chat summary.

There is no hotkey or window — it just runs in the background.

How it works (and why it's light on performance)

• Hooks game.objects.SpaceShip.specialGearUpdateContinuous() — the same per-ship update loop the game already uses to run station auto-miner / colony collector modules.
• Gates to the player's ship, then scans loaded planets only when a tick counter hits the interval (7200 ticks ≈ 2 minutes at 60 ticks/second).
• Replicates Colony.getTaxCollectColony rather than calling it directly, so the credit total and item list can be shown in chat.

While waiting between scans, the mod does effectively nothing.

Requirements

• Sector Space >= 0.6.0.2 (may work with older versions; only tested on this one).
• SSFML (the Sector Space Fabric Mod Loader) with Fabric Loader >= 0.18.4.
• JDK 25+ (only needed to build from source, not to play).

Installation (players)

1. Download autocollectcolony.jar from GitHub Releases or build from source.
2. Copy it into the mods\ folder inside your Sector Space install directory, e.g.:

   ...\Steam\steamapps\common\Sector Space\mods\autocollectcolony.jar
   

3. Launch Sector Space (with SSFML installed). The mod loads automatically.

Building from source

The mod compiles against the game's own jars, so the project folder is expected to live inside your Sector Space install directory (alongside Sector Space.jar, SSFML.jar, and libs\):

Sector Space\
├─ Sector Space.jar
├─ SSFML.jar
├─ libs\*.jar
├─ mods\
└─ AutoCollectColony\        <- this repo
   ├─ autocollectcolony\mixin\*.java
   ├─ fabric.mod.json
   └─ autocollectcolony.mixins.json

git clone https://github.com/jpreed00/AutoCollectColony.git

1. Point to your JDK

Make sure a JDK 25+ javac/jar is on your PATH, or note the path to its bin folder (the bundled Makefile defaults to D:\Java\jdk-25.0.4.1).

2. Build

From the AutoCollectColony folder:

make

That compiles the sources against the game jars one directory up and packages ..\mods\autocollectcolony.jar, ready to load. make run will also launch the game.

From the Sector Space directory, make builds every mod that has a Makefile.

To build by hand instead:

javac -encoding UTF-8 -cp "../Sector Space.jar;../SSFML.jar;../libs/*" -d build/classes autocollectcolony/mixin/*.java
jar --create --file ../mods/autocollectcolony.jar -C build/classes . -C . fabric.mod.json -C . autocollectcolony.mixins.json

On Linux/macOS, use : instead of ; as the classpath separator.

Project layout

Path	Purpose
autocollectcolony/mixin/	Mixin that injects the auto-collect logic
fabric.mod.json	Mod metadata, dependencies, and mixin registration
autocollectcolony.mixins.json	Mixin configuration

License

Released under the MIT License.