VoxelBuilder

Transform your favorite 3D models into magnificent Minecraft structures with precision voxelization and intelligent block placement.

## Features

### Professional STL Voxelization
– Surface-accurate conversion using Separating Axis Theorem (SAT)
– Preserves fine details that other voxelizers miss
– Supports both ASCII and Binary STL formats
– Smart scaling to fit any model size

### Intelligent Build System
– Server-authoritative placement – perfect for multiplayer
– Tick-budget management prevents server lag
– Two-phase construction: Building + Interior Lighting
– Configurable performance settings

### Interior Lighting (Unique!)
– Automatically lights hollow interiors to prevent mob spawning
– Smart enclosed-air detection
– Fully configurable spacing and search radius

### Easy to Use
1. Craft the Voxel Builder Controller
2. Right-click to open GUI
3. Select your STL file
4. Preview with real-time rotation
5. Place anchor and watch it build!

### Server-Safe
– Distance limits and dimension locks
– Per-player and global build limits
– Configurable extent caps
– Admin commands for monitoring

## How to Use

### Crafting Recipe
“`
I R I
R C R
I R I
“`
– I = Iron Ingot
– R = Redstone
– C = Comparator

### Basic Workflow
1. Place the Voxel Builder Controller block
2. Right-click to open the GUI
3. Load an STL file from `.minecraft/voxelbuilder/models/`
4. Customize rotation and detail level
5. Click “Place Build” and right-click a block to set anchor
6. Watch it build automatically!

## Commands (OP Only)
– `/voxelbuilder config` – View configuration
– `/voxelbuilder status` – Check active builds
– `/voxelbuilder cancel <player>` – Cancel player’s builds
– `/voxelbuilder cancelall` – Emergency: cancel all builds

## Configuration
Server config file: `<world>/serverconfig/voxelbuilder-server.toml`

Key settings:
– `globalBlocksPerTick` (300) – Performance budget
– `lightingEnabled` (true) – Interior lighting system
– `maxDistanceFromAnchor` (96) – Grief protection
– See full config documentation on GitHub

## Requirements
– Minecraft 1.21.1
– NeoForge 21.1.211+
– Java 21+

## ATM10 Compatible
Tested and working with All The Mods 10!

## Links
– [GitHub](https://github.com/BadMuthaJeffer/VoxelBuilder)
– [Report Issues](https://github.com/BadMuthaJeffer/VoxelBuilder/issues)

—

**Created by BadMuthaJeffer**