Minetest-WorldEditAdditions/.docs/Tutorial.md

layout	title	tags	date
content-generic.njk	Tutorial	navigable	2004-01-01

WorldEditAdditions Beginner's Tutorial

Welcome to the WorldEditAdditions beginners tutorial! There are a number of conventions used in the chat command reference that may not be immediately obvious - this guide serves to explain in detail.

It is assumed that:

• You are already familiar the basics of Minetest (try the tutorial game if you're unsure)
• You have both WorldEdit and WorldEditAdditions installed (see the Download section)

Minetest supports the execution of Chat Commands to manipulate the Minetest world. While in a Minetest world, simply type /help (the first forward slash / will automatically cause the chat window to appear) and hit enter to display a list of chat commands that are currently registered grouped by mod for example.

WorldEdit commands are, by convention, prefixed with an additional forward slash /. Here are some examples of WorldEdit chat commands:

//1
//2
//set dirt

Explaining core WorldEdit commands is out of scope of this tutorial, but you can find a complete list of them here: https://github.com/Uberi/Minetest-WorldEdit/blob/master/ChatCommands.md.

The purpose of WorldEditAdditions is to extend WorldEdit by adding additional commands. Example commands that have been implemented that are not present in core WorldEdit include (but certainly aren't limited to):

• //maze: Create instant mazes
• //forest: Plant forests
• //torus: Generate torus shapes
• //scale: Scale things up and down - even both at the same time!

See a full list with complete explanations in the chat command reference.

Regions

WorldEdit allows you to define a region by specifying 2 points in the world - we number these points 1 and 2. By using the WorldEdit wand (or WorldEditAdditions Far Wand), one can left click to set the position of point 1, and right click to set point 2:

{% image "images/tutorial_pos1_2.jpeg" "A screenshot showing WorldEdit points 1 and 2 in a desert with a cactus" %}

Point 1 is on the cactus, and point 2 is on the ground in the bottom left.

Most WorldEdit and WorldEditAdditions commands require either 1 or 2 points to be set in order to work.

• If 1 point is required, it's the origin point used by the command
• If 2 points are required, the defined region specifies the area in which the command is operate

Command syntax

• Command syntax conventions:
  • <thing>
  • a|b
  • [optional_thing]
  • <thing|other_thing>

Anything else?

• Make sure we have covered everything

Advanced Concepts

• Memory usage
• Meta commands
• Other things?