TorchArrow - In thy light shall we see light

Adds three new arrow types that emit light while flying: a torch arrow, a redstone torch arrow and a flare arrow. While flying in the air, the torch arrows illuminate the blocks around them and finally spawn a torch when the target is reached. The torch arrow will place a normal torch on impact and redstone torch places a redstone torch.The normal torch arrow can be also set to melt ice and snow instantly in arrow glow radius by changing permissions. With redstone torch arrow you can also e.g solve different kind of redstone circuit puzzles or activate circuitry from distance. Finally, you can set the torch arrows to burn hit enemies by a defined change by tuning values in the config-file. The flare arrow does not spawn any torches, but emits light and goes out after a predefined time. Check out the full feature list below and read the instructions!

Current version: v0.9 (Supports CraftBukkit RB 1.2.5-R1.0)
Changelog
Note: If you find a bug, please post a detailed Ticket, no vague error message copypasta to the forum thread!

Usage

One can shoot arrows of one of the arrow types if he has an arrow stack in any slot in the inventory and a torch stack, a redstone stack or a glowstone dust stack on the right side of the bow. If previously mentioned conditions are not met, the bow will shoot arrows normally.

Torch arrow works best in very dark places and in night time on the surface area, and can be also used to brighten dark areas under water to see what is in the bottom of the watery grave.

Features

• An arrow with a cool dynamic light effect that illuminates dark places in air or water in predefined radius.
• Light around player that illuminates the blocks around and follows the player. The light can be turned on by charging the bow or by right clicking the mouse while the bow is active and the required materials are in place.
• Torches or a redstone torches can be placed with torch arrows.
• Placed torches can be removed by shooting them with a normal arrow.
• Torch arrow glow melts ice and evaporates snow.
• Set block on fire with flare arrow or with torch arrows when torch placing is disabled
• Hit enemies can catch fire by a defined chance
• The arrow light of flare arrows will go out after impact and after a predefined time has passed.
• Customize your arrows by changing the settings!
• Supports Bukkit permissions API.

The Arrow Types

Torch Arrow

• Places a normal torch on impact.
• Melts ice and evaporates snow instantly.
• Sets enemy on fire by a predefined chance.
• Does more damage than a normal arrow.
• Emits light around it while flying.
• Sets blocks on fire (if setting enabled and torch spawning disabled)

Redstone Torch Arrow

• Emits light while flying.
• Places a redstone torch on impact.
• Sets enemy on fire. (Half time on fire compared to torch arrow)
• Does half of the damage compared to normal arrow.
• Sets blocks on fire (if setting enabled and torch spawning disabled)

Flare Arrow

• You can change the flare arrow material (default material is glowstone dust)
• Emits light while flying.
• Goes out after predefined time has passed after impact.
• Has bigger light radius on impact than while flying
• Does no damage.
• Sets blocks on fire (if setting enabled)

Light around player

Before you shoot one of the torch arrow types, the arrow illuminates the area around the player for a predefined time period. The light has same intensity and radius as the active torch arrow type and it will follow the player while it is on. When the light turns off it will consume one piece of the material needed for the active arrow type, but no arrows will be consumed. This feature can be turned off by changing playerLightTime-setting to 0 in config.

How to activate the light?

• Charge the bow while torch arrow materials are in place: If you keep the bow charged the light will illuminate the area around you and it will go out after a defined time (defined in config).
• Click the right mouse button once fast while the torch arrow materials are in place: Same as above.

How to turn off the light?

• The light will turn off automatically when a certain time has passed (defined in config) and it will consume a piece of the required material.
• Click the left mouse button when the bow is in hand: The light will turn off and it will consume a piece of the required material.
• Change the active item from bow to another item in hand inventory:: Same as above
• Shoot the active arrow type: The light will go off and apiece of material and an arrow will be consumed normally.

Commands

• /torcharrow reload (Reloads the config file)

Default Permissions

permissions:
    torcharrow.melt:
        description: Allow/disallow player to melt snow, snow blocks and ice blocks instantly with tArrow.
        default: active for op only
    torcharrow.burn:
        description: Allow/disallow player to set enemy on fire
        default: active for every player
    torcharrow.setBlockOnFire:
        description: Allow/disallow player to set block on fire (if no torch is spawned)
        default: active for every player
    torcharrow.torch:
        description: Allow/disallow normal torches to be spawned.
        default: active for every player
    torcharrow.redstone:
        description: Allow/disallow redstone torches to be spawned.
        default: active for every player
    torcharrow.tArrow:
        description: Allow/disallow normal torch arrows
        default: active for every player
    torcharrow.rArrow:
        description: Allow/disallow redstone torch arrows
        default: active for every player
    torcharrow.fArrow:
        description: Allow/disallow flare arrows
        default: active for every player      
    torcharrow.reloadcmd:
        description: Allows player to use "/torcharrow reload" in game to reload config.
        default: active for op only
    torcharrow.enable:
        description: Enable/disable the whole plugin for a player.
        default: Enabled for every player

Config

• spawnTorches: Enable/disable torch spawning on arrow impact. If set to false, this overrides the preset permissions
• smoothLighting: Activates a smoother lighting effect. This may slow down your server a bit.
• playerLightTime: The time (in seconds) that the arrow will light the area surrounding the player while charging the bow (or otherwise activated). IF set to 0, this light effect will not be used.
• arrowGlowIntensity: Intensity of the light coming out from the arrow while it is flying. (allowed values: 0-15)
• lightRadiusFactor: Increases or decreases the light radius around a flying arrow (values: 0.1-3.0). (NOTE: Setting this too big will make your server cry :C)
• delay: The delay affects on how rapidly you can shoot the torch arrows. A normal arrow is used if trying to shoot before the delay timer is finished! (unit: milliseconds) It doesn't affect the usage of normal arrows. (The delay is added to avoid spamming of the torch arrows because the lighting effect of the arrow can be computationally expensive and slow down the server.)
• dmgMultiplier: Damage multiplier for the arrow. (Dmg = Normal arrow dmg * multiplier)
• burnChance: Chance that the arrow lights hit entity on fire. Values: 0.0 - 1.0
• burnDuration: Indicates how long time (in seconds) the hit entity is on fire.
• setBlockOnFire: Sets block on fire (if no torches spawn).
• flareGlowTime: Defines the time (in seconds approximately) how long the flare will glow after impact.
• impactRadius: Works like the 'lightRadiusFactor'. This affects the light radius of the flare when it hits the ground. (NOTE: Setting this too big will make your server cry :C)
• material: Material used for the flare arrow (use item IDs)
• warningMsg: Warns if you try to shoot without arrows. (leave empty to remove the warning)

More discussions at forums.bukkit.org