Skip to content

OmniAPI

Unified Fabric & NeoForge modding API for Minecraft 26.1–26.3 with configs, auto-GUIs, UI widgets, events, data attachments, and energy transfer.

<1,000 downloads Updated
26.3 26.2

No ratings yet

Be the first to rate it.

Rate it

Community listing page

Community listing page, reviews may not be monitored by the author.

About

Description

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, or 26.3.x matching 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): Composable GuiGraphicsExtractor widgets (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 (with copyOnDeath support).
  • Declarative JSON Things (JsonContentLoader): Scans config/omniapi/things/*.json for data-driven item/block specs.
  • Energy & Resource Transfer (OmniEnergyStorage, OmniTransfer): Standardized long-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.