Rankup 3.1

An easy-to-setup and lightweight rankup system with a GUI!

  1. Okx
    Native Minecraft Version:
    1.13
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    Source Code:
    https://github.com/okx-code/Rankup3/
    Rankup allows players to "rank up" from one group to another, by satisfying certain requirements - such as experience, playtime, or money. Ranking up can give players extra permissions or run certain commands on the player.

    Rankup depends on Vault to automatically modify groups, and change players' money. A permissions plugin is also required. An economy plugin is optional, but obviously if you don't have it you will not be able to use the money requirement.


    Commands
    /rankup Rankup to the next rank.
    /ranks View list of ranks.
    /prestige Prestige if you cannot /rankup.
    /prestiges View list of prestiges.
    /rankup3 /pru Displays general plugin information, checks for updates, and reloads config.
    Permissions
    rankup.rankup Access to /rankup (default)
    rankup.reload Allows access to /rankup3 reload
    rankup.ranks Access to /ranks (default)
    rankup.info Access to /rankup3 (default)
    rankup.prestige Access to /prestige (default)
    rankup.prestiges Access to /prestiges (default)
    rankup.checkversion Allows checking the version when a player types /rankup3
    Configuration
    The configuration files contain all the information you need to understand Rankup.
    Code (YAML):
    # this is used for letting you know that you need to update/change your config file
    version
    : 0

    # whether /ranks and /prestiges should be enabled (true) or disabled (false)
    # /rankup3 reload will not do anything if this is changed,
    # you will have to restart your server.
    ranks
    : true
    prestiges
    : true

    # whether or not /prestige and /prestiges should be enabled.
    prestige
    : true

    # how people should confirm ranking up
    # options are: gui, text or none
    confirmation-type
    : 'gui'

    # how long in seconds people have to wait between a /rankup and a /prestige
    # only successful rankups and prestiges start the cooldown.
    # set to 0 to disable.
    cooldown
    : 1

    gui
    :
      rows
    : 1
      rankup
    :
        material
    : EMERALD_BLOCK
        # index can be separated by spaces to show in multiple ways
        # ie, 0-3 9-12 18-21
        # you can also just use a single number instead of a range.
        index
    : 0-3
        name
    : '&a&lConfirm'
        # lore is optional
        lore
    : '&6Rankup to &b{RANK}'
      cancel
    :
        material
    : REDSTONE_BLOCK
        index
    : 5-8
        name
    : '&c&lCancel'
      fill
    :
        name
    : ' '
        # if you are using a 1.8-1.12 and you want to change this
        # you can use MATERIAL:data, for example STAINED_GLASS_PANE:8
        # this works for both the rankup and cancel blocks as well
        material
    : BLACK_STAINED_GLASS_PANE

    text
    :
     # the time in seconds for a player to
      # confirm by typing /rankup again
      timeout
    : 10

    placeholders
    :
     # format for money. for more information, see
      # https://docs.oracle.com/javase/8/docs/api/java/text/DecimalFormat.html
      money-format
    : "#,##0.##"
      percent-format
    : "0.##"
      # the format used for requirements
      simple-format
    : "#.##"
      # used for current_rank and next_rank placeholders when a player is not in anything in rankups.yml
      not-in-ladder
    : "None"
      # used in next_rank placeholders when there is no rankup
      highest-rank
    : "None"
      # used in /prestiges as the {OLD_RANK} placeholder for the first prestige rank
      first-prestige-rank
    : 'D'

    # what to shorten money by.
    # ie 1000 -> 1k
    # set to an empty list to disable
    shorten
    :
    - 'k'
    - 'M'
    - 'B'
    - 'T'
    - 'Q'
    - 'Qu'
    - 'S'
     
    Code (YAML):
    # the messages in this section can be customised for each rankup in rankups.yml.
    rankup
    :
      requirements-not-met
    : "&cYou need {MONEY} money to rankup."
      no-rankup
    : "&eYou are at the highest rank."
      # set to an empty string, ie: success-public: ""
      # to hide that message.
      success-public
    : "&a{PLAYER} &ehas ranked up to: &d{RANK}"
      success-private
    : "&aYou have ranked up to: &d{RANK}"
      # used for the text confirmation
      confirmation
    : |-
        &eAre you sure you want to rankup to &a{RANK}&e?
        &eType &c/rankup &eagain to confirm.
      # used for the GUI confirmation
      title
    : "Rankup to {RANK}"

      must-prestige
    : "&cYou must prestige to /rankup further!"

      # you can (and probably should) you override these in rankups.yml
      # to show the specific requirements for each rank.
      # however if you are just using money or don't need to change the message per rank, you can use any combination of:
      # {MONEY} {MONEY_NEEDED} {PERCENT_DONE <requirement>} {PERCENT_LEFT <requirement>} {AMOUNT <requirement>} {AMOUNT_NEEDED <requirement>}
      # {MONEY} and {MONEY_NEEDED} are different from {AMOUNT money} and {AMOUNT_NEEDED money} in that they use a different format.
      # here is an example of showing the requirements for just money:
      #list:
      #  complete: "&7{OLD_RANK} &8\xbb &7{RANK} &efor &7${MONEY}"
      #  current: "&c{OLD_RANK} &e\xbb &c{RANK} &efor &a${MONEY} &e{PERCENT_DONE money}%"
      #  incomplete: "&r{OLD_RANK} &e\xbb &r{RANK} &efor &a${MONEY}"
      list
    :
        complete
    : "&7{OLD_RANK} &8\xbb &7{RANK}"
        current
    : "&c{OLD_RANK} &e\xbb &c{RANK}"
        incomplete
    : "&r{OLD_RANK} &e\xbb &r{RANK}"
        # an empty string disables the header/footer
        header
    : ""
        footer
    : ""
      # sent when a player tries to rankup when they are on cooldown
      cooldown
    :
        singular
    : "&cYou must wait {SECONDS_LEFT} more second to rankup again."
        plural
    : "&cYou must wait {SECONDS_LEFT} more seconds to rankup again."
    # prestige messages can also be customised
    prestige
    :
      title
    : "Prestige to {RANK}"
      list
    :
        complete
    : "&7{OLD_RANK} &8\xbb &7{RANK}"
        current
    : "&c{OLD_RANK} &e\xbb &c{RANK}"
        incomplete
    : "&r{OLD_RANK} &e\xbb &r{RANK}"
        header
    : ""
        footer
    : ""
      cooldown
    :
          singular
    : "&cYou must wait {SECONDS_LEFT} second to prestige again."
          plural
    : "&cYou must wait {SECONDS_LEFT} more seconds to prestige again."

    not-high-enough
    : "&cYou cannot prestige at your rank!"
    not-in-ladder
    : "&cSorry, but we could not find any rankups for the group(s) you are in."
     
    Code (YAML):
    # this name can be equal to your rank name for simplicity,
    # eg "A" instead of "Aexample".
    Aexample
    :
     # the name of the rank in your permissions plugin
      rank
    : 'A'
      # the next rank a player can rank up to.
      # this must be the name of the configuration section, not the rank name.
      # for example, the name of this configuration section is "Aexample".
      # if this is the last rank, you don't need this.
      next
    : 'Bexample'
      # List of requirements to go to the next rank
      # (ie, this example will charge 1000 money to rankup from A to B)
      # https://github.com/okx-code/Rankup3/wiki/Requirements
      # custom requirements can also be added by other plugins.
      requirements
    :
        money
    : 1000
      # What requirements players need to match to /rankup.
      # this is optional - if you don't use it, it defaults to "all"
      # n.b. if there are no requirements players will always be able to /rankup.
      # all: all requirements
      # any: at least one requirement
      # one: only one requirement
      # none: no requirements
      operation
    : all
      # the console will run these commands when a player ranks up
      #commands:
      # this will run when a player ranks up from A to B.
      #- 'say {PLAYER} well done for ranking up from {OLD_RANK} to {RANK}!'
    Bexample
    :
      rank
    : 'B'
      next
    : 'Cexample'
      requirements
    :
        money
    : 2500
    Cexample
    :
      rank
    : 'C'
      next
    : 'Dexample'
      requirements
    :
          money
    : 5000
          xp-level
    : 2
      # you can have a custom messages for each rank
      # you can use this to list the requirements needed.
      rankup
    :
        requirements-not-met
    : '&cYou need 5000 money and 2 levels of XP to rankup to D.'
        ranks
    :
          complete
    : "&7{OLD_RANK} &8\xbb &7{RANK} &e(5000 money, 2 XP levels)"
          current
    : "&c{OLD_RANK} &e\xbb &c{RANK} &e(5000 money, 2 XP levels)"
          incomplete
    : "&r{OLD_RANK} &e\xbb &r{RANK} &e(5000 money, 2 XP levels)"
    Dexample
    :
      rank
    : 'D'
     
    Code (YAML):
    first:
     # the rank people must be to use this prestige
      from
    : 'D'
      # the rank to change it to
      to
    : 'A'
      next
    : 'P1example'
      # see rankups.yml for more information on requirements, operations, commands and messages
      requirements
    :
        money
    : 10000
      # optional, defaults to all
      operation
    : all
    P1example
    :
      from
    : 'D'
      to
    : 'A'
      # the rank add to indicate this prestige
      rank
    : 'P1'
      next
    : 'P2example'
      requirements
    :
        money
    : 20000
        xp-level
    : 5
    P2example
    :
      from
    : 'D'
      to
    : 'A'
      rank
    : 'P2'
    You can also use config placeholders in most messages. More information is on the GitHub wiki.

    You can also see placeholders for PlaceholderAPI on the wiki.
    License
    The MIT License (MIT)

    Copyright (c) Okx 2018

    Permission is hereby granted, free of charge, to any person obtaining a copy
    of this software and associated documentation files (the "Software"), to deal
    in the Software without restriction, including without limitation the rights
    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    copies of the Software, and to permit persons to whom the Software is
    furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in all
    copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    SOFTWARE.

    KevFive has generously made a YouTube tutorial on this plugin, however it is outdated, as it is for 2.6d



    Reviews are not the place to ask for help. Join the Discord for help.
    GameplayGP, Kenroytk, iGPLTV and 18 others like this.

Recent Reviews

  1. iOriginz
    iOriginz
    5/5,
    Version: 3.1
    Amazing plugin, extremely easy to setup, and a very easy way to contact the dev and get amazing assistance with any problem you may have. Definitely recommend!
  2. AkiraTsubasa
    AkiraTsubasa
    5/5,
    Version: 3.1
    Perfect plugin, could you add some events when ranking up such as a firework or enderman effects and sounds? It would be the best feature
    1. Okx
      Author's Response
  3. Disfracus...
    Disfracus...
    5/5,
    Version: 3.0.2
    Very good your plugin but it that you add execution commands at the time of / rankup (confirmed) the console executes / warp A User

    Also how do I remove the confirmation gui:?
    And you can add particles to the moment / rankup or sounds:?

    It is a good complement but I think that with that you would do much better

    Sorry for the bad spelling or if nothing fits. I use google translate

    Love it Plugin!!!!!!!!!!
    1. Okx
      Author's Response
      Thanks for you review, please ask for help in the Discord next time.
      However, you can add commands when a player uses /rankup in the rankups.yml config, there should be a comment explaining it.

      Removing the confirmation GUI can be done in the config.yml by changing confirmation-type. Adding particles or sounds must be done in the commands section.
  4. zizo95
    zizo95
    5/5,
    Version: 3.0.1
    ===================================
    can you add agui for ranks and make decrption for this plz
    ====================================
    1. Okx
      Author's Response
      I'll add a GUI for /ranks and /prestiges to the todo. What do you mean by "make decrption"?
  5. Ilario42
    Ilario42
    5/5,
    Version: 2.10
    Bravo good, nice plugin congratulations, simple but complete! Good job, friend

    !
  6. dinoboss2001
    dinoboss2001
    5/5,
    Version: 2.10
    el pugin me encanto una duda como pongo para que la variable se aceholderapi /papi ecloud download rankup 2.10 y no se descargo me la dirías wapo.
    1. Okx
      Author's Response
      Rankup does not need /papi ecloud down rankup. It is automatic.
      Rankup no necesita /papi ecloud download rankup. Es automático
  7. Romerjan
    Romerjan
    3/5,
    Version: 2.9.1
    how to add prefix for P1 ? Like they will have [1][A]theirname please heeeeeeeelp?
    1. Okx
      Author's Response
      That's not the role of rankup. LuckPerms or my plugin Multiprefix can help you with that. Ask for help on the Discord server.
  8. GameplayGP
    GameplayGP
    5/5,
    Version: 2.9.1
    I really loved this plugin =D Also I had a tutorial but it makes lag here :(
    But I can make a tutorial in youtube!
    Thank you for this plugin, I screwed up when I didn't find a plugin like that! Now players can buy ranks, instead of waiting 1/2/3/4 weeks to rankup. now they can buy it instead.
    Also I thought it wasn't for Essentials balance. I love you... Author's Response your cool! Please love this comment, I really love this!
    All what you need to get is:
    PermissionsEX (That is the rank plugin) Rankup (This is the plugin that makes players buy) Vault (That opens GUIs)
  9. Leomelonseeds
    Leomelonseeds
    5/5,
    Version: 2.9.1
    Niiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiice
  10. JPVortex_225
    JPVortex_225
    5/5,
    Version: 2.8.1
    Amazing plugin, I needed a plugin that would allow players to buy ranks with in game money. couldn't find anything so I thought I was screwed, until I found this plugin. It is so easy to understand and use, amazing plugin, would recommend to anyone. :)