Review moderation, ranks and placeholders
The Moderation, Ranks and Game stats (Placeholders) pages, and what the punishment, LuckPerms and PlaceholderAPI integrations report into them.
In a few minutes you can see who gets punished and by whom, which ranks players earn and how long they take to get there, and any number your game shows (balance, level, kills) charted per player. None of these pages follows the server filter: a punishment, a rank or a placeholder value belongs to the network.
Before you start#
- A linked server or proxy, see Connect your server.
- The plugin each page reads, running on a linked server or proxy: LiteBans, LibertyBans or AdvancedBan for moderation; LuckPerms for ranks; PlaceholderAPI on a Paper or Spigot server for game stats. How each is detected is on Integrations.
- The matching module on in What the plugin collects: Punishments, Ranks or Game stats. A page stays empty (No punishments in this range, No ranks in this range, No game stats yet) until it is.
Steps#
Open Moderation
In the sidebar, open Moderation (the Punishments tab). Read the KPIs, Punishments over time, and Staff.
Open Ranks
Open Players › Ranks to see who gains a rank, who renews it and how each rank plays.
Choose the values to chart
For game stats, list the placeholders in each server's config.yml (see Placeholders), restart
it, then open Activity › Game stats and pick one under Stat.
Check that it works#
Moderation shows the punishments of the range split by kind. After a staff member bans someone, the ban appears under Staff with their name. Ranks shows Rank grants after you give a player a LuckPerms group. Game stats lists your placeholder with a player count once players have left a server after the restart.
Going further#
Moderation#
Punishments from LiteBans, LibertyBans and AdvancedBan: how many, what kind, and who hands them out.
| Section | Shows |
|---|---|
| KPIs | Punishments in the range (split by kind: Ban, Mute, Kick, Warn), Players punished, their Share of active players, and Lifted (unbans and unmutes). |
| Punishments over time | Issued per period, stacked by kind. |
| Staff | Punishments issued by each staff member, by kind; the console as Console. |
| Reasons | What punishments were given for, sorted by Exylia AI from the reason staff typed: Cheating, Toxicity, Spam and advertising, Griefing, Exploiting, Ban evasion, Other or Unclassified (the model was not sure enough, or has not answered yet). |
A punishment is counted once by its plugin and its id. LiteBans running on the proxy and on a backend both report the same ban; the dashboard keeps one.
Ranks#
LuckPerms groups: who gains a rank, who renews it, and how each rank plays.
| Metric | Definition |
|---|---|
| Rank grants | A group added to a player, including a renewal: a temporary group whose expiry changed. |
| First-time grants | The first time a player gets that group. |
| Renewals | Grants that are not first-time. |
| Removals | Groups taken away. A temporary group that simply expires is not reported. |
| Players granted a rank | Unique players with a grant in the range. |
| Chart | Shows |
|---|---|
| Rank grants over time | Grants per period, by rank. |
| Active players by rank | Each active player once per period, under the rank they had when their latest session started. |
| By rank | Players, share of active players, visits per player and average visit length per rank. |
| Time to first rank | Days from a player's first session to their first rank: the typical wait (median) and buckets from Same day to 90+ days. |
- The
defaultgroup is never counted: LuckPerms gives it back whenever a player loses every other one. - The rank a player plays as is their LuckPerms primary group at the moment their session starts. Without LuckPerms, or before LuckPerms has loaded the player, it is Unknown.
- Grants are recorded from the moment the agent sees them. History from before is not imported.
- A change is reported by the one server or proxy where it was made, so a network counts it once.
Placeholders#
Any PlaceholderAPI value you choose to collect: balances, levels, kills, anything a placeholder shows. In the dashboard the page is called Game stats.
Choosing what to collect
Placeholders are listed per server, in that server's config.yml, up to 16:
placeholders:
- '%vault_eco_balance%'
- '%statistic_mob_kills%'Each time a player leaves a Paper or Spigot server, the agent resolves every listed placeholder for them and sends the results. A placeholder PlaceholderAPI cannot resolve (it answers with the placeholder itself) is left out, colour codes are stripped, and a value is cut to 200 characters. A proxy has no PlaceholderAPI and sends none.
The dashboard charts a value only when it is a plain number: 1520.25, -3, 1,520.25 or 1 000. Formatted values
such as 1.5k, 12 coins or 1.520,25 are kept as text. Most expansions offer a raw variant; list that one.
The page
Pick a stat under Stat; the list shows how many players each one has values for. Every statistic uses each player's latest value in the period, so a player who left ten times counts once.
| A numeric placeholder | Shows |
|---|---|
| Typical (median), Average, Top 10% (90th percentile) | Of the players' latest values, over time, in the chart titled with the stat's name and "per player". |
| Sum | Of the players' latest values, only for the players seen in the period, so it is not a server-wide total. |
A placeholder is treated as numeric when at least half of its values are numbers. A text placeholder shows players by their latest value instead, in a chart titled with the stat's name and "values".
Something missing on this page? Tell us on Discord