A Fabric mod for Minecraft 1.21.1 that brings AI-powered 3D model generation directly into your game. Powered by fal.ai.
- ⬇️ Download Falcraft
- ⬇️ Download Fabric API
- Drop both JARs in
.minecraft/mods/ - Run
/fal setkey "YOUR_KEY"(get key here)
📖 Full installation guide | Requires Minecraft 1.21.1 + Fabric Loader
/fal generate <size> <prompt>
Examples:
/fal generate 48 medieval castle
/fal generate 64 spongebob squarepants
/fal generate 96 ancient temple
Controls in preview mode:
- Right-click - Place the structure
- G - Rotate 90°
Size guide: 16-32 (small), 48-64 (recommended), 96-128 (large/detailed)
Generation takes ~30 seconds using Z-Image + SAM-3D pipeline.
Watch structures emerge from noise in real-time!
/fal stream <size> <prompt>
Examples:
/fal stream 64 dragon statue
/fal stream 96 futuristic mech
/fal stream 80 medieval castle
Stream mode shows the SAM-3D diffusion process live - you'll see the shape form first (geometry phase), then colors appear (appearance phase). Powered by Manifold, a real-time 3D streaming pipeline built on fal Serverless.
Controls:
- G - Rotate during preview
- Right-click - Place when complete
/fal stream cancel- Cancel generation
For UV-textured models (~7 minutes):
/fal generate legacy <size> <prompt>
-
Install Fabric Loader + Fabric API for MC 1.21.1
-
Drop the mod JAR in
.minecraft/mods/ -
Launch Minecraft and run:
/fal setkey "YOUR_API_KEY"Get your API key at fal.ai/dashboard/keys
Note: Wrap your API key in quotes to handle the special characters.
That's it! Your key is saved to config/falcraft/api-key.txt.
/fal status
Shows if your API key is configured.
This mod uses fal.ai's cloud APIs. You'll need to add credits to your account.
| Step | Model | Cost |
|---|---|---|
| 1. Text → Image | Z-Image Turbo | ~$0.005-0.008 |
| 2. Image → 3D | SAM-3D Objects | $0.02 (flat) |
| 3. Prompt fix* | OpenRouter Vision | ~$0.001 |
Total: ~$0.025-0.03 per generation (regardless of Minecraft size)
*Only triggered when the 3D segmentation fails on complex/abstract prompts
- Z-Image Turbo generates a 2D image from your prompt
- SAM-3D converts the image to a 3D GLB model with vertex colors
- Voxelizer converts the mesh to Minecraft blocks using triangle-voxel intersection
- Block Mapper matches colors using CIE-LAB perceptual color space (100+ block palette)
- Ghost Preview shows the structure before placement
- Animated Build places blocks layer-by-layer
- "API key not configured" - Run
/fal setkey "YOUR_KEY"(with quotes) or check with/fal status - 403 error - Your fal.ai account needs credits. Add billing here
- Structure not visible - Look where you want to place (up to 200 blocks away)
- Colors look off - The 100+ block palette maps colors as close as Minecraft allows
CC0 1.0 - Public domain. Use freely!