Bukkit

This is a simple plugin that can display an online staff list and/or a full staff list, depending on how you decide to set it up. There are many similar plugins, but this one has more configuration options than most other ones out there. Note: This plugin requires Vault to run the full staff list, otherwise you can only use the online staff list.

Commands:

• /staff - the main command used for displaying the staff list, it can be set to the full list or the online list in the configs
• /staff list - displays the full staff list
• /staff online - displays the online staff list
• /staff reload - reloads the StaffList configs

Permissions:

There are three permissions that never will change, and those are:

• StaffList.list - allows players to use the '/staff list' command
• StaffList.online - allows players to use the '/staff online' command
• StaffList.reload - allows players to use the '/staff reload' command

all other permissions are defined in the config.yml, but their main setup is:

• StaffList.staff.<staffrank>

Setup and Configuration:

If you drop the .jar into your plugin folder, then reload your server, it will be ready to run with the default configuration setup already. The default configuration has 4 ranks, Owner, Admin, Mod, and Intern, but these can be customized to fit your server's needs.

General configs

defaultcommand: 'online'
listheader: '&6Staff:'
onlineheader: '&6Online Staff:'
customnames: false
hideoffline: true
hideempty: true

• 'defaultcommand' can either be set to 'online' or 'list' and this determines what the /staff command by itself will default to, either '/staff online' or '/staff list'
• 'listheader' will be the text to display before the full list of staff. This supports colors with the & symbol
• 'onlineheader' will be the text to display before the online list. This also supports colors with the & symbol
• 'customnames' determines if you have a plugin to change display names, and want them to be used on the staff list.
• 'hideoffline' will stop the plugin from displaying a staff rank in the online list if no one from that rank is currently online.
• 'hideempty' will stop the plugin from displaying a staff rank in the full list if no player has that staff rank.

Staff Ranks

ranks:
  intern:
    rank: 4
    listing: '&2Intern@PLURALS: &a'
  mod:
    rank: 3
    listing: '&6Mod@PLURALS: &e'
  admin:
    rank: 2
    listing: '&5Admin@PLURALS: &d'
  owner:
    rank: 1
    listing: '&1Owner@PLURALS: &b'

Here you define what staff ranks you have, and in what order they should appear on the staff list. You can have as many staff ranks as you want, as long as you follow the format.

• the intern, mod, admin, and owner parts should be replaced with whatever you want your staff ranks to be called. This will also name the permissions.
• rank is the order that the staff ranks appear in the chat. The lowest number appears first, and the highest number appears last, so it will be at the bottom.
• listing is what appears before the list of names on the same line. This can use color codes.
• In the listing section, you can also add '@PLURALS' which will be replaced by an 's' if there are more than one players in that listing. With the default as an example, 'Mod@PLURALS:' would appear as Mod: player1 if player1 is the only one in that rank, and Mods: player1, player2 for having multiple players in that group

Permissions Setup

After you have your ranks set up in the config, you can now make players appear on the staff list by giving them the permission for that staff group. If you have defined the rank 'admin' then you would give them the permission 'StaffList.staff.admin'

Dependencies

Right now, there are two plugins that it can hook into.

• Vault - this will enable the /staff list command.
• Essentials - it will work with the /vanish command and permissions in essentials to hide hidden players from the list.