Skip to content

What is FoundryEngine?

FoundryEngine is a Minecraft mod (for NeoForge) that turns Minecraft into a game engine. It lets you add new items, blocks, recipes, mechanics, cutscenes, and even entire dimensions — without writing any Java code.

Who is this for?

You want to...FoundryEngine helps you...
Add a custom sword or food itemCreate it with a few lines of Groovy script
Build a dungeon with special rulesCreate a custom dimension and fill it with areas and stages
Make an NPC that talks to playersUse the dialogue system with branching conversation trees
Cinematic camera shotsUse the cutscene system with Bezier paths and screen effects
Gate content behind player progressUse the game stages system
Learn Minecraft modding without JavaStart here — no Java needed

How does it work?

FoundryEngine uses bundles — folders containing scripts, textures, models, and data files. You drop a bundle into a folder, run /engine reload in-game, and your content appears. No compilation, no build tools.

Each bundle uses Groovy (a scripting language that runs on Java) to define items, blocks, recipes, and behaviors. If you already know Java, you can also write Java addons.

Key concepts at a glance

ConceptWhat it does
BundleA self-contained mod packaged as a folder
Groovy ScriptA .groovy file that defines your content
BuilderA helper that creates items, blocks, recipes
EventA hook that runs code when something happens
SystemA major feature (editor, cutscenes, stages, etc.)

First steps

  1. Install FoundryEngine
  2. Create your first bundle
  3. Choose your workspace
  4. Explore the core concepts
  5. Check out examples
  6. Explore the Showcase Bundle — a full bundle demonstrating items, blocks, recipes, areas, waypoints, stages, dialogue, commands, and game sessions

FoundryEngine is a work-in-progress. Documentation may change.