Styled Player List

Transform the appearance of your Minecraft server's player list with this convenient mod! Styled Player List provides complete control over the design of the online players table, allowing you to create unique styling that matches your project's theme.

Important note: the mod is compatible exclusively with Fabric and Quilt!

Key Features

The mod offers a rich set of customization features:

• Configuration of player list headers and footers
• Permission system support for different user categories
• Integration with Placeholder API for dynamic content
• Ability to override displayed player names
• Multiple ready-to-use design styles to choose from

Command Management

The following commands are available for managing settings:

• /styledplayerlist - main management command (permission: styledplayerlist.main, available by default)
• /styledplayerlist reload - reload configuration and styles (requires styledplayerlist.reload)
• /styledplayerlist switch <style> or /plstyle <style> - change current design style (permission: styledplayerlist.switch, available by default)
• /styledplayerlist switchothers <players> <style> - change style for other players (requires styledplayerlist.switch.others)

Configuration Settings

Configuration files are located in the ./config/styledplayerlist/ folder. Some parameters support dynamic predicates (marked as {/ PREDICATE /}).

{
  // Configuration version - do not change this setting
  "config_version": 2,
  // Default style identifier
  "default_style": "default",
  // System message settings
  "messages": {
    "switch": "Player list style changed to: <gold>${style}</gold>",
    "unknown": "<red>This style doesn't exist!</red>",
    "no_permission": "<red>You don't have sufficient permissions!</red>"
  },
  // Player name display settings
  "player": {
    // Enable name modification
    "modify_name": false,
    // Hide names from player list
    "hidden": false,
    // Use standard formatting
    "passthrough": false,
    // Name display format
    "format": "%player:displayname%",
    // Update when sending messages
    "update_on_chat_message": false,
    // Periodic update in ticks (-1 disables)
    "update_tick_time": -1,
    // Custom styles
    "styles": [
      {
        // Style application conditions
        "require": {/ PREDICATE /},
        // Formatting
        "format": "...",
        // Use standard formatting
        "passthrough": false,
        // Hide name from list
        "hidden": false
      }
    ]
  },
  // Display list in singleplayer
  "client_show_in_singleplayer": true
}

Creating Styles

You can create your own design styles by placing files in the ./config/styledplayerlist/styles/ directory and using the /styledplayerlist reload command to apply them.

{
  // Style application conditions
  "require": {/ PREDICATE /},
  // Style name for display
  "style_name": "Default",
  // Update interval in ticks (20 = 1 second)
  "update_tick_time": 20,
  // Player list header
  "list_header": [
    "...",
    "..."
  ],
  // List footer
  "list_footer": {
    // Frame change frequency
    "change_rate": 1,
    // Sequence of displayed text
    "values": [
      [
        "<red>..."
      ],
      [
        "<blue>..."
      ]
    ]
  },
  // Hide style in command autocompletion
  "hidden_in_commands": false
}