Installation Guide

This guide will walk you through the process of setting up Dungeonator on your server. If you're an experienced Bukkit server admin, this should be a breeze.

Warning! Dungeonator is more resource-heavy than a vanilla Bukkit install. It has to do a lot of extra work to load rooms and match them together. I've optimized wherever possible, but don't assume you'll be able to run this well on a less powerful machine.


  • The JNBT Library is required for Dungeonator to work.
  • This guide assumes you have already installed and configured a working Bukkit server to your liking. If you haven't done this yet, go read the Bukkit Install Guide and come back when you're done.
  • By default, Dungeonator uses Bukkit's native SQLite database library. Additional data stores may be supported in the future.

Let's get to it!

Step 1: Download

Download the latest version from the Dungeonator BukkitDev page (or use the link at the upper right of this website).

Step 2: Install & Configure

Extract Dungeonator to your plugins/ folder. Your directory structure should look like this:

  • plugins/
    • dungeonator.jar
    • dungeonator/
      • dungeonator.db
      • tiles/
      • widgets/

Step 3: Run

Warning! Dungeonator takes over generation of the default world, "world". It is highly recommended that you run the current version of Dungeonator on its own server to avoid damage to your existing worlds. Later versions will offer more configuration options.

Start CraftBukkit as normal. Dungeonator will generate starting chunks for your world. You're ready to go!