Minetest-WorldEditAdditions/.docs/index.html

---
layout: theme.njk
title: Welcome
tags: navigable
date: 2000-01-01
---

<section class="bigbox shadow-bottom" style="--bg: url({% image_url "images/banner-main.jpeg" %})">
	<img src="{% image_urlpass '../worldeditadditions.png' %}" alt="" class="icon logo-large" />
	<h1>WorldEditAdditions</h1>
	<p>
		<a class="badge" href="https://content.minetest.net/packages/Starbeamrainbowlabs/worldeditadditions/"><img src="https://img.shields.io/badge/dynamic/json?color=%23375a7f&amp;label=ContentDB&amp;query=downloads&amp;suffix=+downloads&amp;url=https%3A//content.minetest.net/api/packages/Starbeamrainbowlabs/worldeditadditions/" alt="WorldEditAdditions on ContentDB" /></a>
		<a class="badge" href="https://forum.minetest.net/viewtopic.php?f=11&t=24635"><img src="https://img.shields.io/badge/%F0%9F%92%AC-Forums-%2366D034" alt="WorldEditAdditions on the Minetest Forums" /></a>
		<a class="badge" href="https://discord.gg/FzD73kuhsk"><img src="{% image_urlpass 'images/shield-discord.svg' %}" alt="Join our Discord server" /></a>
		<a class="badge" href="https://github.com/sbrl/Minetest-WorldEditAdditions/releases/latest"><img src="https://img.shields.io/github/v/release/sbrl/Minetest-WorldEditAdditions?color=green&amp;label=latest%20release" alt="Latest release on GitHub" /></a>
		<a class="badge" href="/Changelog"><img src="https://img.shields.io/badge/%F0%9F%93%B0-Changelog-informational" alt="View the changelog" /></a>
	</p>
	<p><em>Extra tools and commands to extend <a href="https://github.com/Uberi/Minetest-WorldEdit">WorldEdit</a> for <a href="https://www.minetest.net/">Minetest</a></em></p>
	<p>If you can dream of it, it probably belongs here!</p>
	<p>
		<a href="#download" class="bigbutton">Get Started</a>
	</p>
</section>

<section class="features-large">
	<figure>
		{% image "images/maze2d-alt.png", "A green 2D hedge maze, made with the //maze command" %}
		<!-- <img src="/images/maze2d-alt.png" alt="A green 2D hedge maze, made with the //maze command" /> -->
		<figcaption>
			<p>Use <code>//maze</code> and <code>//maze3d</code> to generate customisable mazes in 2 or 3 dimensions.</p>
			<p>Customise the path sizing for additional artistic control.</p>
		</figcaption>
	</figure>
	
	<figure>
		{% image "images/forest.png", "A forest of orange and lemon trees from the cooltrees mod, along with some bushes from Minetest Game." %}
		<!-- <img src="/images/forest.png" alt="A forest of orange and lemon trees from the cooltrees mod, along with some bushes from Minetest Game." /> -->
		<figcaption>
			<p>Save time by creating instant forests with <code>//forest</code>.</p>
			<p>Artibrary mixes of saplings are supported too as a weighted list.</p>
		</figcaption>
	</figure>
	
	<figure>
		{% image "images/conv-layers.png", "A small mountain smoothed with //smoothadv and topped with snow with //overlay" %}
		<!-- <img src="/images/conv-layers.png" alt="A small mountain smoothed with //smoothadv and topped with snow with //overlay" /> -->
		<figcaption>
			<p>Unlock a continuously growing library of commands, such as <code>//smoothadv</code> for easy terrain smoothing, and <code>//overlay</code> for overlaying a node on top of terrain.</p>
			<p>Many more commands are waiting to be discovered, including <code>//torus</code>, <code>//bonemeal</code>, and <code>//scale</code>.</p>
		</figcaption>
	</figure>
	
	<figure>
		{% image "images/torus-bonemeal.png", "A dirt torus with a grassy top, and a meadow of grass/flowers. Demonstrates //layers and //bonemeal. Doesn't have much to do with the sentences below - I just thought it looked nice as meta commands are difficult to find a good picture for." %}
		<!-- <img src="/images/torus-bonemeal.png" alt="A dirt torus with a grassy top, and a meadow of grass/flowers. Demonstrates //layers and //bonemeal. Doesn't have much to do with the sentences below - I just thought it looked nice as meta commands are difficult to find a good picture for." /> -->
		<figcaption>
			<p>Powerful meta commands such as <code>//multi</code> for executing multiple commands at once and <code>//subdivide</code> for running commands on areas of virtually unlimited size enable convenience and enhance flexibility.</p>
		</figcaption>
	</figure>
</section>

<!-- Potentially we might want some inspiration from https://codepen.io/emared/pen/gWGBLR here -->

<script type="module">
	import KeenSlider from './keen-slider.es.js';
	const slider_creations = new KeenSlider("#gallery-creations", {
		loop: true,
		mode: "free-snap",
		slides: {
			origin: "center",
			perView: 1.5,
			spacing: 15
		},
		created: () => {
			console.log(`[MAIN] Slider initialised`);
		}
	});
</script>
<section id="gallery-creations" class="gallery shadow-vertical">
	<section class="keen-slider">
		{% gallerybox "images/gallery-a.jpeg" %}
			A scene demonstrating <code>//replacemix</code>, <code>//ellipsoid</code>, <code>//layers</code>, <code>smoothadv</code> (aka <code>convolve</code> and <code>conv</code>), and <code>//floodfill</code> - all of which are provided by WorldEditAdditions.
		{% endgallerybox %}
		{% gallerybox "images/gallery-horka.jpeg" %}
			The Temple of Arthemeis, a work-in-progress build by <a href="https://www.youtube.com/@H0rkaa" rel="nofollow">Horka</a> and kliv91.
		{% endgallerybox %}
		{% gallerybox "images/gallery-notsowow.jpeg" %}
			A magical abode for those lost in the mountains, built by <a href="https://www.instagram.com/notsowow_?igsh=MXRxOTJrbWp3Z2ptZg==" rel="nofollow">@notsowow</a>.
		{% endgallerybox %}
		{% gallerybox "images/gallery-b.jpeg" %}
			The inside of a 3d maze made with <code>//maze3d</code>. Lighting was placed manually to improve screenshot quality.
		{% endgallerybox %}
		{% gallerybox "images/gallery-c.jpeg" %}
			A cliff made with <code>//layers</code> and <code>//erode</code>. A <code>//forest</code> has been applied on top with multiple sapling / tree types.
		{% endgallerybox %}
		{% gallerybox "images/gallery-d.jpeg" %}
			A small mountain made with <code>//layers</code> and <code>//erode</code>, using the new optional <code>//layers</code> slope constraints in WorldEditAdditions v1.13.
		{% endgallerybox %}
		{% gallerybox "images/gallery-e.jpeg" %}
			A small mesa canyons terrain scene made with <code>//erode</code>, the new optional <code>//layers</code> slope constraints, and <code>//noiseapply2d</code> - the latter 2 of which are new in WorldEditAdditions v1.13. Minimal manual tuning was required.
		{% endgallerybox %}
		<!-- {% gallerybox "images/gallery-f.jpeg" "image-last" "image-e" "image-first" %}
			A stack of slices of the terrain, made with <code>//many</code> (WorldEditAdditions v1.9+) and <code>//multi</code>. By <a href="https://github.com/VorTechnix">@VorTechnix</a>.
		{% endgallerybox %} -->
	</section>
</section>

<section>
	<h2 id="download" class="shadow-text">Download</h2>
	<div class="features-large">
		<div class="features-item wide text-centre">
			<h3>ContentDB</h3>
			
			<p><a href="https://content.minetest.net/packages/Starbeamrainbowlabs/worldeditadditions/"><img class="icon-medium" src="{% image_urlpass 'images/contentdb.png' %}" alt="WorldEditAdditions on ContentDB" /></a></p>
			
			<p>Download from ContentDB, or from the <em>Content</em> tab in Minetest.</p>
			
			<p><a class="bigbutton" href="https://content.minetest.net/packages/Starbeamrainbowlabs/worldeditadditions/">WorldEditAdditions on ContentDB</a></p>
		</div>
		<div class="features-item wide text-centre">
			<h3>Git</h3>
			<p>WorldEditAdditions is dependent on <a href="https://content.minetest.net/packages/sfan5/worldedit/">WorldEdit</a>. Clone using Git:</p>
			
			<pre><code>cd path/to/worldmods;
git clone https://github.com/Uberi/Minetest-WorldEdit.git worldedit;
git clone https://github.com/sbrl/Minetest-WorldEditAdditions.git worldeditadditions;
cd worldeditadditions;
git checkout "$(git describe --tags --abbrev=0)";</code></pre>
			
			
			<p><a class="bigbutton" href="https://github.com/sbrl/Minetest-WorldEditAdditions">Source code on GitHub</a></p>
		</div>
	</div>
</section>

<section>
	<h2 class="shadow-text">Getting Started</h2>
	
	<div class="panel-generic">
		<p>If you're familiar with WorldEdit already, then WorldEditAdditions will follow the existing expectations you're used to. For players new to WorldEdit / WorldEditAdditions, we have a tutorial that will get you up to speed in no time!</p>
		
		<p>Are you a mod developer who wants to extend or hack on WorldEditAdditions? Check out our Lua API, and our <a href="https://github.com/sbrl/Minetest-WorldEditAdditions/blob/main/CONTRIBUTING.md">contributing docs</a>!</p>
		
		<ul class="bigbutton-list">
			<li><a class="bigbutton" href="/Tutorial">Tutorial</a></li>
			<li><a class="bigbutton" href="/Cookbook">Cookbook</a></li>
			<li><a class="bigbutton" href="/Reference">Reference</a></li>
			<li><a class="bigbutton" href="/api">Lua API</a></li>
		</ul>
	</div>
</section>