?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
Compat API

Compat API

Universal compat api that auto-loads integrations, data packs and loot modifiers for mods that depend on it.

23
0

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Client and server

Links

Visit wiki Join Discord server

Creators

FixerLink
FixerLinkMember

Details

Licensed MIT
Published 2 weeks ago
Updated 3 days ago

📖 About

Compat API is a lightweight and universal compatibility framework for the entire “Compat” ecosystem by fixerlink — including Compat Delight, the upcoming Compat Artifacts, Compat Decor, and any third-party mod that wants an easy, automated way to add cross-mod integrations.

Instead of hardcoding compat logic or manually managing data packs, Compat API handles everything for you: auto-loading compat code, injecting data packs, wrapping loot modifiers, applying conditions, and enabling integrations only when the required mods are installed.

📃 Features

  • Smart Compat Scanner: Loads integrations only from mods that explicitly depend on Compat API.
  • Automatic Compat Code Loading: Detects compat modules in net.<owner>.<moid>.compats.<target> and runs their register, init, or bootstrap hooks automatically.
  • Automatic Data Pack Injection: Loads content from data/<owner>/<modid>/compats/<target> as built-in data packs — only when the target mod exists.
  • Universal Loot Modifier System: Adds compat conditions automatically and generates the global loot modifier list.
  • Compatibility Conditions: Built-in condition compatapi:compat_enabled ensures integrations load safely and only when appropriate.
  • Per-Target Config Toggles: Every compat module can be enabled or disabled individually via config.
  • Safe & Clean System: Compat errors never crash the game — they’re logged and gracefully skipped.

📝 Description

How it works:

You install Compat API. That’s it.

If a mod depends on Compat API and includes compat modules, the API will:

  • detect its compat code
  • inject its compat data packs
  • wrap its loot modifiers
  • apply conditions
  • and enable integrations automatically

If the target mod is missing — the compat simply won’t load. No errors, no crashes, no manual setup needed. Mods can freely add compat folders and classes — Compat API does all the heavy lifting. And of course, every integration can be toggled via config.

🎁 Bonus Info

  • Mods that do not depend on Compat API are fully ignored
  • All integrations load only when their target mods are present
  • Errors in compat code never break the game
  • Fully automated system: code, data packs, conditions, loot modifiers
  • Supports thousands of integrations with minimal boilerplate

🧾 Credits

Compat API is developed by fixerlink as a universal standard for all Compat-series mods and for developers who want clean, modular, and automated cross-mod integrations.

Feedback is welcome!