OmniAPI
OmniAPI (omniapi) is a lightweight, cross-loader (Fabric & NeoForge) modding framework for Minecraft 26.1 / 26.1.2, 26.2, and 26.3, built on Java 25.
Instead of depending on a dozen separate libraries, OmniAPI brings core registration, events, JSON configs + auto-generated config screens, UI widgets, dynamic text placeholders, persistent data attachments, and energy/transfer together under one unified dev.omniapi API.
Requirements
- Java: Java 25
- Fabric: Fabric Loader (
>=0.20.1) + Fabric API - NeoForge: NeoForge (
26.1.x,26.2.x, or26.3.xmatching your game version)
Features (v1.0.0)
Core & Platform
- Platform Abstraction (
OmniPlatform): Detect the active loader (FABRIC/NEOFORGE), environment side (CLIENT/SERVER), loaded mods, config/game paths, and register config screens cross-loader. - Deferred Registration (
OmniRegistrar): Register items, blocks, entities, sounds, and other registry entries once across both loaders. - Unified Events (
OmniEvents): Lifecycle hooks (ServerStarting,ServerStarted,ServerStopping), server/client ticks, Brigadier command registration, and block/item/entity interaction events. - Tags & Content Helpers (
OmniTags,OmniContent):c:convention tag helpers plus flammable and oxidizable/waxable block registration helpers.
Config & UI
- JSON Config System (
OmniConfig): Fluent builder with categories, comments, min/max bounds, change callbacks, and automatic JSON saving/loading. - Auto-Generated Config GUI (
OmniConfigScreen): Built-in searchable, scrollable client configuration screen with toggles, enum cyclers, numeric/text inputs, Reset All, Cancel, and Save. - UI Widgets & Placeholders (
OmniWidgets,OmniPlaceholders,UiColor): ComposableGuiGraphicsExtractorwidgets (Panel,Label,ActionButton), search filtering (OmniWidgets.filter), ARGB color helpers, and%namespace:key%placeholders (%player:name%,%server:online%,%server:max_players%).
Data, Energy & Optional Compat
- Persistent Data Attachments (
OmniAttachments):Codec-backed data attachments for entities, block entities, levels, and chunks (withcopyOnDeathsupport). - Declarative JSON Things (
JsonContentLoader): Scansconfig/omniapi/things/*.jsonfor data-driven item/block specs. - Energy & Resource Transfer (
OmniEnergyStorage,OmniTransfer): Standardizedlong-based energy buffer and generic item/fluid transfer helpers. - Phase-2 Scaffolds & Soft Compat (
OmniCompat): Opt-in API definitions for animations (AnimationController), player accessories/abilities (OmniPlayerApi), biome/wood-set specs (OmniWorldApi), dormant gameplay specs (OmniGameplayApi), and optional runtime detection for 14 external mods (emi,jade,create,ae2,modmenu,kubejs, etc.) with zero forced dependencies.
Quick Developer Example
// 1. Config + automatic config screen
OmniConfig config = OmniConfig.builder("mymod", "My Mod")
.category("general")
.defineBool("enableFeature", true, "Enables the main feature")
.buildAndRegister();
// 2. Persistent player data attachment
AttachmentKey<Integer> mana = OmniAttachments.register(
OmniApi.id("mymod", "mana"), () -> 100, Codec.INT, true
);
// 3. Cross-loader events
OmniEvents.onServerTick(server -> {
// Runs every server tick on Fabric and NeoForge
});
Downloads by Version
- 26.1 & 26.1.2:
omniapi-1.0.0+26.1-26.1.2-fabric.jar/-neoforge.jar - 26.2:
omniapi-1.0.0+26.2-fabric.jar/-neoforge.jar - 26.3:
omniapi-1.0.0+26.3-fabric.jar/-neoforge.jar
Built with Stonecutter 0.10. Licensed under MIT.