Advertisement
Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- #v0.2.0
- #author: BlockyBorzan
- #compatible with MC 1.13
- #DISCLAIMER:
- #THIS IS NOT A PERMISSION PROVIDER, MERELY A PLUGIN TO HELP WITH RANKING UP PLAYERS ALONG PREDEFINED
- #RANK PATH. IT REQUIRES VAULT, AN ECONOMY AND A PERMISSION PROVIDER TO WORK!
- # supported are 'yml', 'mysql' and 'sqlite'. mysql is recommended.
- # use 'none' to not store any player rank data. Storing user rank
- # data can reduce lag on the server, however if another plugin
- # changes user ranks, this might pose problems.
- storage-type: 'none'
- # mysql connection data (only relevant if storage-type is 'mysql')
- # (the database has to exist beforehand in order to use mysql storage
- # however all tables are created automatically)
- mysql:
- host: 'host'
- database: 'database'
- port: 'port'
- user: 'user'
- password: 'password'
- table_prefix: 'ranks_'
- # DEFINE MESSAGES SENT TO PLAYERS HERE
- # you can use {rank} to represent the name of the new rank. The name is derived from the rank tree and
- # converted into a CamelCase String with spaces (e.g. god_emperor becomes God Emperor).
- # you can also use chat color codes in combination with the ampersand character ('&').
- # Leave the options empty ('') in order to not send any messages.
- # supported placeholders are {player}, {nickname} and {rank}. More will probably be added in the future.
- messages:
- # Sent only to the player on rankup
- player-rankup: '&3Congratulations! You just ascended to the rank of &6{rank}&3!'
- # Broadcast to the whole server. If player-rankup is defined (not empty or missing),
- # the player who just ranked up will not receive this message because they already
- # receive the player-rankup message.
- rankup-broadcast: '&3Congratulations to &6{nickname}&3 for ranking up to &6{rank}&3!'
- # Message sent to players who reached a rank that can not rank up any higher
- # (Last rank on any branch that has no successors)
- highest-rank-reached-err: '&5 As &6{rank}&5, you have already reached the highest rank and can not rank up any further. Congratulations!'
- # Error message sent to players when they try to rankup, but their new rank could not be saved
- # using the specified storage-type. The rankup is not successful in this case (rankup-unsuccessful will also be sent)!
- saving-rank-err: '&4Something went wrong and your new rank was not saved.'
- # Sent to players who try to rankup, but do not have a rank on the rank tree.
- # NO PLACEHOLDERS ARE SUPPORTED ON THIS MESSAGE!
- no-rank-on-tree-err: '&cUnfortunately you do not have any ranks that match the rank tree. Please contact a staff member if you think this is a mistake.'
- # Error message sent to players when they try to rankup, but an error in the code of any
- # unexpected kind happens. The rankup is not successful in this case (rankup-unsuccessful will also be sent)!
- # NO PLACEHOLDERS ARE SUPPORTED ON THIS MESSAGE!
- exception-err: '&4An error has occured, please try again or contact staff about it if the problem persists.'
- # Message sent to players when their rankup was unsuccessful.
- # NO PLACEHOLDERS ARE SUPPORTED ON THIS MESSAGE!
- rankup-unsuccessful: '&cUnable to rank up.'
- #
- # DEFINE YOUR RANK TREE HERE
- #
- # This is the default rank each player on your server should have when they join.
- # This rank is considered the root of the rank tree (see below)
- # This rank has no predecessors, rankup requirements or rankup messages (see below)
- default-rank: 'default'
- # The default rank is the beginning of the first branch. You can name this branch so the ranks gui
- # shows the branch name instead of the rank name as the title of the navigation item.
- default-rank-branch-name: 'Aristocracy'
- # A few things to pay attention to and consider:
- # - specify your tree by listing all ranks in it
- # - a player is only allowed to have one rank on this tree at one time.
- # (If you grant a player more than one rank on this tree via for example commands, the rankup will look for the
- # highest rank (deepest in the tree) the player has, or choose one at random if two ranks are on an equal level)
- # - multiple predecessors to ranks are supported, simply list them all inside []
- # - only one rank tree is supported and only 5 rank predecessors/successors are allowed per rank
- # (this limitation is due to the gui, I plan to change this in the future but for now it is what it is, sorry.)
- # - only 36 ranks are allowed per branch. (this limitation is also due to the gui and probably won't change in the future...)
- # ***NOTE: a branch is defined as a series of ranks that each have one and only one successor/predecessor.
- # the start of a branch is either the default rank, or the first rank in the series with more than one predecessors
- # the end of a branch is either the last rank in the series, or the first rank with more than one successors
- # this definition of branch holds true wether you name it or not.
- # - if the no predecessors are specified, the predecessor is automatically chosen as the
- # previous rank in the list.
- # - all mentioned predecessors must be specified in the list (or be the default rank) before setting them as predecessors
- # - at least one rank in the tree has to specify the default-rank as its predecessor. If none do, the tree will only consist of
- # the default-rank as no other ranks are descendants.
- # - you can specify a 'rankup-message' that will be displayed on the rankup ui when ranking up to that rank.
- # - you can specify a 'branch-name' at the start of a new branch (usually only when you specify predecessors).
- # this will be displayed when players use the /ranks command to list all ranks. This is only relevant when one
- # rank branches out into more than one other rank in terms of inheritance.
- # - you can specify a 'gui-material' for each that corresponds to one of the org.bukkit.Material enumerators found
- # here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html. Supported Materials include all of the following:
- # concrete, concrete powder, stained glass, stained glass panes, wool. The character case is not important.
- # By default and if no other material or any unsupported material is specified,
- # the material chosen is a colored concrete block chosen at random.
- # - you can specify 'rank-perks' which explain which perks the particular rank has. Note that this does not provide
- # the perks themselves. It merely displays information you choose to disclose to your players.
- # Rankup criteria:
- # - the money-cost requirement is the amount of money a player has to pay to rankup (0 to disregard)
- # - the xp-cost requirement is the amount of xp (in levels) a player has to pay to rankup (0 to disregard)
- # - the min-play-time requirement is the amount of time a player has to spend playing on the server (0 to disregard)
- # it supports shorthand notation:
- # y... years (really? like... really?)
- # w... weeks
- # d... days
- # h... hours
- # m... minutes
- # s... seconds
- # for example, 1d6h2m40s would equal to 1 day, 6 hours, 2 minutes and 40seconds. 600s would equal to 600 seconds or 10 minutes.
- # (just entering a number is fine as well, they are interpreted in seconds. e.g. 604800 is equal to 7d (7 days))
- # - leaving out any of the criteria will default it to 0 and therefor it will be disregarded for that rank
- # - the min-mcmmo requirement is the amount of McMMO levels a player must have to rankup (none will be deducted, 0 to disregard)
- # THIS IS AN EXAMPLE RANK TREE:
- #ranks:
- # knight:
- # money-cost: 100
- # xp-cost: 10
- # min-play-time: 10m
- # min-mcmmo: 0
- # predecessors: ['default']
- # gui-material: 'light_gray_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # earl:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # gui-material: 'gray_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # king:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # gui-material: 'light_gray_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # #empire branch
- # emperor:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # predecessors: ['king']
- # branch-name: 'Empire'
- # gui-material: 'lime_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # god_emperor:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # gui-material: 'green_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # #angelic branch
- # angel:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # predecessors: ['king']
- # branch-name: 'Angelic'
- # gui-material: 'light_blue_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # archangel:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # gui-material: 'blue_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- #
- #
- # #divine branch
- # demigod:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # predecessors: ['archangel', 'god_emperor']
- # branch-name: 'Divine'
- # gui-material: 'yellow_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
- # god:
- # money-cost: 0
- # xp-cost: 0
- # min-play-time: 0
- # min-mcmmo: 0
- # gui-material: 'orange_concrete'
- # rank-perks:
- # - Perk 1
- # - Perk 2
- # - Perk 3
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement