About

Seamless API is the shared integration backbone for the Seamless mod ecosystem. It mostly just makes mod development easier for myself by being able to reuse things.

It lets modders register gameplay data through stable hooks instead of patching internals, so multiple addons can extend the same systems cleanly and safely.

This release focuses on a practical, production-ready API surface for food buffs, combo definitions, deconstruction mappings, meteor triggers, and reusable thrown-item visuals.

Project Goal

Build one long-term API foundation that keeps gameplay authority in host mods while giving addon developers a clean and predictable way to integrate.

That means:

easy registration
safe multiplayer behavior
extension points for future systems
minimal breakage risk as the ecosystem grows

Features

Unified Seamless Facade: one entry path for Food, Deconstruction, Meteor, and Visual modules
Food Buff Registration: builder-based food buff definitions with duration, magnitude, and hearts
Combo Registration: define multi-food combo requirements and bonus effects
Deconstruction API: register item breakdown recipes with dynamic output modifier hooks
Meteor Event Bridge: trigger meteor shower events when the meteor implementation mod is present
Visual Utility API: reusable thrown-item profiles, spin/tumble animation logic, and trail math helpers
Freeze and Merge Lifecycle: host mods lock registration and merge immutable data at startup
Server-First Contract: designed for multiplayer-safe integrations and controlled runtime behavior

Developer Workflow

Register foods, combos, and deconstruction data during mod setup.
Host mods freeze and consume registrations.
Use runtime query/events/modifiers for advanced behavior where supported.

Late registration intentionally throws after freeze to prevent unstable state.

Module Overview

Food Module: food buffs, combo metadata, query/events/modifier integration points
Deconstruction Module: input-to-output mapping plus modifier chain for contextual scaling
Meteor Module: optional API bridge for starting and stopping meteor showers
Visual Module: shared math/profiles for polished thrown-item rendering and trails

Requirements

Minecraft 1.21.11
Fabric Loader 0.18.5+
Fabric API 0.141.3+ (1.21.11)
Java 21+

Notes

Seamless API is intentionally gameplay-light: host mods remain the source of truth.
The API is designed to degrade gracefully when optional companion implementations are absent.
Ideal for addon mods, modpack integrations, and ecosystem-wide compatibility without hard patches.

API Integration

Typical local integration flow:

Publish Seamless API to local Maven.
Add it as compile/runtime dependency in your mod.
Register your content during initialization.
Let host mods freeze and merge for runtime use.

This keeps integrations clean, versionable, and easy to maintain across updates.

SeamlessLib