🧠 AI Builds

Turn imagination into reality. Let AI build structures directly in your Minecraft world using Gemini or Claude.

AI Builds is a lightweight Paper/Spigot plugin that connects your server to powerful AI models and generates fully animated structures inside selected regions using simple commands.

⚙️ How it works

Players use:

 /ai build <build-name> <x1> <y1> <z1> <x2> <y2> <z2>
 

The plugin:

Sends the request to Google Gemini or Anthropic Claude AI generates a structured build plan Plugin validates and optimizes it Builds are placed block-by-block with animation.

☄ FEATURES

✔ AI-generated builds in real-time
✔ Supports Gemini & Claude APIs
✔ Region-based building system
✔ Smooth animated construction (layered building)
✔ Lightweight & optimized (no server lag design)
✔ Vanilla Minecraft block support only
✔ Smart structure scaling based on region size
✔ Safe validation system (prevents crashes & invalid builds)

🎬 Build Animation System

Structures don’t just appear — they are built live in front of players.

Supported animation styles:

layered (default bottom → top) column radial

Each build is placed gradually with tick-based pacing for smooth performance.

🧠 AI Build Types

The AI automatically understands build intent:

• 🏰 Castle → medieval fortress with towers
• 🏠 House → modern or wooden home
• 🗼 Tower → vertical structured build
• ⚔️ Arena → PvP combat zone
• ⛩️ Temple → symmetric decorative structure
• 🚀 Futuristic → clean quartz + glass builds

🔌 Supported AI Providers

✔ Google Gemini (recommended fast mode)
✔ Anthropic Claude (high-quality builds)

🧩 Example

/ai build castle 100 64 100 130 90 130

Result: A fully generated medieval castle appears, built live with animation inside your region.

🚫 Safety System

The plugin automatically prevents:

Out-of-bound block placement Invalid Minecraft block IDs Excessive block generation (lag protection) Unsupported structures (redstone/command abuse)

📦 Requirements

• Paper / Spigot 1.21+
• Java 17+
• Internet access (for AI API calls)
• Gemini or Claude API key (Paste in config)

🧠 Future Ideas (planned)

/ai build preview (ghost rendering) /ai build edit (AI modifies builds) structure saving system player style training (“learn my building style” AI) ========================================================

Copyright (c) 2026 AI Builds

ALL RIGHTS RESERVED.

This software and its source code, compiled binaries, assets, configuration files, and documentation are the exclusive property of the author.

You are NOT permitted to:

- Access, view, decompile, reverse engineer, or extract source code
- Modify, adapt, or create derivative works
<details>
<summary>Spoiler</summary>



</details>


- When you share this plugin you must credit the author via modrinth link
- Claim ownership or authorship of any part of this software
- Use this software or its code in other projects, plugins, or mods
- Sell, sublicense, or monetize this software in any form without written permission


------------------------------------------------------------
⚠️ AI SYSTEM PROTECTION:
------------------------------------------------------------

The AI system logic, prompts, and structure generation pipeline are also protected under this license and may NOT be reused, copied, or adapted for other AI-driven build systems.

------------------------------------------------------------
📡 REPORTING & ENFORCEMENT:
------------------------------------------------------------

Unauthorized distribution or violation of this license may result in:
- DMCA takedown requests
- Platform removal reports (Modrinth, GitHub, etc.)
- Legal action where applicable

------------------------------------------------------------
🧾 WARRANTY DISCLAIMER:
------------------------------------------------------------

This software is provided "AS IS", without warranty of any kind.
The author is not responsible for any damage, data loss, server crashes, or issues caused by the use of this plugin.

------------------------------------------------------------
END OF LICENSE
------------------------------------------------------------