Snipecraft

Description:
Snipecraft allows you to create and give custom Sniper Rifles using very simple .yaml configuration and basic commands.
Your server must run on 1.17+.

Installation Instructions:
Download the .jar file and with your server stopped, drag the file to your plugins folder, then start the server. A config, permissions and Sniper Rifles file will be generated. If you change any of the information in these files you can always run the reload command to apply the changes.

Configuration:
Once you install the plugin, open its resources folder created and open the sniperRifles.yml file. You will see there is an example for a rifle with the id: heavyRifle. You can copy the whole block and change every characteristic as you which. Make sure to change the id to a unique name. Supported projectiles right now are: ARROW, EGG and SNOWBALL. Once you apply your changes, save the file and run the reload command. Read more about commands in the Commands section down below.

You can find more information regarding the possible particle and sound effects here:

• https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
  
• https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html

Usage:
In order to shoot a sniper rifle you must have the item in your main hand and hit the Swap Item With Offhand key, F by default, or whatever you have it bound to. The player must have the needed projectile in their inventory in order to shoot. If the player has no ammo, the specified no ammo sound in the config.yml file will be played. If the player tries to execute this action with a regular spyglass the item swap will take place and nothing special will happen.

Snipecraft supports no-scoping handling, and in the config.yml file you can change the noScopeError value to adjust the "bloom" spread when shooting without aiming. You can also adjust the noScopeLag value that allows you to adjust the time needed since the player aims on the spyglass until the bloom is closed, in order to shoot accurately.

BEWARE:
Snipecraft identifies each sniper rifle as unique in order to keep track of cooldowns, so if you are running any other plugin that copies the items for rewards or so, it will cause conflict. If you want to grant a rifle as an automatic reward, make it so that it is given through the /give command.

Commands:

• /snipe give -> gives a certain rifle to a player
  /snipe give [player] [rifleId]
• /snipe reload -> reload

Permissions:
snipecraft.op:
description: "Gives access to all of Snipecraft's functionalities"
default: op
children:
snipecraft.command: true
snipecraft.snipers: true
snipecraft.autocompletion: true

snipecraft.command:
description: "Gives access to all of Snipecraft's commands"
default: op
children:
snipecraft.command.reload: true
snipecraft.command.give: true
snipecraft.command.reload:
description: Reload the plugin's configurations
default: op
snipecraft.command.give:
description: Give a sniper rifle to a player through /sc give {player} {rifle_name}

# User a sniper rifle
snipecraft.snipers:
description: Gives access to all snipers functionalities (including use)
default: op
children:
snipecraft.snipers.use: true
snipecraft.snipers.use:
description: Allows the usage (shooting) of sniper rifles
default: false

# See all of the plugins sub commands through tab autocompletion
snipecraft.autocompletion:
description: Allows the player to see the tab autocompletion of commands
default: op


Permissions File:
This file allows you to change the need of permissions to execute the plugins commands or to perform certain actions.

# Enable/disable the need of each permission.
# Avoid changing the actual permission names.

# MESSAGES #
noPermissionMessage: "&cYou do not have permission to do that."
sendMissingPerm: true
# # # # # #

# COMMANDS #
commandUsePermissionNeeded: true
commandUse: snipecraft.command

reloadCommandPermissionNeeded: true
reloadCommand: snipecraft.command.reload

giveCommandPermissionNeeded: true
giveCommand: snipecraft.command.give
# # # # # #

# SNIPERS #
snipersUsePermissionNeeded: false # Set to true if you only want players with permission to be able to shoot
snipersUse: snipecraft.snipers.use
# # # # # #

# TAB COMPLETION #
tabCompletionPermissionNeeded: false
# # # # # #