# 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[axis=y]) | | **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 [dir]` | Expand selection | | `/selcontract [dir]` | Contract selection | | `/pos1` | Set first position | | `/pos2` | Set second position | ### Block Operations | Command | Description | |---|---| | `/set [mask]` | Fill selection | | `/replace ` | Replace matching blocks | | `/walls [mask]` | Fill 4 walls | | `/floor [mask]` | Fill floor | | `/ceil [mask]` | Fill ceiling | | `/box [mask]` | Hollow box outline | | `/hollow [pattern] [mask]` | Clear interior | | `/smooth [n]` | Smooth terrain | | `/drain` | Remove water & lava | | `/setdir [-r]` | Place in facing direction | ### Shapes | Command | Description | |---|---| | `/sphere [-h]` | Sphere at feet | | `/cyl [-h]` | Cylinder at feet | | `/pyramid [-h]` | Pyramid at feet | | `/line [mask]` | 3D line pos1→pos2 | ### Terrain | Command | Description | |---|---| | `/terrace [pat]` | Quantize terrain into terraces | | `/erode [n] [threshold]` | Remove isolated blocks | | `/overgrow [density] [mat]` | Scatter vegetation | | `/rubble [pat] [density]` | Noise-driven ruins | | `/crumble [mask]` | Random block removal | ### Clipboard | Command | Description | |---|---| | `/copy` | Copy selection | | `/paste [-a]` | Paste at position (`-a` = skip air) | | `/rotate ` | Rotate any angle (45, 90, 135…) | | `/flip ` | Flip clipboard | ### Brushes | Command | Description | |---|---| | `/brush [opts]` | 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 ` | 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 | | `simplex` | Smooth detail, no axis artifacts | | `voronoi` | Cracked stone, tiles | | `worley` | Organic cell borders | | `ridged` | Mountain ridges, peaks | | `fbm` | Complex layered terrain | ## 🎭 Mask Syntax ``` #existing — non-air blocks only #air — air only #solid — solid blocks #liquid — water or lava #surface — exposed top surface #floor — air above, solid below !stone — everything except stone stone;dirt — stone OR dirt (semicolon = OR) #existing,!stone — existing AND not stone (comma = AND) %50 — random 50% of blocks noise(perlin,0.05)>0.5 ``` ## 🎨 Pattern Syntax ``` stone — single block 30%stone,70%dirt — random weighted mix oak_log[axis=y] — with block data 50%stone,30%cobblestone,20%andesite ``` ## ⚙️ Configuration (`config.yml`) ```yaml language: en # en, fr, or custom max-history-size: 15 # undo steps per player max-blocks-per-operation: 0 # 0 = unlimited selection-particles: true ``` ## 🌍 Adding a Language 1. Create `plugins/MBuild/lang/de.yml` (copy from `en.yml`) 2. Translate all values 3. Set `language: de` in `config.yml` 4. Reload the server ## 🔐 Permissions | Permission | Description | Default | |---|---|---| | `mbuild.*` | All permissions | op | | `mbuild.selection` | Selection tools | op | | `mbuild.set` | /set | op | | `mbuild.replace` | /replace | op | | `mbuild.shape` | /sphere /cyl /pyramid /line | op | | `mbuild.terrain` | /erode /overgrow /rubble etc. | op | | `mbuild.brush` | /brush | op | | `mbuild.gmask` | /gmask | op | | `mbuild.info` | /count /distr | op | | `mbuild.copy` | /copy | op | | `mbuild.paste` | /paste | op | | `mbuild.clipboard` | /rotate /flip | op | | `mbuild.undo` | /undo | op | | `mbuild.redo` | /redo | op | ## ⚠️ Compatibility - **Minecraft**: 1.18 – 1.21.x - **Server**: Spigot, Paper, Purpur - **Java**: 8+ - **WorldEdit**: Not required. Can coexist (no conflicts).

Martinouxx