Essential hooks for modding with Fabric.
Find a file
Jonathan Coates 40630eedb6 Load modded translations on the server (#2668)
* Load modded translations on the server

* Don't load built-in mods

(cherry picked from commit 1f9b83131f)
2022-11-20 13:45:30 +00:00
.github Add publish checkstyle report action (#2514) 2022-09-09 12:45:06 +01:00
deprecated Update mappings 2022-11-16 16:12:51 +00:00
fabric-api-base Fix many javadoc issues (#2526) 2022-09-25 14:45:12 +01:00
fabric-api-lookup-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-biome-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-block-api-v1 Add a block appearance API (#2579) 2022-11-07 18:29:51 +00:00
fabric-blockrenderlayer-v1 Cleanup incorrect mixin shadow annotations/access 2022-09-25 14:46:29 +01:00
fabric-client-tags-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-command-api-v2 Update mappings 2022-11-16 16:12:51 +00:00
fabric-content-registries-v0 Update mappings 2022-11-16 16:12:51 +00:00
fabric-convention-tags-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-crash-report-info-v1 Rename and validate Mixin class names. (#2450) 2022-08-15 18:59:19 +01:00
fabric-data-generation-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-dimensions-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-entity-events-v1 22w46a 2022-11-16 16:15:34 +00:00
fabric-events-interaction-v0 Cleanup incorrect mixin shadow annotations/access 2022-09-25 14:46:29 +01:00
fabric-game-rule-api-v1 22w44a (#2632) 2022-11-03 13:48:27 +00:00
fabric-gametest-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-item-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-item-group-api-v1 22w46a 2022-11-16 16:15:34 +00:00
fabric-key-binding-api-v1 Change test LSHIFT keybind to RSHIFT (#2580) 2022-10-16 15:11:43 +01:00
fabric-lifecycle-events-v1 22w46a 2022-11-16 16:15:34 +00:00
fabric-loot-api-v2 22w42a 🐫 (#2599) 2022-10-22 20:38:33 +01:00
fabric-message-api-v1 Message API: update javadoc for 22w42a (#2605) 2022-10-28 18:26:52 +01:00
fabric-mining-level-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-models-v0 22w43a (#2610) 2022-10-26 20:48:38 +01:00
fabric-networking-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-object-builder-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-particles-v1 22w46a 2022-11-16 16:15:34 +00:00
fabric-registry-sync-v0 Update mappings 2022-11-16 16:12:51 +00:00
fabric-renderer-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-renderer-indigo 22w43a (#2610) 2022-10-26 20:48:38 +01:00
fabric-rendering-data-attachment-v1 Add a block appearance API (#2579) 2022-11-07 18:29:51 +00:00
fabric-rendering-fluids-v1 22w46a 2022-11-16 16:15:34 +00:00
fabric-rendering-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-resource-conditions-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-resource-loader-v0 Load modded translations on the server (#2668) 2022-11-20 13:45:30 +00:00
fabric-screen-api-v1 Fixed ScreenEvents Javadoc (#2618) 2022-11-20 13:24:19 +00:00
fabric-screen-handler-api-v1 Update mappings 2022-11-16 16:12:51 +00:00
fabric-sound-api-v1 22w42a 🐫 (#2599) 2022-10-22 20:38:33 +01:00
fabric-transfer-api-v1 Fix shulker boxes accepting other shulkers when using a directionless InventoryStorage (#2669) 2022-11-20 13:45:06 +00:00
fabric-transitive-access-wideners-v1 Update mappings 2022-11-16 16:12:51 +00:00
gradle Rename modid to "fabric-api" and provide "fabric". Update loom (#2446) 2022-08-06 19:05:38 +01:00
src 22w42a 🐫 (#2599) 2022-10-22 20:38:33 +01:00
.editorconfig Update .editorconfig (#1830) 2021-11-16 12:48:32 +00:00
.gitattributes 22w19a 2022-05-12 21:58:35 +01:00
.gitignore Fix #1273 (Make MultipartBakedModel and WeightedBackedModel implement FabricBakedModel properly) (#1301) 2021-06-10 14:09:00 +02:00
build.gradle Update Gson javadoc link (#2664) 2022-11-20 13:18:57 +00:00
checkstyle.xml 22w42a 🐫 (#2599) 2022-10-22 20:38:33 +01:00
CONTRIBUTING.md Add development guidelines (CONTRIBUTING.md) (#2377) 2022-07-29 18:30:02 +01:00
gradle.properties Fix prod client crash in fabric-screen-api-v1 2022-11-16 17:14:08 +00:00
gradlew Update Loom and Loader. Cleanup/improve buildscript. 2021-11-12 15:02:54 +00:00
gradlew.bat Move deprecated modules, create own maven BOM for the deprecated modules. (#2171) 2022-05-01 15:44:16 +01:00
HEADER Move deprecated modules, create own maven BOM for the deprecated modules. (#2171) 2022-05-01 15:44:16 +01:00
LICENSE first commit - resource pack hook and little else 2018-11-05 15:54:18 +01:00
README.md Add development guidelines (CONTRIBUTING.md) (#2377) 2022-07-29 18:30:02 +01:00
settings.gradle 22w46a 2022-11-16 16:15:34 +00:00

Fabric API

Essential hooks for modding with Fabric.

Fabric API is the library for essential hooks and interoperability mechanisms for Fabric mods. Examples include:

  • Exposing functionality that is useful but difficult to access for many mods such as particles, biomes and dimensions
  • Adding events, hooks and APIs to improve interopability between mods.
  • Essential features such as registry synchronization and adding information to crash reports.
  • An advanced rendering API designed for compatibility with optimization mods and graphics overhaul mods.

Also check out Fabric Loader, the (mostly) version-independent mod loader that powers Fabric. Fabric API is a mod like any other Fabric mod which requires Fabric Loader to be installed.

For support and discussion for both developers and users, visit the Fabric Discord server.

Using Fabric API to play with mods

Make sure you have install fabric loader first. More information about installing Fabric Loader can be found here.

To use Fabric API, download it from CurseForge, GitHub Releases or Modrinth.

The downloaded jar file should be placed in your mods folder.

Using Fabric API to develop mods

To setup a Fabric development environment, check out the Fabric example mod and follow the instructions there. The example mod already depends on Fabric API.

To include the full Fabric API with all modules in the development environment, add the following to your dependencies block in the gradle buildscript:

Groovy DSL

modImplementation "net.fabricmc.fabric-api:fabric-api:FABRIC_API_VERSION"

Kotlin DSL

modImplementation("net.fabricmc.fabric-api:fabric-api:FABRIC_API_VERSION")

Alternatively, modules from Fabric API can be specified individually as shown below (including module jar to your mod jar):

Groovy DSL

// Make a collection of all api modules we wish to use
Set<String> apiModules = [
    "fabric-api-base",
    "fabric-command-api-v1",
    "fabric-lifecycle-events-v1",
    "fabric-networking-api-v1"
]

// Add each module as a dependency
apiModules.forEach {
    include(modImplementation(fabricApi.module(it, FABRIC_API_VERSION)))
}

Kotlin DSL

// Make a set of all api modules we wish to use
setOf(
    "fabric-api-base",
    "fabric-command-api-v1",
    "fabric-lifecycle-events-v1",
    "fabric-networking-api-v1"
).forEach {
    // Add each module as a dependency
    modImplementation(fabricApi.module(it, FABRIC_API_VERSION))
}

Instead of hardcoding version constants all over the build script, Gradle properties may be used to replace these constants. Properties are defined in the gradle.properties file at the root of a project. More information is available here.

Contributing

See something Fabric API doesn't support, a bug or something that may be useful? We welcome contributions to improve Fabric API. Make sure to read the development guidelines.

Modules

Fabric API is designed to be modular for ease of updating. This also has the advantage of splitting up the codebase into smaller chunks.

Each module contains its own README.md* explaining the module's purpose and additional info on using the module.

* The README for each module is being worked on; not every module has a README at the moment