Ingenium API

Ingenium API

Ingenium API is a lightweight, standalone API mod designed to enable interoperability between Ship Ships, OldCannons, and future projects in the same ecosystem. Rather than hard-coding compatibility directly into each individual mod, Ingenium API acts as a shared, modular layer that allows these mods to communicate with one another, implement addons, and offer compatibility features without creating dependencies between them.

The core philosophy behind this API is modularity. Each mod that hooks into Ingenium API can function completely independently even if other mods are not installed. However, when multiple compatible mods are present together, Ingenium API unlocks additional integrated functionality that wouldn’t otherwise be possible. This gives players and modpack creators full flexibility: you can install just the mods you want, and get extra features automatically when you combine them.

One of the primary use cases currently implemented is enabling ships of Shippy Ships to mount cannons onboard. Through a set of interfaces, ships can expose mounting points and equipment slots, while OldCannons can define what they need to be compatible with. This is handled through interfaces such as ShipMountable (defining ships or ship parts that can accept mounted equipment), ShipEquipmentItem (defining what qualifies as mountable equipment), and MountableShip (used to tie a ship entity to the mounting system).

Beyond the cannon-mounting use case, Ingenium API is built with future expansion in mind. It’s meant to serve as the technical foundation for further cross-mod features and potentially for other projects down the line, without forcing players to install mods they don’t need. The goal is to keep each mod complete and indipendent on its own, while making integrations possible for players who want the full combined experience.

In short: Ingenium API is purely a technical, behind the scenes compatibility API. It adds no new content or gameplay changes by itself, its entire purpose is to let compatible mods talk to each other cleanly and let you mix and match mods based on your preference.