TotalGroupPlaceholder: Group Placeholders for LuckPerms

TotalGroupPlaceholder

If you run a Minecraft server and rely on PlaceholderAPI to display dynamic information, you know how powerful custom placeholders can be. But managing them manually can become a chore, especially when you need to track group statistics from LuckPerms. That’s where TotalGroupPlaceholder for Minecraft steps in — a lightweight plugin that expands your placeholder toolkit and gives you full control over group-related data.

TotalGroupPlaceholder is designed to work seamlessly with PlaceholderAPI, adding a set of ready-to-use placeholders that pull real-time member counts from your LuckPerms groups. Whether you want to show how many players are in the “admin” group or display the number of online moderators on a scoreboard, this plugin makes it effortless.

What Is TotalGroupPlaceholder?

TotalGroupPlaceholder is a server-side plugin for Spigot, Paper, and other Bukkit-compatible Minecraft servers. It acts as an extension for PlaceholderAPI, introducing new placeholders that query LuckPerms group data. Instead of writing complex scripts or custom expansions, you simply install TotalGroupPlaceholder and start using its built-in placeholders in any plugin that supports PlaceholderAPI — from chat formatters to holographic displays.

The plugin is maintained to support a wide range of Minecraft versions, from legacy 1.8 servers all the way up to the latest 1.20.x releases. It requires Java 8 or higher, making it compatible with virtually all modern server setups.

Key Features

• Seamless PlaceholderAPI Integration: TotalGroupPlaceholder registers new placeholders automatically once PlaceholderAPI is loaded, so you can use them right away.
• Custom Commands for Group Management: The /totalgroup command lets you check member counts, online status, and even list all groups without digging through config files.
• Easy Expansion of Placeholders: You can use any LuckPerms group name dynamically — just replace [group] with the actual group name in the placeholder format.
• Permission Support: Control who can run the commands with the totalgroup.use permission node, keeping your server secure.
• Lightweight and Performance-Friendly: The plugin only queries LuckPerms when a placeholder is requested, so it won’t lag your server.

Requirements

Before you download TotalGroupPlaceholder, make sure your server meets these prerequisites:

• Minecraft server running Spigot, Paper, or any Bukkit-compatible fork (1.8 – 1.20.x).
• Java 8 or higher.
• PlaceholderAPI installed and enabled.
• LuckPerms installed and configured with your groups.

How to Install TotalGroupPlaceholder

Installing TotalGroupPlaceholder is straightforward. Follow these steps to get it running on your server:

1. Download the JAR file: You can download TotalGroupPlaceholder from the official Spigot resource page or trusted community platforms. Look for the latest version that matches your server’s Minecraft release.
2. Place the file in the plugins folder: Move the downloaded TotalGroupPlaceholder-[version].jar into your server’s /plugins directory.
3. Verify dependencies: Ensure both PlaceholderAPI and LuckPerms are already in the plugins folder and have been started at least once.
4. Restart your server: A full restart (not just a reload) is recommended to load the plugin correctly.
5. Check the console: After restart, look for a message confirming that TotalGroupPlaceholder has been enabled. If you see any errors, double-check that PlaceholderAPI and LuckPerms are up to date.

For those who prefer a streamlined experience, the foxygame.net launcher includes TotalGroupPlaceholder in its curated add-on catalog, allowing you to install it with a single click and keep it updated automatically. This is especially handy if you manage multiple servers and want to avoid manual file transfers.

Using TotalGroupPlaceholder Commands

Once installed, the plugin adds the /totalgroup command (aliases: /tg). Here are the main ways to use it:

• /totalgroup help — Displays all available subcommands and usage information.
• /totalgroup [group] — Shows the total number of members in that LuckPerms group. Example: /totalgroup admin returns the count of all players in the “admin” group.
• /totalgroup [group] --online — Shows only the online members of the specified group.
• /totalgroup all — Lists the member count for every LuckPerms group on the server.
• /totalgroup all --online — Lists online member counts for all groups.
• /totalgroup version — Displays the current plugin version.

These commands are great for quick checks without opening LuckPerms’ editor. You can also restrict access with the totalgroup.use permission, so only staff members can view group statistics.

Placeholders and LuckPerms Integration

The real power of TotalGroupPlaceholder lies in its placeholders. They follow a simple pattern:

• %totalgroup_[group]% — Returns the total number of members in the specified LuckPerms group. For example, %totalgroup_admin% might display “5” if five players have the admin rank.
• %totalgroup_[group]_online% — Returns the number of online members in that group. %totalgroup_moderator_online% could show “2” if two moderators are currently playing.

You can replace [group] with any group name registered in LuckPerms — even custom groups like “vip”, “builder”, or “helper”. These placeholders work anywhere PlaceholderAPI is supported: chat messages, tab lists, scoreboards, holograms, and more. For instance, you could set up a scoreboard that updates in real time to show how many staff members are online, or create a welcome message that greets players by their group size.

Why Choose TotalGroupPlaceholder?

TotalGroupPlaceholder fills a specific niche for server owners who already use PlaceholderAPI and LuckPerms. Instead of coding a custom expansion or relying on outdated alternatives, you get a dedicated, maintained plugin that does one job well. The permission node adds a layer of security, and the lightweight design means it won’t interfere with server performance. Whether you’re building a complex RPG server, a minigame network, or a simple survival world, having accurate group statistics at your fingertips can enhance player engagement.

Conclusion

TotalGroupPlaceholder is a must-have add-on for any Minecraft server that leverages PlaceholderAPI and LuckPerms. It simplifies group data retrieval, offers intuitive commands, and expands your placeholder options without bloat. The installation process is quick, and once set up, you’ll wonder how you managed without it. Download TotalGroupPlaceholder today and give your server the dynamic group insights it deserves.