Create some content!

Basic-multiverse-tutorial.md

@@ -1 +1,65 @@
-Writing Tutorial now...
+#Introduction
+MultiVerse is relatively easy to use, although the command set may seem daunting. Here is a short outline of how to use MultiVerse to create and manage worlds.
+
+##Introduction
+World creation is provided by **MultiVerse-core**. It can control mob spawning, environment type, use terrain generators, and more. Despite being able to do all this, do note that **MultiVerse does not create worlds itself**. MultiVerse calls Bukkit to create the worlds. If other plugins exist that create worlds, then you may have messy conflicts. Inception is a well-known example and many horror stories have been told when conflicts do happen (seemingly working fine with MultiVerse for some but not others). Another caveat is that Bukkit still has control over the world; MultiVerse just does its best to control behaviour, but ultimately, other plugins or quirks with Bukkit may possibly override desired behaviour.
+
+##Configuring Bukkit
+You must have `spawn-monsters=true` set in your server.properties to ensure MultiVerse has complete control over monster spawning. This is due to a quirk (arguably bug) in Bukkit. You may still disable monsters in your worlds using MultiVerse even with this setting turned on, so it won't affect anything. Note you do **not** need `spawn-animals=true` or `false`, it makes no difference.
+
+##Creating your first world
+World creation is a relatively simple process. The magic invocation is as follows:
+
+`/mvcreate {NAME} {ENV} -s [SEED] -g [GENERATOR[:ID]]`
+
+For our example, let's simply do
+
+`/mvcreate testworld NORMAL`
+
+To create a test world with a NORMAL (overworld) type environment. If you are particularly clever, you could set the seed here or change the environment to NETHER or SKYLANDS, or if you're really clever, you can figure out how to set the generator to create all sorts of cool terrain (e.g., -g BukkitFullOfMoon). Let's not concern ourselves with that just yet.
+
+With that invocation, your world should now be created. Horray!
+
+##Teleporting to your new world
+Well now you have your world, fantastic! But... you need to get to it now, don't you? Well, that's simple too, just do:
+
+`/mvtp testworld`
+
+And tada, you should now be in your new world! If you want to bring along a mate and he doesn't care if you teleport him all over the bloody place, just do
+
+`/mvtp yourmate testworld`
+
+##Setting the new world's spawn
+Well let's say your new world's 0, 0 isn't exactly the most... ideal of places. You'd rather players not be dumped there when they mvtp to it! So, move to where you want your new spawn to be, and then just do
+
+`/mvsetspawn`
+
+It's like magic!
+
+##Getting back to spawn
+Oh no! You got lost in your world! You need to go back to spawn! Well that's pretty simple:
+
+`/mvspawn`
+
+Tada! Welcome home!
+
+##Modifying some parameters
+Ok, so you're sick of creepers blowing your stuff up, and you want to turn off the hostiles? No problem!
+
+`/mvmodify set monsters false`
+
+You can change a load of other settings very easily.
+
+##Purging monsters and other fun things
+So you're sick of a bunch of animals getting in the way of your building. Perhaps some jackass op spawned a bunch of cows where you were building. No matter! Just clean them up with:
+
+`/mvpurge testworld monsters`
+
+You can also use ALL instead of testworld to do it to all worlds. Instead of monsters, you can specify a comma-separated list of mobs to purge, animals, or "all" for all animals. Beautiful.
+
+##Removing the world
+You're so sick of this world! You quit! It's enough! Well, then you can nuke the world! To nuke it, just do:
+
+`/mvdelete testworld`
+
+After confirming (not discussed here), your world will be completely destroyed. Gone. Not coming back. Ever. Use this command with extreme care!