Sueta

⚡️Taser [1.16.x-1.20.x]⚡️

1.0

Immobilize your enemies!

·Plugin

YouTube


What's Taser?

With Tas er, you can wield the power of the taser to shock your foes, stun your enemies and take your Combat Gameplay to a new level.

Features

  • Everything is completely customizable on the config.yml;
  • Every single message can be translated on the messages.yml;
  • Hex colors are supported;
  • Commands supported for both players and console;
  • Many permissions to ensure the best management of the plugin;
  • If the plugin finds an error on any of the configurations, it will alert the console and the players with the taser.log permission;
  • In case of configuration errors the plugin will automatically switch the functionality containing the error with the plugin pre-set one.
config.yml
####################################
#           Taser v.1.0            #
#  made by TheOnlyLuke & iTzAleh   #
#     Ask for help on Telegram     #
#      @IlSoloLuke & @iTzAleh      #
####################################

#Format:

#Hex Codes -> &#AA00AA

#Color Codes ->
#&0: Black
#&1: Dark Blue
#&2: Dark Green
#&3: Dark Aqua
#&4: Dark Red
#&5: Dark Purple
#&6: Gold
#&7: Gray
#&8: Dark Gray
#&9: Blue
#&a: Green
#&b: Aqua
#&c: Red
#&d: Light Purple
#&e: Yellow
#&f: White
#&r: resets color to the default
#&l: Bold
#&o: Italic
#&n: Underline
#&m: Strikethrough
#&k: Glitch

#Configuration File

#In this section you can change all the plugin settings, and you can customize some names.
#Follow the instructions carefully.

#Don't touch if you don't know what are you doing!

#Taser Item Config
taserItem:
  name: "&6Taser" #String
  lore: #String
    - "&7Right click to tase a player."
    - "&7Charges: &6&l%remainingCharges%"
  customModelData: 163 #Any Integer above or equal to 0
  material: STICK #A Minecraft Item in UPPERCASE

#Charge Item Config
chargeItem:
  name: "&6Taser Charge" #String
  lore: #String
    - "&7Right click to charge the taser."
  customModelData: 18 #Any Integer above or equal to 0
  material: PHANTOM_MEMBRANE #A Minecraft Item in UPPERCASE

#The max number of Charges a Taser can contain
maxCharges: 3 #Any Integer above 0

#Can the Taser be used on NPCs
canTaseNPC: false #Boolean

#How many seconds the player has to wait before using the Taser again
cooldown: 10 #Any Integer

#How many seconds does the player have to wait before being able to move again
duration: 5 #Any Integer

#The sound played when a target is tased
taserSound: BLOCK_NOTE_BLOCK_PLING #A Minecraft Sound -> https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
taserSoundVolume: 1.0 #Any Double between 0.0 and 1.0
taserSoundPitch: 2.0 #Any Double between 0.0 and 2.0
taserSoundBlockRange: 10 #Any Integer (we suggest to keep it between 0 and 20 to avoid lag)

#The sound played when a player charges the Taser
chargeSound: BLOCK_WOODEN_DOOR_OPEN #A Minecraft Sound -> https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
chargeSoundVolume: 1.0 #Any Double between 0.0 and 1.0
chargeSoundPitch: 2.0 #Any Double between 0.0 and 2.0
chargeSoundBlockRange: 10 #Any Integer (we suggest to keep it between 0 and 20 to avoid lag)

#Should a player get killed if he quits while tased
killIfQuit: false #Boolean

#The effects applied to the player when tased
effects:
  blindness:
    enabled: true #Boolean
    duration: 5 #Any Integer above 0
    amplifier: 1 #Any Integer above 0
  slowness:
    enabled: true #Boolean
    duration: 5 #Any Integer above 0
    amplifier: 1 #Any Integer above 0

#The particles played when a player is tased
particles:
  enabled: true #Boolean
  type: VILLAGER_ANGRY #A Minecraft Particle -> https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
messages.yml
####################################
#           Taser v.1.0            #
#  made by TheOnlyLuke & iTzAleh   #
#     Ask for help on Telegram     #
#      @IlSoloLuke & @iTzAleh      #
####################################

#Format:

#Hex Codes -> &#AA00AA

#Color Codes ->
#&0: Black
#&1: Dark Blue
#&2: Dark Green
#&3: Dark Aqua
#&4: Dark Red
#&5: Dark Purple
#&6: Gold
#&7: Gray
#&8: Dark Gray
#&9: Blue
#&a: Green
#&b: Aqua
#&c: Red
#&d: Light Purple
#&e: Yellow
#&f: White
#&r: resets color to the default
#&l: Bold
#&o: Italic
#&n: Underline
#&m: Strikethrough
#&k: Glitch


#If you need to add more lines to a message, just like this:
#
#commands:
#  commandUsage:
#    - "&6&lTaser &6Commands Help:"
#    - " &8• &7/taser get"
#    - " &8• &7/taser give <player>"
#    - " &8• &7/taser getCharge"
#    - " &8• &7/taser giveCharge <player>"
#    - " &8• &7/taser reload"


#Messages Customization

#In this section you can edit all the messages in the chat and in the gui.
#Follow the instructions carefully.

prefix: "&8[&6Taser&8] &7"

internalErrors:
  messageError: "&cAn error has been found in messages.yml regarding '%error%'."
  configError: "&cAn error has been found in config.yml regarding '%error%'."
  invalidTaserItem: "&cAn error has been found while creating the Taser ItemStack from config.yml. Creating a default one.."
  invalidChargeItem: "&cAn error has been found while creating the Taser Charge ItemStack from config.yml. Creating a default one.."
  invalidMaxCharges: "&cAn error has been found while checking the max charges of a Taser from config.yml. It has been set to the default one: 3"

errors:
  noConsolePermission: "&cOnly players can use this command"
  noPlayerPermission: "&cYou don't have enough permissions!"
  playerNotFound: "&7Player &6%target% &7not found."
  missingPlayerArgument: "&cMissing arguments! Use /taser help for help"

commands:
  playerGetTaser: "&aYou got a Taser, yuppi!"
  playerGiveTaser: "&7You gave &6%target% &7a Taser."
  playerGetCharge: "&aYou got a Taser Charge, yuppi!"
  playerGiveCharge: "&7You gave &6%target% &7a Taser Charge."
  commandUsage:
    - "&6&lTaser &6Commands Help:"
    - " &8• &7/taser get"
    - " &8• &7/taser give <player>"
    - " &8• &7/taser getCharge"
    - " &8• &7/taser giveCharge <player>"
    - " &8• &7/taser reload"

actionbar:
  taserRecharged: "&aTaser recharged!"
  cannotTasePlayer: "&cYou can't tase this player!"
  cooldown: "&cYou can't use the Taser for &6%seconds% &cseconds!"

title:
  tasedTitle: "&cYou have been tased!"
  tasedSubtitle: "&7You are immobilized for &6%seconds% &7seconds."

reloadMessage: "&aThe plugin has been reloaded :D"

Commands and Permissions:

  • /taser [help] - Shows the available subcommands (taser.command)
  • /taser get - Get a taser (taser.get)
  • /taser give (player) - Give a taser to a player (taser.give)
  • /taser getCharge - Get a taser charge (taser.getcharge)
  • /taser giveCharge (player) - Give a taser charge to a player (taser.givecharge)
  • /taser reload - Reload messages.yml and config.yml (taser.reload)

Need Support?

You can contact me on Telegram here: @IlSoloLuke.

Please note that by downloading this plugin you agree to following:

  • You are not allowed redistribute the origin plugin binary;
  • You don't have permission to took plugin's credits
  • I am allowed to discontinue any plugin at any time.

Similar projects

Plugin →