Bukkit

Overview

GreenCrate is a simple plugin that adds prize crate items to your server. 'Crates' are items that open when right clicked, awarding the player specified items as defined in the config.yml file for that crate. Crates can be configured with custom item IDs, data values, and custom display names, among many other options. They can also open customized chest GUI screens for the user to take items out of, as well as drop from mobs as a reward. Items in the crates can be configured with data values, amounts, enchantments, display names, and lore.

Commands and Permissions

This plugin uses the /crate command to distribute and manipulate crates manually. All command functionalitites from previous versions have been combined into this single command.

• /crate reload - Reloads the main config.yml file. (Permission: greencrate.crate.reload) ♦

• /crate list - Lists all crates available to you. (Permission: greencrate.crate.list)

• /crate spawn <name> - Spawn the item for the specified crate into your inventory. (Permission: greencrate.crate.spawn)

• /crate give <player> <name> - Gives the crate item for the specified crate to the given player. (Permission: greencrate.crate.give) ♦

• /crate random - Spawns the crate item for a random crate into your inventory. (Permission: greencrate.crate.random)

• /crate giverandom <player> - Gives the item for a random crate to the specified player. (Permission: greencrate.crate.giverandom) ♦

• /crate open <name> - Opens the specified crate for you without the crate item. (Permission: greencrate.crate.open)

• /crate openfor <name> <player> - Opens the specified crate for the given player without the crate item. (Permission: greencrate.crate.openfor) ♦

• /crate openrandom - Opens (gives you the items for, or opens the chest GUI for) a random crate in the config. (Permission: greencrate.crate.openrandom)

• /crate openrandomfor <name> - Opens a random crate for the specified player. (Permission: greencrate.crate.openrandomfor) ♦

♦ Can be run from the server console.

If you have individual crate permissions enabled, you must give players greencrate.use.<cratename> for them to be allowed to open the crate.

Configuration

Visit the configuration page for details on how to use GreenCrate's config.yml file.

WARNING: Since this project is still in an early development stage, the format of the config.yml may change in between versions and may not always be cross-compatible. Be sure to update your config to the latest formatting when updating to a newer version.

Bug Fixes

This plugin is very early in development. If you find a bug, please submit a ticket. I need to know what version of CraftBukkit you are using and the contents of your config.yml file. If it is an Exception in the console, I also need the exact text of the Exception from the console. If it is a problem with the plugin itself, I will do my best to fix it.

Source

The source code for this plugin is available on GitHub. I apologize if the code is outdated; I'm not really good with GitHub, and I might have trouble merging all of the up-to-date changes.

GitHub Repository: GreenCrate

Feature Requests

If you have feature requests, please PM me, submit a ticket, or leave a comment. I can use all the good ideas I can get to make this plugin better. Some possible future additions are listed below. (This is not an exhaustive list.)

Planned Additions:

• '[GreenCrate] ...' notification disable option in config
• Subgrouping and randomization for crate contents
• Item-specific options, such as cooldowns, limits, etc
• In-game crate creation