Alchemical Arrows 3

AlchemicalArrows aims to improve the bow vs. bow combat experience while staying true to Minecraft's vanilla mechanics as much as possible. This plugin adds 15 unique types of arrows in addition to the ones provided by vanilla Minecraft (potion-tipped arrows), including, but not limited to, air arrows, water arrows, earth arrows, fire arrows, grapple arrows, explosive arrows, life arrows and more... All arrows are craftable such that players have sufficient permissions and can be launched from a bow so long as the alchemical arrows are the closest arrow to slot 1 in the player's inventory (the left-most hotbar slot).
All arrows provided by AlchemicalArrows affect entities in a unique way and some even have in-world effects upon hitting the ground. Others have passive effects such as the magnetic arrow which attracts nearby items! Using AlchemicalArrows' API and extensive documentation, new arrows can be added with ease by any developer whether experienced or new.

There are multiple commands for AlchemicalArrows where the primary use will be for administrators wanting to further control the plugin while the server is running. All commands have associated permission nodes. Please refer to the Permission Nodes section for more information.
/alchemicalarrows [alias: "/aa"]:
Description: The central command for AlchemicalArrows that controls various aspects of the resource including configuration reloading, version information and administrative functionality for in-world arrows.Sub-commands:Example:<reload> - Reload the plugin's configuration file and load everything back into memory.<version> - Retrieve version information of the AlchemicalArrows plugin currently installed on your server.<killallarrows> - Remove all alchemical arrows from the world (if any are present).- /alchemicalarrows reload- /alchemicalarrows version- /alchemicalarrows killallarrows
/givearrow [alias: "/givearrows"]:
Description: Give a variable amount of any alchemical arrow to yourself or to another player.Arguments:Example:<arrow> - The namespaced ID of the arrow to give. Each arrow is assigned a unique ID.[count] - The amount of arrows to give (optional. Defaults to 1).[player] - The player to whom the arrows should be given (optional. Defaults to the command sender; this parameter is required if the command is executed from the console).- /givearrow alchemicalarrows:air- /givearrow earth 32- /givearrow addon_plugin:lifesteal 16 2008Choco

arrows.shoot.*:
Description: Allow the ability to shoot every type of alchemical arrow provided by this plugin.Default: All players have this permission by default.Children:arrows.shoot.air: Allow the ability to shoot an air arrow.arrows.shoot.confusion: Allow the ability to shoot a confusion arrow.arrows.shoot.darkness: Allow the ability to shoot a darkness arrow.arrows.shoot.death: Allow the ability to shoot a death arrow.arrows.shoot.earth: Allow the ability to shoot an earth arrow.arrows.shoot.ender: Allow the ability to shoot an ender arrow.arrows.shoot.explosive: Allow the ability to shoot an explosive arrow.arrows.shoot.fire: Allow the ability to shoot a fire arrow.arrows.shoot.frost: Allow the ability to shoot a frost arrow.arrows.shoot.grapple: Allow the ability to shoot a grapple arrow.arrows.shoot.life: Allow the ability to shoot a life arrow.arrows.shoot.light: Allow the ability to shoot a light arrow.arrows.shoot.magic: Allow the ability to shoot a magic arrow.arrows.shoot.magnetic: Allow the ability to shoot a magnetic arrow.arrows.shoot.necrotic: Allow the ability to shoot a necrotic arrow.arrows.shoot.water: Allow the ability to shoot a water arrow.
arrows.craft.*:
Description: Allow the ability to craft every type of alchemical arrow provided by this plugin.Default: All players have this permission by default.Children:arrows.craft.air: Allow the ability to craft an air arrow.arrows.craft.confusion: Allow the ability to craft a confusion arrow.arrows.craft.darkness: Allow the ability to craft a darkness arrow.arrows.craft.death: Allow the ability to craft a death arrow.arrows.craft.earth: Allow the ability to craft an earth arrow.arrows.craft.ender: Allow the ability to craft an ender arrow.arrows.craft.explosive: Allow the ability to craft an explosive arrow.arrows.craft.fire: Allow the ability to craft a fire arrow.arrows.craft.frost: Allow the ability to craft a frost arrow.arrows.craft.grapple: Allow the ability to craft a grapple arrow.arrows.craft.life: Allow the ability to craft a life arrow.arrows.craft.light: Allow the ability to craft a light arrow.arrows.craft.magic: Allow the ability to craft a magic arrow.arrows.craft.magnetic: Allow the ability to craft a magnetic .arrow.arrows.craft.necrotic: Allow the ability to craft a necrotic arrow.arrows.craft.water: Allow the ability to craft a water arrow.
arrows.command.*:
Description: Allow the ability to use all administrative commands.Default: Operators have this permission by default.Children:arrows.command.killallarrows: Grant access to the "/alchemicalarrows killallarrows" command.arrows.command.reload: Grant access to the "/alchemicalarrows reload" command.arrows.command.givearrow: Grant access to the "/givearrow" command.
arrows.worldguardoverride:
Description: Override WorldGuard protection for arrows shot from users with this permission node.Default: No players have this permission by default. This permission node must be explicitly granted.

CheckForUpdates: true # Whether or not to check for updates. Will not automatically download... just checks MetricsEnabled: true # Enable plugin metrics. Does not track any sensitive information DeathMessages: Enabled: true # Enable custom death messages DeathByPlayer: "%player% was killed by %killer% using %type%" # Death message when killed by alchemical arrows shot by a player DeathBySkeleton: "%player% was killed by a skeleton using %type%" # Death message when killed by alchemical arrows shot by a skeleton DeathByBlockSource: "%player% was shot using a %type%" # Death message when killed by alchemical arrows shot by a dispenser Skeletons: ShootPercentage: 10.0 # The percent chance (0 - 100) for a skeleton to shoot an alchemical arrow. 0 for none LootDropChance: 25.0 # The percent chance (0 - 100) for a skeleton to drop a random alchemical arrow. 0 for none Crafting: CauldronCrafting: false # Whether or not to enable cauldron crafting. EXPERIMENTAL FEATURE!!! USE WITH CAUTION! Arrow: Air: RecipeYield: 8 # The amount of arrows to yield from a crafting recipe AllowInfinity: false # Whether this arrow respects the Infinity enchantment or not Effect: BreatheRadius: 2 # The underwater radius where players' air regenerates Skeleton: CanShoot: true # Whether or not skeletons may shoot this arrow. (ShootPercentage must be > 0) LootDropWeight: 10.0 # The chance for skeletons to drop this arrow on death (LootDropChance must be > 0) Item: DisplayName: "&oAir Arrow" # The arrow's display name Lore: # The arrow's lore - "&f&oFeel the air beneath your feet" - "&f&oDamaged entities are launched into the air" Confusion: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&dConfusion Arrow" Lore: - "&dThis arrow is so... confusing" - "&dWhat does this do again?" Darkness: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&8Darkness Arrow" Lore: - "&8Who turned off the lights!?" - "&8Applies a temporary blindness effect to players" Death: RecipeYield: 8 AllowInfinity: false Effect: InstantDeathPossible: true # Whether this arrow has a chance to cause instant death or not InstantDeathChance: 20.0 # The chance for which instant death may occur Skeleton: CanShoot: false LootDropWeight: 10.0 Item: DisplayName: "&0Death Arrow" Lore: - "&8Are you sure holding this is a good idea?" - "&8A sinister arrow. May instantly kill targets" Earth: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&7Earth Arrow" Lore: - "&7Better than the Moon in my opinion" - "&7Burries damaged entities into the ground" Ender: RecipeYield: 8 AllowInfinity: false Effect: TeleportOnHitBlock: true # Whether or not to teleport players when the arrow hits a block Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&5Ender Arrow" Lore: - "&dIt's almost like a portal gun, but cooler" - "&dSwaps positions with damaged entities" Explosive: RecipeYield: 8 AllowInfinity: false Effect: FuseTicks: 40 # The length (in ticks) the fuse will burn for before exploding ExplosionStrength: 4 # The strength of the explosion (4 = TNT) Skeleton: CanShoot: false LootdropWeight: 10.0 Item: DisplayName: "&cExplosive Arrow" Lore: - "Boom!" - "Ignites a fuse and explodes after hitting ground" Fire: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&cFire Arrow" Lore: - "&cGather around the campfire..." - "&cIgnites damaged entities for 2 - 3 seconds" Frost: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&bFrost Arrow" Lore: - "&bChill out. Snow reason to be angry" - "&bDamaged entities cannot move temporarily" Grapple: RecipeYield: 8 AllowInfinity: false Effect: GrappleForce: 2.5 # The force at which the player is grappled Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&eGrapple Arrow" Lore: - "&eNa na na na, na na na na, na na na na..." - "&e&lBATMAN!" Life: RecipeYield: 8 AllowInfinity: false Effect: FloralRadius: 2 # The radius around which foliage will generate Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&aLife Arrow" Lore: - "&aThe gift of life embewed within an arrow" - "&aA harmless arrow. Inflicts no damage & applies regen" Light: RecipeYield: 8 AllowInfinity: false Effect: StrikeLightning: true # Whether or not to strike lightning when hitting an entity Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&eLight Arrow" Lore: - "&eMay the power of Zeus be upon you!" - "&eStrikes damaged entities with lightning" Magic: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&dMagic Arrow" Lore: - "&dIt's almost... &k| &dMAGICAL &k|" - "&dLaunches entities backwards with great force" Magnetic: RecipeYield: 8 AllowInfinity: false Effect: MagnetismRadius: 5.0 # The radius at which items will be attracted to the arrow Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&7Magnetic Arrow" Lore: - "&7Opposites attract, likes repel" - "&7Pulls damaged entities closer to you" Necrotic: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&2Necrotic Arrow" Lore: - "&2Count Dracula would be proud" - "&2Nearby hostile entities target damaged entities" Water: RecipeYield: 8 AllowInfinity: false Skeleton: CanShoot: true LootDropWeight: 10.0 Item: DisplayName: "&9Water Arrow" Lore: - "&9Navigates quite well underwater" - "&9It's as though it doesn't lose any velocity"

Here you will find a detailed description of every arrow provided by the AlchemicalArrows plugin by default. Next to the title of each arrow, you will notice the name of an item; it is this item that should be used to craft the AlchemicalArrow either in a crafting table or in a cauldron. The generic pattern for all crafting table recipes is as shown:

The highlighted question mark in the center of the crafting table represents the position in which the identified item must be placed in order to craft the AlchemicalArrow. For a more detailed description on cauldron crafting, please see the related section, "Alchemical Cauldrons".
Air Arrow (Ingredient - Feather):
Entity (and player) effects: Launches the damaged entity in the air a random amount of blocks. The force at which the entity is launched is configurable.Passive effects: When the arrow is in a block underwater, nearby entities' air bubbles are replenished slowly over time.
Confusion Arrow (Ingredient - Poisonous Potato):
Player effects:- A Confusion I effect is applied to the player- Teleported 180 degrees in the opposing directionNon-player entity effects: Hostile entities lose sight of their current target.
Darkness Arrow (Ingredient - Coal or Charcoal):
Player effects: A smoke cloud is generated around the damaged player and a Blindness I effect is applied.
Death Arrow (Ingredient - Wither Skeleton Skull):
Entity (and player) effects:- A Wither II effect is applied to the damaged entity- There is a small (configurable) chance at instant death
Earth Arrow (Ingredient - Dirt):
Entity (and player) effects:- A Slowness II effect is applied to the damaged entity- The damaged entity is buried into the closest block on the ground
Ender Arrow (Ingredient - Ender Eye):
Entity (and player) effects: The damaged entity and the shooter of the arrow will swap positions in the world. The velocity of the target and the shooter are also switched.Block effects: Entities will be teleported on top of the block on which the arrow lands.
Explosive Arrow (Ingredient - TNT):
Block effects:- Upon hitting the ground, a (configurable) fuse is ignited- Assuming the arrow was not picked up, after the fuse has completed, the arrow will explode
Fire Arrow (Ingredient - Fire Charge):
Entity (and player) effects: The damaged entity will be lit on fire for a random amount of time, anywhere from 2 to 5 seconds.
Frost Arrow (Ingredient - Snowball):
Entity (and player) effects:- A Slowness effect, infinite in magnitude, is temporarily applied to the player effectively stopping the player's movement- An Anti-Jump effect, infinite in magnitude, is temporarily applied to the player effectively stopping the player's jumping abilitiesBlock effects: Nearby water in a (configurable) radius will be frozen to frosted ice. After a short amount of time, the ice will disintegrate.
Grapple Arrow (Ingredient - Tripwire Hook):
Block effects: The shooter of the arrow is launched towards the arrow's position with a (configurable) force.
Life Arrow (Ingredient - Glistering Melon Slice):
Entity (and player) effects:- A Regeneration II effect is applied to the target entity- This arrow does not inflict any damage upon the entityBlock effects: Foliage is grown in a (configurable) radius around where the arrow lands (assuming it has landed around grass). This is similar to the effect caused by bonemeal right clicking grass.
Light Arrow (Ingredient - Glowstone Dust):
Entity (and player) effects:- The damaged entity is struck with a lightning bolt (configurable)- The damaged entity is forced to look upwards towards the sun
Magic Arrow (Ingredient - Blaze Powder):
Entity (and player) effects: The damaged entity is propelled backwards in the opposing direction of the arrow.
Magnetic Arrow (Ingredient - Iron Ingot):
Entity (and player) effects: The damaged entity is propelled forwards in the direction the arrow hit.Passive effects: Items in a (configurable) radius are attracted towards the arrow.
Necrotic Arrow (Ingredient - Rotten Flesh):
Player effects: Hostile creatures in a 50 block radius all focus upon the damaged player.Entity (and player) effects: A lifesteal effect is applied between the damaged entity and the shooter. Health is taken from the damaged entity and the shooter is healed.
Water Arrow (Ingredient - Water Bucket):
Passive effects: The arrow propels much quicker underwater and the effect of underwater pressure / friction is negligible.

AlchemicalArrows has been happily open sourced for a long time and is ready to be contributed to! If you are an AlchemicalArrows API user or if you are simply interested in the code that goes behind the inner-workings of this plugin, its source code is available on GitHub for you to browse and hack away at. You can find the source code by going to AlchemicalArrows' public repository. If you are familiar with Git, you are free to clone, fork or make a pull request to AlchemicalArrows. If I approve of any changes you decide to pull request, I may consider merging the changes into the main branch and uploading a version with your code. You will be credited in the very next changelog, as well as a link to your PR.
Do note that while AlchemicalArrows is still in beta, work is being done on the "alchemical-arrows-3" branch, not the master branch! If you are to make a pull request, do so on that branch instead!

The API for AlchemicalArrows has been constantly changing during its development, but it's now reached a state where it should remain relatively stable. There are various aspects of the API that can be manipulated by an external plugin, and if you're interested in doing so, you are welcome to check out the numerous pages on the GitHub wiki where you can learn how to use the most important aspects of the API.
For those of you that like to explore projects on your own and see what you can do, AlchemicalArrows is completely documented and filled with detailed information over every single class, method and constant. There are Javadocs hosted on my website for you to browse, and you can find them here: https://choco.gg/javadocs/alchemicalarrows/

This resource is brought to you free of charge without any obligation to pay anything! I love to provide free resources such that people are enjoying it on their servers. Unfortunately, not everything in life is free and I will eventually need some monetary support of some kind. If you enjoy this project and what it provides to your server, please do consider donating as a little thank you for my hard work. I spent countless hours working on this project and all of it is provided without asking for anything.
Donating is not a requirement, and I do not expect anyone to donate. If you so chose to donate out of your own good will, I greatly appreciate the support, and I hope that you enjoy this resource as much as I do developing it! Thank you!
@2008Choco
Hope you can update it as fast as you can :DD
I've FINALLY found a fix for WorldGuard! I've created so many work arounds for this and now I guarantee the next update will have a fix for it!!! Sorry it took so long to figure out. And on top of this, I also created an external API for developers that want to hook into my plugin ;)
Im the biggest idiot.-_-.I put spaces in there when theres not soposed to be spaces.Thanks for the suggestions!
@steveinabox
I just searched it from a McProHosting panel and could find it perfectly fine. Not sure if you just typed it wrong or something else. Copy and paste this into the search bar: "AlchemicalArrows"
@steveinabox
You can download it directly from this page and upload it via FTP.
I was really interested in your plugin, so i went in to my server (multicraft panel btw) and i searched your plugin were the plugin search bar is but i got nothing,it said no matching plugin.Is this a error with my server or the plugin update status or what help me out if you can please!
@triarry
On top of that, I've added an internal API for faster processing and easier / cleaner development in the future, some more commands on top of that, and lots more fixes. ;) 0.8 will have tons of fixes and new features. Commands are the main new features though
@2008Choco
Alright, great. Yeah, it only happened sometimes.
@triarry
I can't seem to replicate that issue. However I will create a command for administrative purposes to clear all arrows and particle instances, and clear the RAM of the arrows
@2008Choco
Having a issue where players can shoot arrows and the particles stay (for example, the death arrows), until a server restart.
@2008Choco
lol I'm aware you're in beta, that why I figured I'd say something about it. Cause you never know whats meant to be or not. As for texture packs, I don't use many very often. I'm one of those weirdo's that play in standard visuals lol. But all in all, Love the plugin, and can't wait to see where it goes. Even to being in beta, it run and fits my server; perfectly
@2008Choco
Subbed already, thanks for the discussion earlier!
@triarry
Let me fix my comment there :P *I'm waiting for a 1.9 snapshot to come out. 2 days at the very least. And actually, due to the release of 1.8.8, I will be releasing one last version before so which I believe has a fix. Be sure to subscribe to the plugin page so you get e-mail updates for when I upload a file. Should be up tomorrow evening
@2008Choco
:( I get that you want to wait until 1.9 since a lot of PvP changes are happening then, but that could be a few months. We will have to change plugins if WorldGuard integration is not a possibility, and I *love* the arrows you have made!
@PaintTheZombie
1. Yes black was intended :P I know it's hard to read, and sometimes that's just dependent on the texture pack's font 2. Thank you for pointing that out. I will change that as soon as possible, or if all else fails, allow this to be crafted with both coal and charcoal 3. Wow o.o I did not even think of that. OKAY!!! Looks like I'm fixing this in the next update. Yes creepers are meant to explode immediately when hit by Fire Arrows, but thanks for showing me that issue. Remember we're in Beta, and there will always be bugs I need to fix
@triarry
Yes I'm aware of this issue. I'm trying really hard to fix this and it's actually causing me quite a bit of problems. I believe I have made a fix for it in the next update, but honestly I'm just waiting for version 1.9 to come out before the next update. I have lots of changes to make in that version. For example, the secondary hand slot.
@2008Choco
Hey,
Would it be possible to get this to interact with WorldGuard? I don't want my players using these arrows in non-pvp zones. The wizardly-magic plugin does it, and we're using your plugin as our main archer plugin, and we want to ensure players aren't trying to arrow grief outside of our war zones :)
Thanks.
Gotta say, love it! So far it's working almost perfectly; HOWEVER. there's a few things that i have to mention- none of them really huge:
1. The death arrow, when crafted the text is black, and coupled with the black tag background, there's no text, you can't read it. and while it's easy to figure out what set of arrows it is, cause it's the only one that does it, i figured I'd mention it because i wasn't for certain it was purposeful.
2. In your images on this info, for the "Darkness Arrow" crafting recipe- the picture appears to me at least, to be Charcoal. But it's coal in the crafting recipe in game, and while i I just assumed once I tried Charcoal and it didn't work, that it was coal.
3. Creepers set on fire by the "Fire Arrow" Explode, immediately. As soon as they're hit they go and they will even destroy blocks, regardless of Creeper Block Damage being blocked server wide by world guard. I like the idea that the creeper explodes, but the block damages override I'm not so fond of. Luckily in my Server Spawn City, i have all aggressive mob spawns blocked, so it won't pose me an issue, but for players it can eventually pose a problem- and it wont be fun filling pot holes for ppl.
Apart from those, it all seems to be running just fine for me, Can't wait to see what the water arrow will end up being like.
For anyone concerned, no this project and I are not dead :P I'm still working on this plugin, and updates are not being cancelled, however, I've been caught up with a lot of real life issues, etc. I will publish an update when everything is all sorted out
Hello there choco! Im a very big fan of your plugin and enjoy it very much. As with you, im a highschool student but I own my own server. I was wondering if my staff and I could contact you on skype. There are multiple bugs with your plugin on my server currently but It would be a great opportunity for us to have you help fix it as all together! No, we aren't one of those cheesy new servers that aren't going anywhere. This is a full fledged server that is currently being paid. Maybe in the near future you could help us with plugins and we could set a price to pay you for any custom plugin support. Anyways we would definitely love to skype you! Best Regards Huntingzap [Skype: killerzapmaster (huntingzap)]
@TenchiPlaysMC
Yes that makes sense. However with the coming of arrow modifications in 1.9 and the secondary hand slot, I see no reason to add one of my own. Besides, if I were to add one, I would need to have a way to store the information of the quiver and bind it to the player. That would involve the use of either databases (which cost money), or store the information in a data file to retrieve later. I had considered this idea in the early development, but I gave up on it as the arrows began to get more complex.
The way arrows are handled as of 1.8, the slot with an arrow closest to the beginning on the inventory will be fired first. In 1.9, I plan on implementing a system with the secondary hand so that it will only fire if it's in that slot. It will much simplify many things that I was planning on implementing, such as selective arrows to shoot.