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 <n> [dir] | Expand selection |
| /selcontract <n> [dir] | Contract selection |
| /pos1 | Set first position |
| /pos2 | Set second position |

Block Operations

| Command | Description |
|---|---|
| /set <pattern> [mask] | Fill selection |
| /replace <mask> <pattern> | Replace matching blocks |
| /walls <pattern> [mask] | Fill 4 walls |
| /floor <pattern> [mask] | Fill floor |
| /ceil <pattern> [mask] | Fill ceiling |
| /box <pattern> [mask] | Hollow box outline |
| /hollow [pattern] [mask] | Clear interior |
| /smooth [n] | Smooth terrain |
| /drain | Remove water & lava |
| /setdir <pattern> <len> [-r] | Place in facing direction |

Shapes

| Command | Description |
|---|---|
| /sphere <pat> <r> [-h] | Sphere at feet |
| /cyl <pat> <r> <h> [-h] | Cylinder at feet |
| /pyramid <pat> <h> [-h] | Pyramid at feet |
| /line <pat> [mask] | 3D line pos1→pos2 |

Terrain

| Command | Description |
|---|---|
| /terrace <step> [pat] | Quantize terrain into terraces |
| /erode [n] [threshold] | Remove isolated blocks |
| /overgrow [density] [mat] | Scatter vegetation |
| /rubble [pat] [density] | Noise-driven ruins |
| /crumble <pct> [mask] | Random block removal |

Clipboard

| Command | Description |
|---|---|
| /copy | Copy selection |
| /paste [-a] | 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> [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 <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 |
| 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)

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).