Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Creators-of-Create/Create/llms.txt

Use this file to discover all available pages before exploring further.

Create exposes a stable Java API under the com.simibubi.create.api package that addon mods can use to extend its systems — movement behaviours, fan processing, contraption storage, stress values, recipes, and more. The API is designed to be consumed by third-party mods targeting NeoForge and covers nearly every point where Create’s behaviour can be customised or augmented.

Adding Create as a dependency

Add Create to your build.gradle repositories and dependencies blocks. Always use the version that matches your target Minecraft and NeoForge versions. The slim classifier excludes runtime assets you don’t need at compile time.
build.gradle
repositories {
    maven { url = "https://maven.createmod.net" }
}

dependencies {
    // Create for NeoForge — use the version matching your target Minecraft/NeoForge
    implementation("com.simibubi.create:create-1.21.1:6.0.11:slim") { transitive = false }
}
The current stable release is 6.0.11 targeting Minecraft 1.21.1 with NeoForge 21.1.219. Check maven.createmod.net for the latest versions. NeoForge projects use NeoGradle — the fg.deobf() wrapper from old ForgeGradle is not needed.

API package structure

All public API lives under com.simibubi.create.api. The package is divided into focused sub-packages:
PackagePurpose
api/behaviour/Display sources/targets, movement behaviour, spouting behaviour
api/boiler/Boiler heater registration
api/connectivity/ConnectivityHandler for multi-block fluid/tank groups
api/contraption/BlockMovementChecks, ContraptionType, mounted storage types
api/data/Recipe providers and data map helpers
api/effect/Open pipe effect handlers
api/equipment/Goggle overlays, potato cannon projectile types
api/event/NeoForge events fired by Create
api/registry/CreateRegistries, CreateBuiltInRegistries, SimpleRegistry
api/schematic/Schematic requirement registries, NBT safety checks
api/stress/BlockStressValues for stress capacity and consumption

Stability policy

Classes inside com.simibubi.create.api are considered public API. Create follows semantic versioning for these classes — breaking changes will be communicated in advance and are avoided between minor releases.
Classes inside com.simibubi.create.impl and com.simibubi.create.infrastructure are internal implementation details. They may change or be removed without notice between any release. Do not depend on them in your addon.

Where to go next

Registries

Use NeoForge’s DeferredRegister with Create’s ResourceKey constants to register fan processing types, arm interaction points, display link handlers, and more.

Events

Subscribe to NeoForge events fired by Create — attach block entity behaviours, intercept fluid pipe collisions, and respond to train graph merges.

Custom Movement Behaviours

Give any block custom actions while it rides a Create contraption by implementing and registering a MovementBehaviour.

Block Movement Checks

Control whether blocks can be picked up, moved within, or attached to contraptions during assembly.

Fan Processing Types

Register custom in-world processing effects that industrial fans apply to items and entities.

Contraption Storage

Define how item and fluid inventories are mounted onto and synced with moving contraptions.

Stress Values

Register stress capacity and consumption values for custom kinetic blocks.

Custom Recipes

Add new recipe types compatible with Create’s processing pipeline and JEI/REI integration.

Build docs developers (and LLMs) love