[CURRENTLY NOT MAINTAINED] RankMeUP | GUI based rankup plugin [1.8-1.16] 0.5-ALPHA

Allow your players to rankup after meeting the requirements of the rank.

  1. Jeqqe_
    Native Minecraft Version:
    1.16
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Languages Supported:
    All messages are configurable
    RankMeUP

    [This plugin is currently under heavy development. This being said, it is highly recommended that you do not use this plugin in your production server yet!] [Development for this plugin is currently paused, might continue it sometime in the future.]

    RankMeUP is a rankup plugin meant to be used in survival servers. It's goal is to keep the players more invested into the game by giving your ranks different kind of requirements instead of just money. The ranking up happens in a nice and simple GUI which is also mostly configurable. And yes RGB colors are supported.

    Commands & Permissions: [/rankmeup | /rankup | /ranks | /rank]
    • /rankmeup | /rankmeup browse - Opens the Rankup GUI
    • /rankmeup reload - Reloads the plugin configs
    • /rankmeup setup - Setup a new design for your GUI
    • rankmeup.command (Default permission)
    • rankmeup.admin
    • rankmeup.rank.<rankNumber>
    Currently supported requirements:
    • Items (Supported by default)
    • Playtime (Supported by default)
    • Papi (Requires PlaceholderAPI):
    Papi allows you to use any installed placeholder on your server. For example %vault_eco_balance% and compare it to your desired value. This requirement also accept string values.

    Use (> , = , <) to compare the values. > and < require the placeholder and the value that it is being compared to, to be a number.

    Format: papi %placeholder% >/=/< <someValue> <Fail message>

    Examples:
    Rank requires player to have more than $1,000 balance
    'papi %vault_eco_balance% > 1000 %prefix% &cYou need atleast &e$1,000 &cto rankup.'

    Player needs to be in survival mode to rankup
    'papi %player_gamemode% = SURVIVAL %prefix% &cYou need to be in &eSurvival &cgamemode to rankup!'​
    • ...(More can be added in future versions! If you have a specific requirement in mind, feel free to post your idea in the discussion page, PM me or join the support discord.)
    Planned to be added:
    • Custom Items
    Currently supported rewards:
    • Any command (Allows the reward to be almost anything)
    • Broadcast
    • Message

    Installation:
    1. Download the plugin, place it in your plugins folder & start the server
    2. Run the command '/rankmeup setup <rows> <RankAmount>' ingame (Optional)
    3. Design the GUI & save (Optional)
    4. Finish the designing by configuring the ranks & fillers in ranks.yml (Optional)
    5. Reload the plugin config files with /rankmeup reload (Only needed if values in the configuration files has been changed.)
    6. Assign your groups the permissions nodes 'rankmeup.rank.<order>'
    7. Done!
    Code (YAML):

    #
    # ------------ [ General Configuration ] ------------
    #
    # 1.16+ only!
    # Create new custom colors for the plugin to use. Color-codes have to be
    # in proper HEX format. Example: #0099cc. Use the custom colors in messages
    # by using <colorName>, example: '<bl1>This is an example message'
    #
    customColors
    :
      bl1
    : '#0099cc'
      bl2
    : '#66d9ff'
      bl3
    : '#e6f9ff'
    #
    # Toggle whether players with the highest rank can open the /rankmeup GUI
    #
    disableGUIForMaxRank
    : false
     
    Code (YAML):

    #
    # ------------ [ Message Configuration ] ------------
    #
    # Color-codes defined in config.yml can be used here.
    # Messages currently only support the placeholder: '%prefix%'
    #
    prefix
    :
     - '&f{&9Rank&3Me&bUP&f}'
    ranksGuiTitle
    :
     - '&b▶ &9Rankup Selection Menu'
    confirmGuiTitle
    :
     - '&b▶ &9Confirm Your Rankup'
    rankUnlocked
    :
     - '&e&lUnlocked'
    rankAvailable
    :
     - '&a&lAvailable'
    rankLocked
    :
     - '&c&lLocked'
    rankConfirm
    :
     - '&a&lConfirm'
    rankCancel
    :
     - '&c&lCancel'
    rankNotAvailable
    :
     - '%prefix% &cThis rank is not yet available for you.'
    rankAlreadyUnlocked
    :
     - '%prefix% &cYou''ve already unlocked this rank.'
    missingItems
    :
     - '%prefix% &cYou do not have &e%item% &cin your inventory.'
    missingPlaytime
    :
     - '%prefix% &cYou need to play &e%playtime% &chours more.'
    alreadyMaxRank
    :
     - '%prefix% &cYou already have the highest rank.'
    rankupFailed
    :
     - '%prefix% &cYou failed to rankup.'
    commandLocked
    :
     - '%prefix% &cThis command is currently locked. Please contact the administrators.'
    reloaded
    :
     - '%prefix% &cConfigs have been reloaded.'
    errorInConfig
    :
     - '%prefix% &4YOU HAVE AN ERROR IN YOUR CONFIGURATION, PLEASE CHECK CONSOLE!'
    noPermissions
    :
     - '%prefix% &cYou do not have permissions to do that.'
     
    Code (YAML):

    #
    # ------------ [ Ranks GUI Configuration ] ------------
    #
    # Define how big the Inventory is: [9,18,27,36,45,54]
    inventorySize
    : 27
    #
    # ------------ [ Ranks Configuration ] ------------
    #
    # To label your desired group with the rank, give the group permission 'rankmeup.rank.<order>'
    #
    # Ranks will be generated with the following logic:
    # - 1 | Number of the rank will define the order of the rank ups. Example: Rank 1 can only rank up to rank 2
    # - name | The displayname of the rank
    # - slot | Which slot the rank item will be placed to. (Make sure the slot is within the inventorySize)
    # - material | Must be a proper material, not air. Here's a list of materials:
    #   1.16 -> https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
    #   1.15 -> https://helpch.at/docs/1.15.2/index.html?org/bukkit/Material.html
    #   1.14 -> https://helpch.at/docs/1.14.4/index.html?org/bukkit/Material.html
    #   1.13 -> https://helpch.at/docs/1.13.2/index.html?org/bukkit/Material.html
    #   1.12 -> https://helpch.at/docs/1.12.2/index.html?org/bukkit/Material.html
    # - lore | This is where you can design your rank item lore/description
    # - requirements | What are the requirements for the rankup. Currently supported:
    #      Default: item <material> <amount> | playtime <time in hours>
    #      Requires additional plugin: (Optional)
    #         PlaceholderAPI:
    #            plugin: https://www.spigotmc.org/resources/placeholderapi.6245/
    #            usage: papi <placeholder> (</=/>) <value> <Failure Message>
    #            example: papi %vault_eco_balance% > 1000
    # - rewards | These are ran when player ranks up successfully.
    #             Currently supported: (command <command without the '/'>, broadcast <message>, message <message>)
    #
    ranks
    :
      1
    :
        name
    : '&7Guest'
        slot
    : 10
        material
    : 'COAL_ORE'
        lore
    :
         - '&e&m                                '
          - '&f&lRequirements'
          - ' &a> &720x Cobblestone'
          - ' &a> &720h Playtime'
          - '&f&lRewards'
          - ' &a> &7Epic reward #1'
          - ' &a> &7Epic reward #2'
          - ' &a> &7Epic reward #3'
        requirements
    :
         - 'item cobblestone 20'
          - 'playtime 20'
         # - 'papi %player_gamemode% = survival %prefix% &cYou need to be in gamemode &eSurvival &cto rankup!'
         # - 'papi %vault_eco_balance% > 10000 %prefix% &cYou need atleast &e$1,0000 &cto rankup!'
        rewards
    :
         - 'command say %player% ranked up from %currentrank% to %nextrank%'
          - 'broadcast %player% ranked up from %currentrank% to %nextrank%'
          - 'message You ranked up from %currentrank% to %nextrank%'
         # - 'eco take %player% 10000'
      2
    :
        name
    : '&eMember'
        slot
    : 13
        material
    : 'GOLD_ORE'
        lore
    :
         - '&e&m                                '
          - '&f&lRequirements'
          - ' &a> &720x Cobblestone'
          - ' &a> &720h Playtime'
          - '&f&lRewards'
          - ' &a> &7Epic reward #1'
          - ' &a> &7Epic reward #2'
          - ' &a> &7Epic reward #3'
        requirements
    :
         - 'item cobblestone 20'
          - 'playtime 20'
        rewards
    :
         - 'command say %player% ranked up from %currentrank% to %nextrank%'
          - 'broadcast %player% ranked up from %currentrank% to %nextrank%'
          - 'message You ranked up from %currentrank% to %nextrank%'
      3
    :
        name
    : '&bVIP'
        slot
    : 16
        material
    : 'DIAMOND_ORE'
        lore
    :
         - '&e&m                                '
          - '&f&lRequirements'
          - ' &a> &720x Cobblestone'
          - ' &a> &720h Playtime'
          - '&f&lRewards'
          - ' &a> &7Epic reward #1'
          - ' &a> &7Epic reward #2'
          - ' &a> &7Epic reward #3'
        requirements
    :
         - 'item cobblestone 20'
          - 'playtime 20'
        rewards
    :
         - 'command say %player% ranked up from %currentrank% to %nextrank%'
          - 'broadcast %player% ranked up from %currentrank% to %nextrank%'
          - 'message You ranked up from %currentrank% to %nextrank%'
    #
    # ------------ [ Filler Configuration ] ------------
    #
    # Fillers will be generated with the following logic:
    # - name | Displayname of the filler item
    # - material | Must be a proper material, not air. Here's a list of materials:
    #   1.16 -> https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
    #   1.15 -> https://helpch.at/docs/1.15.2/index.html?org/bukkit/Material.html
    #   1.14 -> https://helpch.at/docs/1.14.2/index.html?org/bukkit/Material.html
    #   1.13 -> https://helpch.at/docs/1.13.2/index.html?org/bukkit/Material.html
    #   1.12 -> https://helpch.at/docs/1.12.2/index.html?org/bukkit/Material.html
    # - slots | To which slots this filler will be places. (Make sure the slots are within the inventorySize)
    # - command | (Optional) When player clicks on a filler item, runs a command. Usage: <console/player> <command without />
    #
    fillers
    :
      1
    :
        name
    : '&f&l! <bl3>Information &f&l!'
        material
    : 'BEACON'
        lore
    :
         - '&b&m                                '
          - '&fIn order to rankup'
          - '&fyou need to meet'
          - '&fthe requirements of'
          - '&fthe available rank'
          - '&b&m                                '
        slots
    : '4'
      2
    :
        name
    : '&c&lBack'
        material
    : 'REDSTONE_BLOCK'
        lore
    :
         - '&c&lGo back'
        slots
    : '22'
        command
    : 'console say Clicked back button!'
     

    PLEASE DO NOT LEAVE BUGS/PROBLEMS TO THE RATINGS. CONTACT ME EITHER HERE BY SENDING ME A PM OR JOIN THE SUPPORT DISCORD. THANK YOU!

    Images

    1. 1.png
    2. 2.png
    3. 3.png
    4. 4.png

Recent Reviews

  1. PepijnGamer
    PepijnGamer
    3/5,
    Version: 0.3-ALPHA
    It's a good concept, but has yet to be finished. The plugin itself is full of bugs. Like, I can't even allow my players to actually rank up when purchasing a rank through this plugin. It's a pity, because the concept is good.

    I hope that you'll continue development, add more customization options and squeeze out the bugs, when all that is done, it'll be a great plugin for sure! :)
    1. Jeqqe_
      Author's Response
      Thanks for the review. The bug where commands wont run properly will be fixed in the update I'm releasing later today along with some new features aswell.
  2. Almighty951
    Almighty951
    5/5,
    Version: 0.2-ALPHA
    It has good support greetings ;D do not forget to put a locale in Spanish would be useful for many