Bukkit

Introduction

SimpleWands adds a variety of craftable wands to your world. Wands are mid-range weapons that fire different projectiles and cause different effects (positive and negative) when they hit the target.

The wands are simple to use. They have only two actions - a main action and a secondary action. These actions are triggered by the left mouse button and the right mouse button, respectively. Whenever an action is triggered, the wand fires a particular projectile towards the target.

The wands also rely on a mana system. A player must have enough mana (which is the same as “power” or “energy”) in order to use the wand. This plugin allows the server operators to choose a mana mechanism that works for them, from item-in-inventory to scoreboard objective score.

Wands

The default wands are:

• FireyWand
  • Main: Long-range, light damage attack that sets targets on fire.
  • Secondary: Mid-range fireball that sets all targets in the area on fire if it hits.

• IcyWand
  • Main: Long-range, light damage attack.
  • Secondary: Mid-range snowball that slows down the target if it hits and causes light damage.

• HealingWand
  • Main: A mid-range projectile. If it hits, heals the target for 1 HP.
  • Secondary: A short-range projectile. If it hits, gives the target regeneration.

• SupportWand
  • Main: A mid-range projectile. If it hits, gives the target swiftness.
  • Secondary: A mid-range projectile. If it hits, gives the target strength.

• LightningWand
  • Main: Long-range, light damage attack.
  • Secondary: Mid-range, high cost attack. If it hits, the target will be struck by a lightning and suffer additional damage.

• PoisonWand
  • Main: Long-range, light damage attack.
  • Secondary: Mid-range high cost attack. If it hits, poisons the target and everyone in the area.

• WickedWand
  • Main: Mid-range egg which weakens the target and causes light damage.
  • Secondary: Mid-range attack. If it hits, 1 level of positive effect will be removed from the target (e.g. Swiftness 2 will turn into Swiftness 1).

• MendingWand
  • Main: A mid-range projectile. If it hits, heals the target for 1 HP.
  • Secondary: Mid-range mending effect. If it hits, 1 level of negative effect will be removed from the target (e.g. Weakness 2 will turn into Weakness 1).

• ProtectionWand
  • Main: A mid-range projectile. If it hits, gives the target a quick absorption effect, which gives the player the ability to absorb damage.
  • Secondary: Mid-range projectile. If it hits, gives the target damage resistance effect (reduces all incoming damage).

Please note that server owners may add new wands or change the existing wands.

Projectiles

The behavior and properties of wands actually come from the projectiles they fire. In fact, a wand is just a composition of two projectiles types (main and secondary). The types of projectiles, their damage values, effects, cost and range are all listed in the configuration file of the plugin (config.yml). As a server owner, you may add new projectiles. This is, for example, the configuration section of the secondary projectile used by the healing wand:

  regenegg:
    type: egg
    cost: 5
    range: 10
    effect:
      type: 10
      duration: 60
      amplifier: 2

This means that a projectile called “regenegg” (used by the secondary action of the healing wand) is of type egg, costs 5 mana, has a range of 10 blocks and causes the regeneration effect for 60 ticks (3 seconds) amplified (x2).

Mana Mechanism

The plugin supports four mana mechanisms:

• 'xp' - The player XP level
• 'item' - The amount of a particular item in the player's inventory (default is redstone).
• 'food' - The player's food level.
• 'scoreboard' - The score of the player in a scoreboard of a defined objective (called "mana" by default)

The default mana mechanism is ‘item’, which means a player’s mana will be determined by the amount of redstone (you may change this to a renewable item like sugar) that they have in their inventory. Whenever the player uses a wand, that amount will be taken from their inventory.

For a mana system that self-regenerates (since version 1.4), you may use 'scoreboard'. It displays the player's mana on a personal scoreboard whenever the player switches to the wand or uses it, and it does not affect other aspects of the game. The mana is regenerated at a pace of 1 mana per second, up to a maximum of 20 (configurable).

Food level is also an interesting mana source in survival/pvp servers. For the wands to be effective, a player will have to eat frequently during battle to regenerate mana.

Change the attribute 'ManaMechanism' in config.yml to switch the mana mechanism (this will require a server reload).

Crafting

By default, the wands above can be crafted. The recipes are listed in the configuration file of the plugin. A server owner may choose to remove those recipes, in which case the wands will only be available via the /simplewands give command.

For example, this is the default crafting recipe for the FireyWand wand:

  FireyWand:
    Materials:
      P: BLAZE_POWDER
      B: BLAZE_ROD
      N: NETHER_STAR
    Shape:
      Row1: -P-
      Row2: -N-
      Row3: -B-

Commands

The list of commands:

• /simplewands version - Shows the plugin’s version.
• /simplewands give <wand> - Gives you a wand of type <wand>.
• /simplewands info - Shows information about wands and projectiles.
• /simplewands reload - Reloads the configuration file.
• /simplewands disable - Disables the plugin until the next server reload.

By default, only server operators can use the commands.

Permissions

There are two permission settings:

• simplewands.usecmd - Allows you to use the simplewands command (defaults to ops only).
• simplewands.usewand - Allows you to use the wand (defaults to everyone).

Kits

If you use a kit plugin, which supports lore settings, you can also add the wands to the kits. In Essentials, the item specification will be:

items:
    - 369 1 name:&eFirey_Wand lore:Type:_FireyWand