MobsGames Plugin

MobsGames is a plugin for Bukkit which adds a framework for and a few basic examples of Server-Run Minecraft games.

Preparing for and Installing the plugin
Server Admins who wish to add this plugin require a MySQL Database. The plugin must be given credentials of a valid User on the MySQL Database, with at least SELECT, INSERT, CREATE and DELETE permissions on one database. It is not advised to give it root or other over privileged accounts, but there should not be much harm in doing so. Download the plugin from here

First Run
On the first run it will create the config file in plugins/MobsGames/config.yml. Alter the credentials in the config to reflect your own credentials for the MySQL server. Stop and start the server again to connect successfully. All tables will be added by the plugin.

Permissions Setup
If your server runs any of the many permissions plugins then it will be necessary to add permission nodes to specific players. The list of permissions are:

Adding A Game World from a ZIP file
Adding new game setups and worlds is fairly simple, load the world how you normally would, Multiverse, altering the bukkit config to load a different world, It's up to you. Every new world you add will be checked incase it has stored MobsGames data. This extra data does not damage world saves, so these Worlds can also be used in other servers without this plugin (But naturally the games wont be activated)

Game Creators Guide
A game consists of several elements. If you are a learn-by-doing sort of person why not try the MobsGames Quick Tutorial

Locations
Locations contain information about the position, what game it is linked to and what type of location it is. Locations are linked to either a specific game or '%' if all games on that world should use it. Types of locations include :

Blocks
Blocks contain information about the position of, contents of, type of and Game related to the block. You can add blocks by right clicking a block with a piece of Flint, the block that is outlined is the one selected, then run the command "/block add BlockName BlockType". The contents of the block are copied when the command is run, not when the block is selected. Names Must be unique and type should be one of :

MetaData
Metadata is a list of Key=Value pairs stored alongside the game definition to allow subtle changes to game styles among the same Game Type. Currently Valid Metadata pairs are:

Source Code
Source for this plugin can be found on github