Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for TimeCode

A plugin which allows to climb up ladders/vines/scaffholdings and water faster!

**Hey, thanks for viewing this page! Because I found no plugin which allows to ascend faster (climb up ladders faster), I decided to create this Open-Source one! If you found any bugs or errors or if you have wishes, please join my discord and open a ticket: https://discord.gg/mf9JNrzh | Thanks :)

Before I start: I've looked at the older Minecraft-Versions now (1.8-1.18) and after testing them I REALLY DO NOT RECOMMEND TO USE THIS PLUGIN ON MINECRAFT-VERSIONS BELOW THE 1.19**

Whats Faster Ascend? With Faster Ascend you're able to speed up the climbing animation on ladders/vines and water. So perfect for any kind of server! In contrast to the version created in 2019 by another Spigot developer, there are many more options here! You may have noticed that the climbing animation cannot be accelerated with a speed effect. So I tricked this a bit using Velocity. In general, there are 2 types to choose from in my version. The liquid and the super fast way. The fluid way plays the climbing animation faster (Informations: it "boosts" the player up) and the super fast way easily teleports the player right to the end of the ladder/water/vines. You can change almost everything, give it a try. Long story short, below you'll find a tutorial on how to install it, as well as the features and developer API! Have fun and if you like this plugin I would happy if you leave a rating at this plugin (y)

Features:

  • Climb ladders/vines/(water) up, when you touch one
  • Activate/Disable the climbing animation
  • Change the Blocks which should be faster climbable
  • Change the climbing speed and delay (you can customize the speed and delay for every valid block individually (not required))
  • Climb up ladders/vines with (SHIFT + ) RightClick/LeftClick instantly with or without animation
  • Climb up ladders/vines DURING the animation with SHIFT instantly (you can activate this in the config.yml)
  • Add/Set messages/sounds which should be sended when a specivic event gets triggered

How to install: 1. Click on this webpage on Download Now and open your Downloads folder 2. Open your Minecraft-Server-Folder and put the plugin from your Downloads in your plugins folder of your Minecraft-Server 3. Start/Restart your server 4. After your server got started the plugin should get activated. Type /plugins in your Console to see if the plugin is working (In the List which get printed out you should see a plugin named "FasterAscend"). 5. You're ready! All options are described in the config.yml (which you can find in the FasterAscend folder in the plugins folder of your Minecraft-Server) and if you need help, join my discord (or watch my German Tutorial after it got released)

Coming Soon / TODO:

Commands: /fasterascend reload - Reloads the config.yml - Needs the permission fasterascend.reload (you can change this permission in the config.yml)

Config:

config.yml
######################################################################################################
# ███████╗░█████╗░░██████╗████████╗███████╗██████╗░░█████╗░░██████╗░█████╗░███████╗███╗░░██╗██████╗░ #
# ██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔════╝██╔══██╗██╔══██╗██╔════╝██╔══██╗██╔════╝████╗░██║██╔══██╗ #
# █████╗░░███████║╚█████╗░░░░██║░░░█████╗░░██████╔╝███████║╚█████╗░██║░░╚═╝█████╗░░██╔██╗██║██║░░██║ #
# ██╔══╝░░██╔══██║░╚═══██╗░░░██║░░░██╔══╝░░██╔══██╗██╔══██║░╚═══██╗██║░░██╗██╔══╝░░██║╚████║██║░░██║ #
# ██║░░░░░██║░░██║██████╔╝░░░██║░░░███████╗██║░░██║██║░░██║██████╔╝╚█████╔╝███████╗██║░╚███║██████╔╝ #
# ╚═╝░░░░░╚═╝░░╚═╝╚═════╝░░░░╚═╝░░░╚══════╝╚═╝░░╚═╝╚═╝░░╚═╝╚═════╝░░╚════╝░╚══════╝╚═╝░░╚══╝╚═════╝░ #
######################################################################################################
# Made by TimeCode @ 2023  #
# Plugin-Version: 1.1-BETA #
#       (11.01.2023)       #
############################################################################################################
# If you got an error or found a bug (or if you have wishes), join my discord: https://discord.gg/mf9JNrzh #
############################################################################################################
# This plugin was made for the Minecraft-Versions 1.14-1.19! I've tested versions below and fixed bugs for #
# their versions (1.8-1.13) but using it is not recommended!                                               #
############################################################################################################

#Change this to "false" if you want to disable this plugin
Enabled: true

#Change the InstantClimbUp options
#Makes, if you want to climb up, that it boosts you until the end (of the for example ladder) is reached
#IF YOU ENABLE THIS FUNCTION IT MIGHT HAVE CONSEQUENCES
InstantClimbUp:
  #Enables this function ("true")
  Enabled: false
  #If you enable this, this function will only work if you ascend up from ground
  OnlyOnGround: true
  #ONLY NEEDED IF ONLYONGROUND IS ENABLED (this function is useless if the OnlyOnGround method is disabled)
  #If this function is enabled the normal boost will get activated if you for example climb up at the half of the ladderline
  #IMPORTANT: THIS OPTION MUST BE DISABLED ("false") IF YOU DISABLED THE ONLYONGROUND OPTION
  DontDisableNormalBoost: true
  #Set this to "false" if you just want to climb up instantly and want to disable the climbing animation
  WithAnimation: true

#Set the blocks where you can ascend up faster
Blocks:
  #Enables faster ascending on vines
  Vines: true
  #Enables faster ascending on water
  #Information: Most of the listed options above and under this option (except the Boost option) are not recommended to use with the water
  #It is recommended to disable this
  Water: false
  #Enables faster ascending on ladders
  Ladders: true
  #Enables faster ascending on scaffholdings (ONLY USABLE ON MINECRAFT VERSIONS OVER 1.13 (1.14-1.19))
  Scaffholdings: true
  #Enables faster ascending on extra vines (twisting, weeping) (ONLY USABLE ON MINECRAFT VERSIONS OVER 1.13 (1.14-1.19))
  ExtraVines:
    #Enables faster ascending on twisting vines
    Twisting: true
    #Enables faster ascending on weeping vines
    Weeping: true

#This option allows you to just enable "Faster Ascending" if the ladder/vine/water... has a specific length
RequiredLength:
  #Change this to "true" if you want to enable it
  Enabled: false
  #Change the MINIMUM length of the ladder/vine/water... IN BLOCKS
  LengthInBlocks: 10

#Set worlds where players won't be able to use this feature
Blacklist:
  #Change this to "true" if you want to enable it
  Enabled: false
  #Change this to "true" if you want to turn this blacklist to a whitelist
  ToWhitelist: false
  #Add the worlds (names) which should be blacklisted/whitelisted
  Worlds:
    - "world_the_end"
    - "world_the_nether"
    - "your_world"

#Change the settings for the boost (the speed which boosts the player up if he for example uses a ladder)
Boost:
  #Change the boost (DEFAULT: 4 | Information: Don't set the boost to high)
  Speed: 4
  #Change the delay options (in ticks) (DEFAULT: 7 ticks) (It's not recommended to change this value)
  #(Information: There must be a delay to make it possible to check if the player want to climb down | If you don't want this you can disable it with Dalay: 0)
  #(You should only change this value if the speed is so high, that it's impossible to ascend down a ladder/vine/water)
  Delay: 7
  #Set a custom speed and delay for the specific blocks
  #ONLY WORKING IF THE BLOCK IS ENABLED IN THE OPTION Blocks!
  Custom:
    #Set a custom speed and delay for the vines
    Vines:
      #Set this to "true" if you want to enable the custom "boost"
      Enabled: false
      #Set your custom speed
      Speed: 4
      #Set your custom delay
      Delay: 7
    #Set a custom speed and delay for the water
    Water:
      #Set this to "true" if you want to enable the custom "boost"
      Enabled: false
      #Set your custom speed
      Speed: 4
      #Set your custom delay
      Delay: 7
    #Set a custom speed and delay for the ladders
    Ladders:
      #Set this to "true" if you want to enable the custom "boost"
      Enabled: false
      #Set your custom speed
      Speed: 4
      #Set your custom delay
      Delay: 7
    #Set a custom speed and delay for the scaffholdings
    Scaffholdings:
      #Set this to "true" if you want to enable the custom "boost"
      Enabled: false
      #Set your custom speed
      Speed: 4
      #Set your custom delay
      Delay: 7
    #Set a custom speed and delay for the extravines
    ExtraVines:
      #Set this to "true" if you want to enable the custom "boost"
      Enabled: false
      #Set your custom speed
      Speed: 4
      #Set your custom delay
      Delay: 7

#Adds the ability to climb up the ladder with one click
#THIS FUNCTION IS ONLY USABLE ON GROUND!
#This function isn't working so good! It could happen that you need to rightclick two or more times to get this working...
#(I'm going to fix this)
RightClick:
  #Enables this function ("true")
  Enabled: false
  #Enable this to be able to ONLY use the left hand to trigger this action
  OnlyLeft: false
  #Enable this to be able to ALSO use the left hand to trigger this action
  #(This option won't work if you enabled the OnlyLeft option)
  AlsoLeft: true
  #Set this to "true" to make this option only usable if you press SHIFT and RIGHTCLICK at one time
  WithShift: true
  #Set this to "false" if you just want to climb up instantly and want to disable the climbing animation
  WithAnimation: true

#Enable this mode to press shift to boost up instantly (for example a ladder) (ascending down won't be possible anymore IF YOU PRESS SHIFT)
#THIS FUNCTION IS ONLY USABLE ON THE LADDER/VINE/WATER! (It is the opposite of the RightClick option)
ShiftMode:
  #Enable this function with "true"
  Enabled: false
  #Set this to "false" if you just want to climb up instantly and want to disable the climbing animation
  WithAnimation: true

#Change all messages and sounds which will get send
#ALL EVENTS YOU CAN FIND IN THE API (see it on my spigot site) OR IF YOU WANT A EVENT ADDED TO THE CONFIG JOIN MY DISCORD
#IMPORTANT: You need to change the sound-names (if you're using sounds of the minecraft-versions 1.8-1.13) to the older sound-names (you can see them in the old spigot/paper developer docs)
Events:
  #This event will get triggered if a player starts the ascend-animation
  #ALL PLACEHOLDERS (NEW and ONLY working for the SubOptions Message and Actionbar.Message):
#   %player% (Gets the player name) , %block_name_lowercase% (Gets the blockname written in small) , %block_name_uppercase% (Gets the blockname written in big)
  OnAscendStart:
    #Set this to "true" if you want to enable this functions
    Enabled: false
    #Set the message which will be sended to the player
    Message: "&4&lYou've started climbing up the %block_name_lowercase%!"
    #Change the message of the new actiobar
    Actionbar: "&c&lLets climb up &e&l%player%"
    #Set the sound which will hear the player if this event get triggered
    Sound:
      #You can find all Sound-Names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
      Name: "AMBIENT_SOUL_SAND_VALLEY_MOOD"
      #Set the sound-volume
      Volume: 2
      #Set the sound-pitch
      Pitch: 2
  #This event will get triggered if you get boosted! (IMPORTANT EXAMPLE: If you're for example on a ladder with 10 in a row you will get boosted like 2-4 times)
  OnAscendBoost:
    #Set this to "true" if you want to enable this functions
    Enabled: false
    #Set the message which will be sended to the player
    Message: "&e&lYou got boosted!"
    #Change the message of the new actiobar
    Actionbar: "&c&lB&e&lO&a&lO&f&lS&7&lT&f&l!"
    #Set the sound which will hear the player if this event get triggered
    Sound:
      #You can find all Sound-Names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
      Name: "AMBIENT_SOUL_SAND_VALLEY_MOOD"
      #Set the sound-volume
      Volume: 2
      #Set the sound-pitch
      Pitch: 2
  #This event will get triggered if the ascend-animation of a player ends
  OnAscendEnd:
    #Set this to "true" if you want to enable this functions
    Enabled: false
    #Set the message which will be sended to the player
    Message: "&4&lWOW! &e&lYou've now climbed up the ladder!"
    #Change the message of the new actiobar
    Actionbar: "&a&lNice we have reached the end &e&l%player%"
    #Set the sound which will hear the player if this event get triggered
    Sound:
      #You can find all Sound-Names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
      Name: "AMBIENT_SOUL_SAND_VALLEY_MOOD"
      #Set the sound-volume
      Volume: 2
      #Set the sound-pitch
      Pitch: 2
  #This event will get triggered if a player get instant teleported to the end of a (for example ladder)
  OnInstantTeleport:
    #Set this to "true" if you want to enable this functions
    Enabled: false
    #Set the message which will be sended to the player
    Message: "&4&lYou've got teleported to the end of the ladder!"
    #Change the message of the new actiobar
    Actionbar: "&c&lWow, that was fast"
    #Set the sound which will hear the player if this event get triggered
    Sound:
      #You can find all Sound-Names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
      Name: "AMBIENT_SOUL_SAND_VALLEY_MOOD"
      #Set the sound-volume
      Volume: 2
      #Set the sound-pitch
      Pitch: 2

#This option fixes (it the option is enabled ("true")) the following bug:
#If you want to ascend DOWN a scaffholding with SHIFT you will get boosted back to the highest block of the scaffholding
#(This bug was found in the Minecraft-Version 1.14)
#I DO RECOMMEND TO DISABLE THIS BUGFIX (Because it could have consequences for the "ShiftMode" option)
FixScaffholdings: true

#Set the permission for the command /fastascend reload
Command-Permission: fastascend.reload

#"bStats is a free and open source website that helps the developer to collect usage data from his plugin" (Source: bstats.org)
#If you don't want to send me automatic statistics, disable this with changing it to "false"
bStats: true

#DON'T CHANGE THIS
#AFTER CHANGING THIS THE CONFIG WON'T EXIST ANYMORE
config-version: 1.1

API:

api

For all developers which are using my plugin: The API is simple to use! You just need to add my plugin to your Build Path / Librarys and boom, now you're able to use my Events in your Plugin (If you need support, just join my discord, how I already said at the beginning)! Here are some examples how to use my API:

//INFORMATION: You need to register the Listener in the Main Class of your Plugin
//Like this: this.getServer().getPluginManager().registerEvents(new FAApiTestListener(), this);

@EventHandler
public void onAscendBoost(OnAscendBoost e){
   e.getPlayer().sendMessage("§eOH! You got boosted!");
}

@EventHandler
public void onAscendStart(OnAscendStart e){
   e.getPlayer().sendMessage("You started ascending ;)");
}

//ALL usable Event-Classes you can find in the ENUM-Class FAAPIArg or below
OnAscendBoost | Gets triggered if a player get boosted (up a ladder/vine/water (faster climbing up = "boost"))
OnAscendStart | Gets triggered if a normal ascend animation of a player starts
OnAscendEnd | Gets triggered if a normal ascend animation of a player ends
OnInstantAscendAnimationStart | Gets triggered if a "Instant" ascend animation of a player starts
OnInstantAscendAnimationEnd | Gets triggered if a "Instant" ascend animation of a player ends
OnInstantTeleport | Gets triggered if you get instantly teleported to the end of a ladder/vine/(water)

Thanks for reading! If you like my plugin I would really be happy if you like and review my plugin! :p

Information

CategoryAdmin Tools
Published onApril 25, 2023
LicenseUnspecified
Downloads34
Stars1
Watchers0

Pinned Versions

Members