Enhanced BalTop

TESTED ON CraftBukkit/Spigot 1.7 - 1.12

PLEASE DON'T FORGET TO RATE THIS PLUGIN ! ;)

Description:

Fully customizable and enchanced /baltop replacement command (continues where Essentials left off!) with holographic balance boards. (Uses Holographic Displays plugin).

new v1.3 default /baltop output:-


v1.0-v1.2 default /baltop output : (defaults to page 1):-

/baltop 2 output (Showing you page 2 of 5)

/baltop holograms (Showing you page 1 and page 2 out of Top 30 balances):-

(Version 1.3 default)

(Version 1.2 default or below)

Commands:-

/baltop [<pageno>]
Displays text based baltop board, one page at a time. You can list which page number with the optional <pageno> parameter.
(executable by: console/player)

/baltop topnbal <numberofplayers>
Sets the text based baltop board to display Top <numberofplayers> Balances, one page at a time. Pages default to 10 players, but can be changed in the config file.

Balance Boards are immediately reset to Page 1.
(executable by: console/player)

/baltop exclude list
Lists players added to the permanent exclusion list stored in the config file. If displayuuid is true|yes in config.yml then it will display the player's UUID.
.(executable by: console/player)

/baltop exclude add <playername>|<playeruuid>
Add player <playername> or <playeruuid> to the permanent exclusion list and adds it to the config file.
(executable by: console/player)

/baltop exclude remove <playername>|<playeruuid>
Remove player <playername> or <playeruuid> from the permanent exclusion list and removes it to the config file.
(executable by: console/player)

/baltop holotopn <numberofplayers>
Sets Default TopN value to <numerofplayers> initially used when creating new holographic display boards.
(executable by: console/player)

/baltop hologram list
Lists existing holographic balance board details with their respective location (world/XYZ coords), update interval and board template file used.
(executable by: console/player)

/baltop hologram movehere <hologramname>
Moves/relocates hologram <hologramname> to player's current location.
(executable by: player)

/baltop hologram add <hologram_name> [interval] [board_filename]
Creates permanent hologram balance board <hologramname> at the players current location.
You can optionally special the interval in seconds on how ofter the board is updated, default interval of 30seconds is used if omiited.
Also you can optionally specify which balance board template file is used to create the hologram, default.yml is used if this parameter is omitted.
(executable by: player)

/baltop hologram remove <hologramname>
Removes hologram balance board <hologramname> from its current location.
(executable by: console/player)

/baltop hologram topn <hologram_name> <top_n_players>
Set's Top N players for hologram balance board < hologram_name> to < top_n_players>.

/baltop reload
Reloads plugin and config - This does not disable/remove any of the existing hologram balance boards.

Dependancies:-

Required:
Vault (For economy and permissions)
http://dev.bukkit.org/bukkit-plugins/vault/

Optional:
Holographic Displays (for holograms)
http://dev.bukkit.org/bukkit-plugins/holographic-displays/

Clip's PlaceholderAPI (for external plugin placeholder variables)
https://www.spigotmc.org/resources/placeholderapi.6245/

config.yml:-

enable: true
checkupdates: true
displayuuid: true
cmdaliases:
- 'ebaltop'
- 'ebt'
- 'bt'
deftopn: 100
pagesize: 10
excludepermnode: EnhancedBalTop.baltop.excludeplayer
usemoneydenominations: true
decimalplaces: 2
dateformat: dd-MM-yyyy HH:mm
excludedays: 30
placeholderempty: ''
header:
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '&e{servername} &f{date}'
- '&6Top &a{topnbal} &6Balances For Last &a{excludedays}&6 days'
- '&6High Bal: &e{maxbalplayer}&e - &a$&f{maxbalvalue}'
- '&6Low Bal: &e{minbalplayer}&e - &a$&f{minbalvalue}'
- '&6Offline Players: &a{totalofflineplayers}&6, Online Players: &a{totalonlineplayers}'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
detail:
- '&6{lineno}: &f&l{player} &6has &a$&f{balance}'
- '&6{lineno}: UUID: &a{uuid}'
footer:
- '&e---- Page &6{pageno} &eOf &6{totalpages} &e----'
holotopn: 100
holopagesize: 10
holoupdateinterval: 30
holoheader:
- '{icon:DIAMOND}'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '&e{servername} &f{date}'
- '&6Top &f{topnbal} &6Balances For Last &a{excludedays}'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
holodetail:
- '&6{lineno}: &f&l{player} &6has &a$&f{balance}'
holofooter:
- '&e---- Page &6{pageno} &eOf &6{totalpages} &e----'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '&6Enhanced&eBalTop &f(C) 2016 &1&lL&2&lO&3&l&lZ&4&lZ&c&lSoft'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '{icon:DIAMOND}'
excludedplayers: []

config.yml Explanation:-

Whilst some options are self-explanatory, information for the less obvious config options below:-

displayuuid: Enables display of Player UUID's for COMMANDS ONLY such as /baltop exclude....
If you're using the default config, then UUID's are displayed for player balances in the text based balanced boards via /baltop command. To disable this, remove the following line from config.yml:-
- '&6{lineno}: UUID: &a{uuid}'

cmdaliases: Add multiple command override aliases (these should override any existing commands should you pick a command alias that already exists). e.g. 'ebaltop' will override Essentials ebaltop and run /baltop instead!

deftopn: Sets the total number of player balances displayed for text based /baltop balance boards.

pagesize: Sets the number of players listed per page. Don't set this too high otherwise your text output will scroll for long player lists (if set by deftopn) !

excludepermnode: Custom permission node also used for excluding players in addition to the /baltop exclude based commands.
This works with most permission plugins (PEX, bPermissions, GroupManager etc) as supported by Vault permissions.

usemoneydenominations: If set to true, balances will use the following denomations/notation:-
K, M, B, T, Q, QT, S, SP
Set to false to disable and use normal notation

decimalplaces: Set number of decimal places balance/money value is rounded to. E.g. default is 2,: If player has balance say $100.268 will be displayed as $100.27.

dateformat: dd-MM-yyyy HH:mm
Standard Java date format for header/footer/detail config lines containing {date} variable in config file.

excludedays: Set number of days to exclude old player balances via their lastloggedin date/time. This defaults to 30 meaning any player balances over 30 days old/not logged in for over 30 days will be excluded.
Set this to 0 to disable this feature.

placeholderempty: String to display if placeholderapi string wrapped with % (e.g. %statistic_player_kills%) returns empty string or unresolved. Defaults to ''

holotopn: Sets the total number of player balances displayed for holographic based /baltop balance boards.

holopagesize: Sets the number of player balances listed per page for holographic based balance boards. Default is 10 players

holoupdateinterval: Sets the update interval in seconds for all the holographic balance boards. If they span across multiple pages, it will cycle through each page, one per update.

Edit the relevant Header, Detail and Footer keys to customise your Text based /baltop and hologram balance boards....

Header & Footer (text /baltop and holograms) keys

The headers and footer config lines for text based /baltop and holographic balance boards can have multiple lines as can be seen by the config,

They also support single line holographic icons/itemlines (as per holographic displays spec) using the {icon:xx} variable.

Detail (text /baltop and holograms) keys

Multiple details line which are normally used to display the player name and their associated balance.

All color coding and formatting codes support using & prefix.

messages.yml (v1.3+ only!):-