SeamlessLib

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

1. Register foods, combos, and deconstruction data during mod setup.
2. Host mods freeze and consume registrations.
3. 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:

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

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

Also Check Out