/StarterKit

A plugin for Bukkit to give items to new players

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

StarterKit - give items to new players.

StarterKit is plugin for the Minecraft wrapper Bukkit that provides a method for administrators to give items to new players automatically and seemlessly. You could use this to make your server a more welcoming place to start without running the risk of players exploiting it by claiming their kit more than once.

Features

  • Simple and easy to configure - create your ideal inventory then save it.
  • Assign items by slot, including armour.
  • Supports complex items such as maps.
  • Can use any item that Bukkit supports in your kit.
  • Ensures that only new players will receive the kit.

License

StarterKit is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

StarterKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Documentation

If you are a server administrator, many of the features specific to StarterKit are documented on the wiki. If you are looking to change the messages used in StarterKit or localise the plugin into your own language you will want to look at this page instead.

If you are a developer you may find the JavaDocs and a Maven website useful to you as well.

Installation

Before installing, you need to make sure you are running at least the latest recommended build for Bukkit. Support is only given for problems when using a recommended build. This does not mean that the plugin will not work on other versions of Bukkit, the likelihood is it will, but it is not supported.

Getting the latest version

The best way to install StarterKit is to use the symbolic link to the latest version. This link always points to the latest version of StarterKit, so is safe to use in scripts or update plugins. A feature changelog is also available.

Getting older versions

Alternatively older versions are available as well, however they are not supported. If you are forced to use an older version for whatever reason, please let me know why by opening a issue on GitHub.

Building from source

You can also build from the source if you would prefer to do so. This is useful for those who wish to modify the plugin before using it. Note it is no longer necessary to do this to alter messages in the plugin. Instead you should read the documentation on how to localise the plugin instead. This assumes that you have Maven and git installed on your computer.

git clone git://github.com/grandwazir/StarterKit.git
cd StarterKit
mvn install

Reporting issues

If you are a server administrator and you are requesting support in installing or using the plugin you should make a post in the forum on BukkitDev. If you want to make a bug report or feature request please do so using the issue tracking on GitHub.