MBuild

# MBuild > A powerful, feature-rich building plugin for Minecraft servers. Compatible with **Minecraft 1.18 → 1.21.x** (Spigot/Paper). No WorldEdit required. No dependencies. Drop in and build. ## ✨ Feature | Category | Features | |---|---| | **Selection** | Wand tool, pos1/pos2, expand, contract, info | | **Block Operations** | set, replace, walls, floor, ceil, box, hollow, smooth, drain | | **Shapes** | sphere, cylinder, pyramid, 3D Bresenham line | | **Terrain** | terrace, erode, overgrow, rubble, crumble | | **Clipboard** | copy, paste (-a), rotate (any angle), flip (x/y/z) | | **Movement** | stack, move | | **Brushes** | 15 brush types — sphere, cyl, smooth, erode, melt, raise, lower, flatten, snow, gravity, paint, scatter, splatter, cliff, overlay | | **Masks** | #existing, #air, #solid, #liquid, #surface, #floor, material, !, %, noise(...) | | **Noise Masks** | Perlin, Simplex, Voronoi, Worley, Ridged, FBM — all with configurable scale + octaves | | **Patterns** | Single block, weighted mix (30%stone,70%dirt), BlockData (oak_log) | | **Global Mask** | /gmask — persistent mask applied to ALL operations | | **History** | Unlimited multi-level undo/redo per player (configurable) | | **Multilingual** | lang/en.yml + lang/fr.yml, fully customizable | | **Statistics** | /count, /distr — block distribution analysis | ## 🚀 Quick Start 1. Drop `MBuild.jar` into your `plugins/` folder 2. Start your server — `plugins/MBuild/` is created automatically 3. Run `/seltool` to get your selection wand 4. Left-click → Pos1, Right-click → Pos2 5. Run `/set stone` — you're building! ## 📦 Commands Overview ### Selection | Command | Description | |---|---| | `/seltool` | Get the selection wand | | `/selinfo` | Show current selection info | | `/selexpand <n> ` | Expand selection | | `/selcontract <n> ` | Contract selection | | `/pos1` | Set first position | | `/pos2` | Set second position | ### Block Operations | Command | Description | |---|---| | `/set <pattern> ` | Fill selection | | `/replace <mask> <pattern>` | Replace matching blocks | | `/walls <pattern> ` | Fill 4 walls | | `/floor <pattern> ` | Fill floor | | `/ceil <pattern> ` | Fill ceiling | | `/box <pattern> ` | Hollow box outline | | `/hollow ` | Clear interior | | `/smooth ` | Smooth terrain | | `/drain` | Remove water & lava | | `/setdir <pattern> <len> ` | Place in facing direction | ### Shapes | Command | Description | |---|---| | `/sphere <pat> <r> ` | Sphere at feet | | `/cyl <pat> <r> <h> ` | Cylinder at feet | | `/pyramid <pat> <h> ` | Pyramid at feet | | `/line <pat> ` | 3D line pos1→pos2 | ### Terrain | Command | Description | |---|---| | `/terrace <step> ` | Quantize terrain into terraces | | `/erode ` | Remove isolated blocks | | `/overgrow ` | Scatter vegetation | | `/rubble ` | Noise-driven ruins | | `/crumble <pct> ` | Random block removal | ### Clipboard | Command | Description | |---|---| | `/copy` | Copy selection | | `/paste ` | Paste at position (`-a` = skip air) | | `/rotate <angle>` | Rotate any angle (45, 90, 135…) | | `/flip <x\|y\|z>` | Flip clipboard | ### Brushes | Command | Description | |---|---| | `/brush <type> <r> ` | Bind brush to held item | | `/brush info` | Show current brush | | `/brush unbind` | Remove brush | | `/brush list` | List all bound brushes | ### Masks & Global Mask | Command | Description | |---|---| | `/gmask <mask>` | Set global mask for all ops | | `/gmask reset` | Clear global mask | ### Statistics | Command | Description | |---|---| | `/count` | Count block types in selection | | `/distr` | Show block distribution % | ### History | Command | Description | |---|---| | `/undo` | Undo last operation | | `/redo` | Redo last operation | ## 🎭 Brush Types | Type | Effect | |---|---| | `sphere` | Fill a sphere on right-click | | `cylinder` | Fill a cylinder on right-click | | `smooth` | Smooth terrain in brush radius | | `erode` | Remove isolated blocks | | `melt` | Drop overhanging blocks | | `raise` | Raise surface by 1 block | | `lower` | Remove top surface layer | | `flatten` | Flatten to clicked Y level | | `snow` | Add snow layers on surface | | `gravity` | Drop blocks to ground | | `paint` | Paint surface only (no digging) | | `scatter` | Randomly scatter blocks | | `splatter` | Noise-clustered block scatter | | `cliff` | Snap heights to stair-steps | | `overlay` | Paint N layers from surface down | ## 🔊 Noise Masks ``` /gmask noise(perlin,0.05)>0.5 # perlin noise above 0.5 /set stone noise(simplex,0.08)<0.4 # simplex below 0.4 /set dirt noise(fbm,0.04,6)>0.45 # 6-octave FBM /set gravel noise(voronoi,0.1)>0.6 # cracked rock pattern /set stone noise(ridged,0.05,4)>0.7 # mountain ridges /set cobblestone noise(worley,0.1)>0.5 # organic borders ``` | Type | Best For | |---|---| | `perlin` | Natural terrain variation | | `s