falcraft - AI-Powered 3D Generation

Generate castles, characters, and any structure you can imagine from simple text prompts.

⚡ Quick Example

/fal generate 64 majestic medieval castle

Wait 30 seconds → Ghost preview appears → Press G to rotate → Right-click to place → Done!

---

⚠️ Important Information

External Service Disclosure

This mod uses fal.ai's API to generate 3D models.

What data is sent:

• Your text prompts (e.g., " majestic medieval castle")
• No world data, gameplay information, or personal data

Why external processing:

• AI generation requires powerful servers
• Results in 30 seconds
• No high-end GPU needed on your machine

Privacy: Only text prompts are transmitted. Read fal.ai's privacy policy.

Cost & API Key Requirement

This mod requires a fal.ai API key with credits.

• Sign up: https://fal.ai/dashboard/keys
• Add credits to your account (~$5-10 recommended for testing)

Exact Cost Breakdown (Per Structure)

Each generation uses this pipeline:

1. Z-Image Turbo - Generates 2D image from text

   • Cost: $0.005 per megapixel (~$0.005-$0.008 per generation)

2. SAM-3D Objects - Converts image to 3D model

   • Cost: $0.02 per generation (flat rate, any size)

3. OpenRouter Vision - Smart fallback for complex prompts. The SAM-3D step takes in the prompt you enter to generate a mask, but sometimes for complex or abstract prompts (e.g. "a Minecraft server lobby" instead of "a Minecraft build") this mask generation fails, so this step takes your prompt and makes it more literal.

   • Cost: ~$0.001 per use (only triggered when segmentation fails)

Total per structure: ~$0.025-$0.03 (regardless of Minecraft size chosen)

What $1 gets you:

• 33-40 structures of any size
• $5 = ~165 structures
• $10 = ~330 structures

About the developer: Built by the fal.ai team to showcase AI-powered creative tools. The mod itself is free and open source (CC0).

---

✨ Features

🏰 Fast Generation

• ~30 seconds using Z-Image + SAM-3D pipeline
• Legacy mode (~6 minutes, and $0.80 per generation) for 3D models with UV textures with the Meshy-6 model. E.g. /fal generate legacy 64 majestic medieval castle

🎮 Interactive Preview

• Ghost block preview before placing
• Press G to rotate 90 degrees
• Right-click to confirm placement
• Animated layer-by-layer building

🎨 Smart Block Matching

• 100+ block palette using CIE-LAB color space
• Perceptually accurate color matching
• Concrete, terracotta, wood, stone, and more

📏 Flexible Sizing

• 16-32 blocks: Small/quick builds
• 48-64 blocks: Recommended (balanced)
• 96-128 blocks: Large detailed structures
• All sizes cost the same! Pick based on detail needs, not budget

---

🚀 Setup

Step 1: Get Your API Key

1. Go to https://fal.ai/dashboard/keys
2. Sign up for a free account
3. Add credits ($5-10 recommended for testing)
4. Generate your API key

Step 2: Configure In-Game

1. Launch Minecraft (Fabric 1.21.1)
2. Join any world
3. Run (with quotes!): /fal setkey "your-api-key-here"

Step 3: Generate!

/fal generate 48 Son Goku
/fal generate 64 Willy Wonka's chocolate factory
/fal generate 96 grand ice castle

---

📋 Requirements

• Minecraft: 1.21.1
• Fabric Loader: 0.18.1 or newer, set Minecraft version to 1.21.1
• Fabric API: 0.116.7+1.21.1 or newer
• fal.ai Account: With credits

---

🐛 Troubleshooting

"API key not configured"

• Run /fal setkey "your-key" with quotes
• Check with /fal status

"Could not execute entrypoint"

• Make sure you have Minecraft 1.21.1 (not 1.21.10 or other versions)
• Verify Fabric API version matches +1.21.1

Structure not visible

• Look where you want to place (up to 200 blocks away)
• Try moving to a different location

Colors look off

• The 100+ block palette matches colors as close as Minecraft allows
• Try the legacy mode for UV-textured results

---

🔗 Links

• Source Code: GitHub
• Issues: Report bugs
• Get API Key: fal.ai Dashboard
• API Docs: Z-Image | SAM-3D

---

📜 License

CC0 1.0 - Public Domain. Free to use, modify, and distribute!

---

🙏 Credits

Built with Fabric and fal.ai.

---

Note: This is a creative tool for Minecraft builders. The mod itself is completely free and open source. It uses fal.ai's paid API services (Z-Image Turbo, SAM-3D Objects) to function, with per-generation pricing.