OmniAPI

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

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.

OmniAPI Team

profile avatar
Owner
  • 2
    Projects
  • 282
    Downloads

I make mods from the video's I see online :P

More from Valcrux

  • Throwing Discs. project image

    Throwing Discs.

    Throw ricocheting discs that pierce mobs and return to your hand — featuring 5 tiers, 9 enchantments, 2 Superpower Relics, and 12 visual trims.

    • 259
    • November 18, 2026
  • Throwing Discs. project image

    Throwing Discs.

    Throw ricocheting discs that pierce mobs and return to your hand — featuring 5 tiers, 9 enchantments, 2 Superpower Relics, and 12 visual trims.

    • 259
    • November 18, 2026