Bukkit

About

Have you ever wanted to give players on your server potion effects based on their inventory? For example, using war, have you ever wanted to set up different classes with special abilities? If so, this plugin is for you!

Functionality

What this plugin does, is based on the state of a player inventory, it gives them potion effects. For example, you could configure this plugin to give all players wearing full diamond armor that have a stone sword in their hand regeneration 2. For the above example, the configuration might look like this (you can change the 'diamondregen' to whatever you want):

diamondregen:
  handitem: STONE_SWORD

  armor:
    helmet: DIAMOND_HELMET
    chestplate: DIAMOND_CHESTPLATE
    leggings: DIAMOND_LEGGINGS
    boots: DIAMOND_BOOTS
  effects:
    - REGENERATION::2

Commands

• /matchinv: Match a player's inventory to a specific potion effect requirement. Usage:

/matchinv <name of potion in config file> [player name]

• /invpotions: Administration of the plugin. Usage can be found by running:

/invpotions help

Permissions

• invpotions.bypass: Bypass getting potion effects from your inventory state (default: nobody)
• invpotions.commands: Same thing as invpotions.administer and invpotions.matchinv (combined command permission)
• invpotions.matchinv: Access to /matchinv (default: op)
• invpotions.administer: Access to /invpotions (default: op)
• invpotions.potion.*: You can get all potions (default: true)
• invpotions.potion.<POTION NAME>: You can get <POTION NAME>

Installation and usage

1. Download the latest plugin version (should be a JAR file)
2. Put it in your plugins folder, and then reload or restart your server (a reload command in console or stop and start your server)
3. A config file should be generated. Edit this config file to suit your needs. Supports item names from here and potion effects from here. For items, it goes:

   NAME:DAMAGE
   

4. Reload/restart your server again. Now, if any player's inventory contains all of the items in the config for any given potion, they should receive that potion effect.

Bug Reporting

Found a bug? Please tell me so I can fix it! I appreciate constructive, helpful bug reports on the ticket tracker (please not in the comments). Make sure you post your server log and config so I can look for error messages (and errors).

Download

You can download the latest version with the download link at the top of the page. These downloads are preferred over the CI builds (below).

Development Builds

Builds directly from source changes can be obtained here. Please note that they are untested builds. Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk. inventory-based potions CI Server

Source code

Now hosted on github. Stay tuned!