PrefixedPlayerlist

PrefixedPlayerlist

Bukkit Plugins
23.6k Downloads

Prefixed Playerlist takes prefixes (colors, text or colored text) from its config or PermissionsEx and displays them in the scoreboard / player list (invoked by TAB ingame). You don't need any additional plugins (PEX is optional).

Default Config | Example Setup | Change Log

Features

  • Define prefix for server OPs
  • Players in different game modes can be distinguished
  • There are commands to reload configuration, reload the playerlist and get information about the plugin
  • There is a default prefix if you want to prefix all names
  • The plugin takes advance of Bukkit Permissions
  • PermissionsEx prefix support

Commands

Every command can start with /ppl or /playerlist. You can use native command /help PrefixedPlayerlist for your own convenience.

  • /ppl or /ppl help points you to look at /help PrefixedPlayerlist
  • /ppl version shows basic information about the plugin
  • /ppl reload softly reloads plugin configuration (without re-reading plugin jar file)
  • /ppl checkupdate manually checks for updates
  • /ppl refresh refreshes the player table

Permissions

Note that there are not-that-much permissions starting with prefixedplayerlist.prefix.* that are used to assign prefixes and nothing else. They are explained elsewhere - take a look at example setup.

  • prefixedplayerlist.* Gives full control over all commands of PrefixedPlayerlist
  • prefixedplayerlist.reload Allows you to reload the plugin (/ppl reload)
  • prefixedplayerlist.checkupdate Allows you to check for new versions manually (/ppl checkupdate)
  • prefixedplayerlist.refresh Allows you to refresh the player list (/ppl refresh)

How prefixes stack

  1. If you use PrefixedPlayerlist config to define prefixes
    • prefixCreative + prefixOp + prefixDefault + prefixCustom + PlayerName
  2. When you use PermissionsEx to define prefixes
    • prefixCreative + prefixOp + prefixDefault + PEXprefix + PlayerName

Additional notes

Important notes and information:

  • Keep in mind that max. length of player name is 16 characters. This is a client-side limit.
    • Each color takes 2 characters (see below).
    • PPL inserts one color (two characters) at the end of each name to keep ping color unchanged
    • When playername is too long, it gets stripped to 13 characters, and … (triple-dot glyph, ellipsis) is added at the end (along with the color reset for ping).
    • The length of a prefix is limited to 10 characters by the plugin,
      • although it is wise to keep the overall length of prefix (count with op, gamemode, etc.) under 4 characters. You don't want to see MyNicePrefix:A… (with A being the only part of players name visible)
  • You can define colors using the control characters § (paragraph), or & (and).
    • Colors are defined by the control character and number from 0 to 9 or letter a-f. The text following this control sequence is affected.
      • You can use formatting characters if you want (things like bold, underline, etc. See MP wiki page for details)
  • Every player may have only one custom prefix. Priority has the group first defined in the config. Therefore it is a great idea to start with prefix for administrator, then moderator, then some special player groups, etc.
    • Why? Your admin will probably inherit the "prefix permission" of moderators, and you want to have him prefix of admin, not mod.
  • If you decide not to use some of the predefined prefixes (gamemodes, op), you can either leave the apostrophes blank or remove the whole definition
  • When you op or deop someone, the change can be seen only after relog (or after plugin reload), not immediately.
    • There is now a refresh command for the table, just use /ppl refresh
  • Plugin checks if it is up to date every time it is enabled. Your server IP and plugin version are logged at that time. It's just for me to keep approximate number of users.
    • This can be disabled in config by setting options.checkVersion to false
    • You can check for updates manually using /ppl checkupdate
  • I really appreciate feedback, so feel free to leave a comment! :)

Known Bugs

There are no known bugs at the moment.

Todo & Feature Requests

  • Base the plugin around custom, easily formattable strings
  • Add hiding in the list
  • Add more commands (to hide, change the name, etc.)
  • Allow coloring the ping
  • Mark self with different color impossible, waiting for official mod API