## 🎉 Welcome to the Era of Vibebuilding! This update marks a massive shift for **McTo3D**. We are moving from just exporting builds to **generating them**. With v0.2.0, I am introducing **Text-to-Minecraft** capabilities, powered by the **Trellis** model. You can now visualize massive structures, generate ideas, and spawn 3D assets directly into your world using simple text prompts. > **⚠️ POC Warning:** This AI feature is currently a **Proof of Concept (V1)**. > The voxelization and block selection algorithms are experimental. Expect some "washed out" colors or rough geometry as we refine the translation from 3D Mesh to Minecraft Blocks. --- ## ✨ What's New in v0.2.1? ### 🤖 AI Generation (Text-to-3D) Generate 3D models directly in-game using the power of Generative AI. * **Command:** `/import3d ai <scale> <prompt>` * **Example:** `/import3d ai 200 a massive red japanese pagoda` * **Engine:** Uses **Nvidia's Trellis API** to generate geometry from scratch in real-time. ### 🔑 API Key Integration To use the AI features, you need to link your own API key (Free). * **Command:** `/mcto3d apikey <your_key_here>` * **Security:** Your key is stored locally in the config. * Adding a log system to understand API errors --- ## 📥 Installation & Setup Guide (New!) 1. **Download & Install:** Drop the `.jar` into your `mods` folder (Requires Fabric API). 2. **Get your Free Key:** * Go to **[build.nvidia.com](https://build.nvidia.com)**. * Search for "Trellis" or browse the AI catalog. * Click "Get API Key" (it's free). 3. **Activate in-game:** * Run `/mcto3d apikey nvapi-xxxxx...` 4. **Start Vibebuilding:** * Run `/import3d ai 150 a futuristic cyberpunk tower` --- ## 🔮 Roadmap & Known Issues This is an early beta for the AI features. Here is what I am working on for the next patches: * **🎨 Better Voxelization:** Currently, the block color selection can be desaturated (the "copper/gray" issue). I am working on a better algorithm to map 3D colors to a wider range of Minecraft blocks. * **🧱 Detail Preservation:** Improving how the mod handles fine details (fences, walls) at smaller scales. * **⚡ Local Inference:** Researching possibilities to run models locally for users with high-end GPUs. --- ## 🐛 Feedback Found a bug or have a suggestion for the block mapping? Please open an issue in the **Issues** tab. **Happy Vibebuilding! 🧱✨**

## Initial Release: McTo3D This is the first public release of McTo3D. This mod turns Minecraft into a powerful CAD tool for 3D printing. Whether you want a raw mesh for sculpting or a full-color export for your AMS, we got you covered. ### Key Features #### 1. Intuitive Selection Tools Select the area you want to print easily using two methods: * **The "Golden Hoe" Wand:** * **Left Click:** Set Position 1 * **Right Click:** Set Position 2 * **Commands:** * Use `/pos1` and `/pos2` at your feet coordinates. #### 2. Selection Manipulation Adjust your selection height without moving: * **Command:** `/expand <value>` * **Usage:** * `/expand 10` (Expands the selection UP by 10 blocks) * `/expand -5` (Expands the selection DOWN by 5 blocks) #### 3. Export Formats Ready to print? Use the command: * **Command:** `/export3d` * **Modes:** * **Raw Mode:** Exports the pure geometry (perfect for painting in slicer or editing in Blender). * **Color Mode:** Exports with color data (optimized for Bambu Lab AMS and multi-color printers). --- ### How to use 1. Equip a **Golden Hoe**. 2. Select your build corners (Left/Right click). 3. Type `/export3d`. 4. Find the file in your `.minecraft/exports` folder. 5. Slice and print! 🖨️ *Found a bug? Join the community or report it on the issues page!*