How to Use VoxelSniper for Terrain Editing in Minecraft
Complete VoxelSniper Minecraft tutorial covering installation, brush types, terrain sculpting, erosion tools, and best practices for natural-looking landscapes on Paper 1.21+.
WorldEdit is the go-to for placing and removing blocks in bulk, but it was never designed for organic terrain. Mountains, rivers, cliffs, and caves require a different tool, one that sculpts rather than stamps. VoxelSniper fills that role. This VoxelSniper Minecraft tutorial walks through installation, core concepts, the most useful brushes, and techniques for creating terrain that looks natural rather than generated.
What VoxelSniper does
VoxelSniper gives you a set of "brushes" that modify terrain in a radius around where you aim. Think of it as a 3D painting tool: you point, click, and the landscape changes. Brushes range from simple sphere placements to erosion algorithms that weather cliffs and smooth coastlines. Combined with WorldEdit for large-scale operations, VoxelSniper handles the detail work that makes a world feel hand-crafted.
Installation
The modern maintained fork for Paper 1.21+ is FastAsyncVoxelSniper, bundled with FAWE, or the standalone VoxelSniper Reimagined on Hangar/SpigotMC.
- Download the plugin JAR from SpigotMC or Hangar.
- Drop it into your
plugins/folder. - Restart the server (not reload, VoxelSniper registers commands at startup).
- Grant yourself the
voxelsniper.sniperpermission or useop.
Confirm installation with /vs info in-game. You should see the plugin version and your current brush settings.
Core concepts
The arrow and gunpowder
VoxelSniper uses two items as tools:
- Arrow, the primary action. Right-click fires the brush at the block you are looking at.
- Gunpowder, the secondary action, usually the inverse or a variant of the primary.
Brush size
Set the radius with /b [size]. A size of 5 means the brush affects a sphere with a 5-block radius. Start small, it is much easier to build up than to undo a massive edit. This is one of the first things to learn in any VoxelSniper Minecraft tutorial.
Block type
Set the material you are painting with:
/v grass_block
/vr dirt
/v sets the primary (arrow) material, /vr sets the replace (gunpowder) material.
Essential brushes
Ball brush (/b b)
The simplest brush, places a solid sphere of the selected block. Use the arrow to place, gunpowder to remove (replace with air). Great for roughing out mountain shapes before detailing.
Disc brush (/b d)
Places a flat disc. Useful for paths, plateaus, and leveling areas. Combine with height variations for terraced landscapes.
Blend ball (/b bb)
Smooths transitions between block types by averaging neighbors. Run this over rough terrain to create natural gradients, stone blending into gravel blending into dirt blending into grass. This is a must-have in any VoxelSniper Minecraft tutorial focused on natural terrain.
Erosion brush (/b e)
The most powerful brush for realism. Erosion simulates weathering by removing exposed blocks (melt) and filling gaps (fill). The sub-parameters control intensity:
/b e melt # removes exposed blocks, carves cliffs
/b e fill # fills in gaps, smooths terrain
/b e smooth # combination of melt + fill
/b e lift # raises terrain naturally
Apply melt to cliff faces to create overhangs, then fill to soften edges. Repeat in passes, subtle, repeated strokes look better than one heavy pass.
Overlay brush (/b over)
Applies a layer of blocks on top of existing terrain. Perfect for adding grass on top of dirt, snow on mountains, or sand along coastlines. Set the depth with /b over d3 for a 3-block-deep layer.
Terrain sculpting workflow
- Block out, use the ball brush at size 15-20 to rough out the overall mountain or valley shape. Do not worry about detail.
- Shape, switch to size 8-12 and refine ridgelines, valleys, and slopes. Vary your angles, real terrain is not symmetrical.
- Erode, run the erosion brush (melt) along cliff faces and peaks. Switch to smooth for gentle slopes.
- Blend, use blend ball to transition between stone, dirt, and grass. Nature does not have hard block-type boundaries.
- Detail, switch to size 2-4 and add individual features: rock outcrops, small caves, path wear patterns.
- Overlay, apply grass, snow, or sand layers where appropriate.
- Vegetation, place custom trees and bushes using schematics or manual placement.
Performance tips
- Use FAWE alongside VoxelSniper to offload block changes to async threads.
- Keep brush sizes under 20 for real-time editing. Anything larger should be done with WorldEdit selections.
- Work during off-peak hours on live servers, terrain edits send chunk updates to every nearby player.
- Save
//copysnapshots frequently so you can//undoback to a known-good state.
Common mistakes
- Brush too large, oversized brushes create blobby, unnatural shapes. Reduce the size and make more passes.
- Symmetrical terrain, nature is asymmetric. Vary your brush position, angle, and size constantly.
- Single block type, real terrain has layers. Mix stone variants, coarse dirt, gravel, and andesite for depth.
- Forgetting to blend, sharp transitions between grass and stone look artificial. Always finish with a blend pass.
VoxelSniper is a deep tool with dozens of brushes beyond what this VoxelSniper Minecraft tutorial covers, but mastering the five listed here handles 90% of terrain work. Pair it with WorldEdit for structural edits and WorldGuard to protect your finished landscapes.
Want to see a polished server in action? Astroworld MC , IP play.astroworldmc.com, Java + Bedrock.