OnlineList: The Ultimate Player List Plugin for Minecraft Servers
Running a Minecraft server is a rewarding experience, but keeping things organized can quickly become a headache. The vanilla /list command is functional yet painfully basic — it dumps every online player into a single, unformatted line. If your server uses permission groups like Owner, Admin, Moderator, and default players, that flat list tells you nothing about who is who. OnlineList changes the game entirely. This lightweight Bukkit/Spigot plugin transforms the player list into a structured, colorful, and fully customizable display that respects your server’s hierarchy.
What is OnlineList?
OnlineList is a server-side plugin designed to replace the default player listing with a group-aware, permission-based overview. Instead of a messy string of usernames, you get a clean breakdown: each permission group appears in a defined order, with its own alias, prefix, suffix, and color formatting. Players are neatly sorted under their respective groups, making it instantly clear who holds which rank. The plugin is built around Vault, the standard permissions API, so it works seamlessly with any major permissions plugin like LuckPerms, PermissionsEx, or GroupManager.
Key Features at a Glance
- Lists all online players organized by their permission group
- Fully configurable group aliases — rename “default” to “Members” or anything you like
- Customizable group sorting order, from highest rank to lowest
- Individual prefixes and suffixes for both players and groups
- Full color and formatting code support using ampersand notation
- Adjustable messages for errors, player count, and reload confirmations
- Lightweight and easy to reload without restarting the server
- Built-in version checker to notify admins of updates
Installation and Setup
Manual Installation
Getting OnlineList onto your server is straightforward. First, make sure you have Vault installed — it’s the bridge between the plugin and your permissions system. Then download the OnlineList jar file and place it into your server’s plugins folder. Restart the server or run a plugin reload command to generate the default configuration. Once the config file appears, you can tweak it to match your server’s groups and style. After making changes, use /listreload to apply them instantly without downtime.
Quick Setup via FoxyGame Launcher
If you’d rather skip the manual file management, the foxygame.net launcher provides a modern, flexible way to handle your server’s mods and plugins. You can browse and install OnlineList directly from its built-in menu, saving time and reducing the chance of misplacing files. This launcher streamlines the entire process, making it especially handy for server owners who juggle multiple plugins and want a centralized, user-friendly interface.
Configuration Deep Dive
The true power of OnlineList lies in its config file. Every visual and structural aspect of the player list can be tailored. Let’s break down the most impactful settings.
Group Aliases and Sorting
By default, the plugin uses the raw permission group names. With the Aliases section, you can map “default” to “Users”, “mod” to “Moderators”, or any label that fits your server’s theme. The GroupSort list then dictates the order in which these groups appear. Unlisted groups automatically fall to the bottom, so you only need to define the ones you want at the top. A typical setup might look like:
- Owner
- Admin
- Moderator
- default (aliased as “Players”)
This ensures that when someone types /list, the most important ranks are seen first.
Prefixes, Suffixes, and Colors
OnlineList supports Minecraft’s classic color codes using the ampersand (&) symbol. You can set a PlayersPrefix like &6 (gold) to make every username shine, and a GroupsPrefix to color the group label itself. Suffixes work the same way, allowing you to add decorative characters or extra formatting after names and groups. The result is a vibrant, easy-to-read list that matches your server’s chat style.
Custom Messages
Every message the plugin sends can be rewritten. The PlayersOnline message, for example, includes the %players_online% placeholder to show the total count. You can change the error message for unauthorized users, the reload confirmation, and even the divider that separates player names within a group. This level of control means OnlineList feels like a native part of your server, not a generic add-on.
Commands and Permissions
OnlineList keeps things simple with just two commands and a handful of permission nodes.
- /list — Displays the formatted online player list. Requires
onlinelist.use(default true for everyone). - /listreload — Reloads the configuration without a full server restart. Requires
onlinelist.reload.
Additional permissions include onlinelist.* for full access and onlinelist.version to receive update notifications. The permission structure is minimal, so it won’t clutter your permissions file or cause conflicts with other plugins.
Why Your Server Needs OnlineList
Beyond aesthetics, a well-organized player list improves server management and player experience. Staff can quickly see which admins are online to handle issues. New players immediately understand the server’s hierarchy, which reduces confusion and repetitive questions. The group sorting also subtly reinforces your community’s structure, making ranks feel more meaningful. And because the plugin is so lightweight, it won’t impact server performance even on large networks.
OnlineList has evolved steadily since its initial release in August 2015. Version 1.1 introduced group aliases and richer config options, while version 1.2 added group sorting, more permissions, and a version checker. The developer openly welcomes suggestions for future features, so the plugin can grow alongside your server’s needs. A video preview by Unity Pixel is available to see the plugin in action before you install it.
Conclusion
OnlineList is a small plugin with a big impact. It takes the mundane task of listing online players and turns it into a polished, informative feature that reflects your server’s identity. With Vault integration, deep configuration options, and a straightforward command set, it fits into any existing setup without friction. Whether you install it manually or through a convenient launcher like foxygame.net, you’ll wonder how you ever managed with the vanilla /list command. Give your players the clarity they deserve and make your server stand out with a professional, group-sorted player list.