blog/world_edit/index.html (view raw)
1<!DOCTYPE html>
2<html>
3<head>
4<meta charset="utf-8" />
5<meta name="viewport" content="width=device-width, initial-scale=1" />
6<title>WorldEdit Commands</title>
7<link rel="stylesheet" href="../css/style.css">
8</head>
9<body>
10<main>
11<h1 class="title" id="worldedit_commands"><a class="anchor" href="#worldedit_commands">¶</a>WorldEdit Commands</h1>
12<div class="date-created-modified">2018-07-11</div>
13<p><a href="https://dev.bukkit.org/projects/worldedit">WorldEdit</a> is an extremely powerful tool for modifying entire worlds within <a href="https://minecraft.net">Minecraft</a>, which can be used as either a mod for your single-player worlds or as a plugin for your <a href="https://getbukkit.org/">Bukkit</a> servers.</p>
14<p>This command guide was written for Minecraft 1.12.1, version <a href="https://dev.bukkit.org/projects/worldedit/files/2460562">6.1.7.3</a>, but should work for newer versions too. All WorldEdit commands can be used with a double slash (<code>//</code>) so they don't conlict with built-in commands. This means you can get a list of all commands with <code>//help</code>. Let's explore different categories!</p>
15<h2 id="movement"><a class="anchor" href="#movement">¶</a>Movement</h2>
16<p>In order to edit a world properly you need to learn how to move in said world properly. There are several straightforward commands that let you move:</p>
17<ul>
18<li><code>//ascend</code> goes up one floor.</li>
19<li><code>//descend</code> goes down one floor.</li>
20<li><code>//thru</code> let's you pass through walls.</li>
21<li><code>//jumpto</code> to go wherever you are looking.</li>
22</ul>
23<h2 id="information"><a class="anchor" href="#information">¶</a>Information</h2>
24<p>Knowing your world properly is as important as knowing how to move within it, and will also let you change the information in said world if you need to.</p>
25<ul>
26<li><code>//biomelist</code> shows all known biomes.</li>
27<li><code>//biomeinfo</code> shows the current biome.</li>
28<li><code>//setbiome</code> lets you change the biome.</li>
29</ul>
30<h2 id="blocks"><a class="anchor" href="#blocks">¶</a>Blocks</h2>
31<p>You can act over all blocks in a radius around you with quite a few commands. Some won't actually act over the entire range you specify, so 100 is often a good number.</p>
32<h3 id="filling"><a class="anchor" href="#filling">¶</a>Filling</h3>
33<p>You can fill pools with <code>//fill water 100</code> or caves with <code>//fillr water 100</code>, both of which act below your feet.</p>
34<h3 id="fixing"><a class="anchor" href="#fixing">¶</a>Fixing</h3>
35<p>If the water or lava is buggy use <code>//fixwater 100</code> or <code>//fixlava 100</code> respectively.</p>
36<p>Some creeper removed the snow or the grass? Fear not, you can use <code>//snow 10</code> or <code>//grass 10</code>.</p>
37<h3 id="emptying"><a class="anchor" href="#emptying">¶</a>Emptying</h3>
38<p>You can empty a pool completely with <code>//drain 100</code>, remove the snow with <code>//thaw 10</code>, and remove fire with <code>//ex 10</code>.</p>
39<h3 id="removing"><a class="anchor" href="#removing">¶</a>Removing</h3>
40<p>You can remove blocks above and below you in some area with the <code>//removeabove N</code> and <code>//removebelow N</code>. You probably want to set a limit though, or you could fall off the world with <code>//removebelow 1 10</code> for radius and depth. You can also remove near blocks with <code>//removenear block 10</code>.</p>
41<h3 id="shapes"><a class="anchor" href="#shapes">¶</a>Shapes</h3>
42<p>Making a cylinder (or circle) can be done with through <code>//cyl stone 10</code>, a third argument for the height. The radius can be comma-separated to make a ellipses instead, such as <code>//cyl stone 5,10</code>.</p>
43<p>Spheres are done with <code>//sphere stone 5</code>. This will build one right at your center, so you can raise it to be on your feet with <code>//sphere stone 5 yes</code>. Similar to cylinders, you can comma separate the radius <code>x,y,z</code>.</p>
44<p>Pyramids can be done with <code>//pyramic stone 5</code>.</p>
45<p>All these commands can be prefixed with "h" to make them hollow. For instance, <code>//hsphere stone 10</code>.</p>
46<h2 id="regions"><a class="anchor" href="#regions">¶</a>Regions</h2>
47<h3 id="basics"><a class="anchor" href="#basics">¶</a>Basics</h3>
48<p>Operating over an entire region is really important, and the first thing you need to work comfortably with them is a tool to make selections. The default wooden-axe tool can be obtained with <code>//wand</code>, but you must be near the blocks to select. You can use a different tool, like a golden axe, to use as your "far wand" (wand usable over distance). Once you have one in your hand type <code>//farwand</code> to use it as your "far wand". You can select the two corners of your region with left and right click. If you have selected the wrong tool, use <code>//none</code> to clear it.</p>
49<p>If there are no blocks but you want to use your current position as a corner, use <code>//pos1</code> or 2.</p>
50<p>If you made a region too small, you can enlarge it with <code>//expand 10 up</code>, or <code>//expand vert</code> for the entire vertical range, etc., or make it smaller with <code>//contract 10 up</code> etc., or <code>//inset</code> it to contract in both directions. You can use short-names for the cardinal directions (NSEW).</p>
51<p>Finally, if you want to move your selection, you can <code>//shift 1 north</code> it to wherever you need.</p>
52<h3 id="information_2"><a class="anchor" href="#information_2">¶</a>Information</h3>
53<p>You can get the <code>//size</code> of the selection or even <code>//count torch</code> in some area. If you want to count all blocks, get their distribution <code>//distr</code>.</p>
54<h3 id="filling_2"><a class="anchor" href="#filling_2">¶</a>Filling</h3>
55<p>With a region selected, you can <code>//set</code> it to be any block! For instance, you can use <code>//set air</code> to clear it entirely. You can use more than one block evenly by separting them with a comma <code>//set stone,dirt</code>, or with a custom chance <code>//set 20%stone,80%dirt</code>.</p>
56<p>You can use <code>//replace from to</code> instead if you don't want to override all blocks in your selection.</p>
57<p>You can make an hollow set with <code>//faces</code>, and if you just want the walls, use <code>//walls</code>.</p>
58<h3 id="cleaning"><a class="anchor" href="#cleaning">¶</a>Cleaning</h3>
59<p>If someone destroyed your wonderful snow landscape, fear not, you can use <code>//overlay snow</code> over it (although for this you actually have <code>//snow N</code> and its opposite <code>//thaw</code>).</p>
60<p>If you set some rough area, you can always <code>//smooth</code> it, even more than one time with <code>//smooth 3</code>. You can get your dirt and stone back with <code>//naturalize</code> and put some plants with <code>//flora</code> or <code>//forest</code>, both of which support a density or even the type for the trees. If you already have the dirt use <code>//green</code> instead. If you want some pumpkins, with <code>//pumpkins</code>.</p>
61<h3 id="moving"><a class="anchor" href="#moving">¶</a>Moving</h3>
62<p>You can repeat an entire selection many times by stacking them with <code>//stack N DIR</code>. This is extremely useful to make things like corridors or elevators. For instance, you can make a small section of the corridor, select it entirely, and then repeat it 10 times with <code>//stack 10 north</code>. Or you can make the elevator and then <code>//stack 10 up</code>. If you need to also copy the air use <code>//stackair</code>.</p>
63<p>Finally, if you don't need to repeat it and simply move it just a bit towards the right direction, you can use <code>//move N</code>. The default direction is "me" (towards where you are facing) but you can set one with <code>//move 1 up</code> for example.</p>
64<h3 id="selecting"><a class="anchor" href="#selecting">¶</a>Selecting</h3>
65<p>You can not only select cuboids. You can also select different shapes, or even just points:</p>
66<ul>
67<li><code>//sel cuboid</code> is the default.</li>
68<li><code>//sel extend</code> expands the default.</li>
69<li><code>//sel poly</code> first point with left click and right click to add new points.</li>
70<li><code>//sel ellipsoid</code> first point to select the center and right click to select the different radius.</li>
71<li><code>//sel sphere</code> first point to select the center and one more right click for the radius.</li>
72<li><code>//sel cyl</code> for cylinders, first click being the center.</li>
73<li><code>//sel convex</code> for convex shapes. This one is extremely useful for <code>//curve</code>.</li>
74</ul>
75<h2 id="brushes"><a class="anchor" href="#brushes">¶</a>Brushes</h2>
76<p>Brushes are a way to paint in 3D without first bothering about making a selection, and there are spherical and cylinder brushes with e.g. <code>//brush sphere stone 2</code>, or the shorter form <code>//br s stone</code>. For cylinder, one must use <code>cyl</code> instead <code>sphere</code>.</p>
77<p>There also exists a brush to smooth the terrain which can be enabled on the current item with <code>//br smooth</code>, which can be used with right-click like any other brush.</p>
78<h2 id="clipboard"><a class="anchor" href="#clipboard">¶</a>Clipboard</h2>
79<p>Finally, you can copy and cut things around like you would do with normal text with <code>//copy</code> and <code>//cut</code>. The copy is issued from wherever you issue the command, so when you use <code>//paste</code>, remember that if you were 4 blocks apart when copying, it will be 4 blocks apart when pasting.</p>
80<p>The contents of the clipboard can be flipped to wherever you are looking via <code>//flip</code>, and can be rotated via the <code>//rotate 90</code> command (in degrees).</p>
81<p>To remove the copy use <code>//clearclipboard</code>.</p>
82</main>
83</body>
84</html>
85