Beginner's Guide

CraftBukkit

CraftBukkit is the reference implementation of the Bukkit API. There are a few other implementations, such as Spout or Spigot, however they are not just the Bukkit API- they extend it to add their own. CraftBukkit is the only implementation that MCTowns is tested against, so it is what we will be using in this tutorial.

Download

Download the latest recommended build (the big green button).

NOTE: AS OF THE DMCA TAKEDOWN, YOU WILL NEED TO FIND SOME OTHER WAY TO OBTAIN CRAFTBUKKIT OR ANOTHER BUKKIT IMPLEMENTATION.

Choose a Directory

You need to select a directory to place the server's files in. Where you put it is up to you- we will refer to this folder as $installPrefix. Move or copy craftbukkit.jar to this folder. The file structure now looks like this:

|
|-$installPrefix
    |-craftbukkit.jar

Priming Run

You should start the server for the first time, then immediately stop it. This is a 'priming run' and generates configuration files and directories that you will probably want to edit.

Open a shell (UNIX) or Command Prompt/cmd.exe (Windows) and run the following commands:

cd $installPrefix
java -jar craftbukkit.jar

The server now starts. Wait for it to say "Done," and stop it with:

stop

The file structure is now:

|
|-$installPrefix
    |-craftbukkit.jar
    |-banned-ips.txt
    |-banned-players.txt
    |-bukkit.yml
    |-help.yml 
    |-ops.txt
    |-permissions.yml
    |-plugins/
    |-server.log
    |-server.properties
    |-white-list.txt  
    |-world/
    |-world_nether/
    |-world_the_end/

The server is now fully prepared.

MCTowns

Setting Up

Follow these pages, then refer back to here.

Configuration and Usage

Refer to these pages for configuration and usage:

• General Overview
• Using WorldEdit and WorldGuard
• Creating and Managing Towns - Admin
• Managing Your Town - Mayor

Refer to the rest of the wiki for further help.