ShipPointAPI

Ship Point API

ShipPointAPI is a lightweight modding framework for Space Haven that allows other mods to use the game's existing Ship Points as configurable progression rewards.

Instead of every mod needing its own custom Java implementation to modify Ship Points, a content mod can declare its rewards through a simple XML descriptor and let ShipPointAPI handle the reward system.

What are Ship Points?

Ship Points are part of Space Haven's existing fleet progression system.

They determine how much additional ship capacity the player can create or claim. Creating new ship canvases consumes Ship Points, and Ship Points are also taken into account when claiming additional ships.

Ship Points are NOT System Points.

System Points are the per-ship computing resource provided by System Cores and consumed by advanced facilities.

ShipPointAPI works with Ship Points — the fleet-level resource used for expanding your fleet.

What does ShipPointAPI do?

• []Allows mods to award additional vanilla Ship Points.[/]

  []Lets rewards be defined through a small XML file.[/]

  []Allows each mod to register its own reward entries.[/]

  []Lets the mod author decide how many Ship Points a reward gives.[/]

  []Connects rewards to supported progression triggers.[/]

  []Keeps the Ship Point reward logic centralized instead of requiring every content mod to implement its own system.[/]

  []Uses Space Haven's existing Ship Point mechanic rather than creating a separate custom currency.[/]

  This makes it possible to create progression where expanding the player's fleet is something that can be earned through modded content.

  For example, a technology-focused mod can reward the player with another Ship Point after completing an important research project.

  Current API Support

  Supported reward triggers:

  • []research — Grant Ship Points when a specified technology is completed.[/]

    Additional reward types may be added to ShipPointAPI in future versions.

    If a reward type is not listed above, it should currently be considered unsupported.