Create exposes a stable Java API under theDocumentation 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.
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 yourbuild.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
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 undercom.simibubi.create.api. The package is divided into focused sub-packages:
| Package | Purpose |
|---|---|
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.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.