Every imperiummc.* permission node grouped by category, with defaults and LuckPerms setup examples.
Every Imperium feature is gated by a permission node in the imperiummc.* namespace. This page lists them all — pulled directly from the plugin's plugin.yml — grouped by what they do, with the default value each node ships with. Pair it with the bundled LuckPerms staff and donor groups (also documented here) and you can set up a complete server hierarchy in a few minutes.
The default column shows who gets the node without anyone touching LuckPerms: true = every player including brand-new accounts, op = server operators only, false = must be granted explicitly (typically by donor rank or staff promotion). Bundles marked .* are wildcards that inherit every child node.
How Defaults Work
Imperium permissions follow the standard Bukkit/Paper default semantics. When a player joins, Paper assigns every default: true node automatically. Nodes marked default: op only apply to operators. Nodes marked default: false are dormant until a permission plugin (LuckPerms is recommended) explicitly grants them — usually to a donor tier, staff rank, or VIP bundle.
The imperiummc.user bundle inherits every player-facing default node. The imperiummc.admin, imperiummc.mod, and imperiummc.owner bundles stack progressively more permissions on top, so you only ever need to grant one wildcard to give a player everything in a tier.
Complete Permission Reference
Below is every node defined in plugin.yml, grouped by feature area. Where a node is a parent bundle (it has children), the bundle is shown alongside its individual children so you can see exactly what each inherits.
Core Bundles & Wildcards
Permission Node
What It Grants
Default
imperiummc.*
Wildcard: every Imperium feature. Use only on dev servers.
false
imperiummc.user
Default-player bundle. Inherits every default:true permission below.
true
imperiummc.admin
Admin bundle — mod + every admin.* and *.admin node.
op
imperiummc.mod
Staff bundle — user + punishment, vault, anticheat alerts.
op
imperiummc.owner
Developer/debug bundle. Inherits admin.
false
Player Features
Permission Node
What It Grants
Default
imperiummc.trade
Player-to-player trade system.
true
imperiummc.auction
Auction House access.
true
imperiummc.argentarius
Player-to-player loan and credit system.
true
imperiummc.argentarius.credit.others
View other players' credit scores.
op
imperiummc.marketplace
Fixed-price marketplace access.
true
imperiummc.crate
Access the crate system.
true
imperiummc.afk
Toggle own AFK status.
true
imperiummc.plot
Use plot-world commands (/plot claim, auto, home, info, add, remove).
true
imperiummc.chatcolor
Customise chat message colour (donor perk).
false
imperiummc.namecolor
Customise own name colour in tab/chat (donor perk).
false
imperiummc.mines
Access the public shared mine system.
true
imperiummc.teleport.back
Use /back to return to the last location.
true
imperiummc.homes.unlimited
No home limit.
op
imperiummc.homes.5
Up to 5 homes.
false
imperiummc.homes.10
Up to 10 homes.
false
imperiummc.homes.25
Up to 25 homes.
false
imperiummc.warns.self
View your own warning history.
true
imperiummc.essentials.suicide
Use /suicide.
true
Rank & Public Mines
Permission Node
What It Grants
Default
imperiummc.rank
Unified rank command bundle (info + rankup by default).
true
imperiummc.rank.rankup
Rank up one step.
true
imperiummc.rank.info
View rank information.
true
imperiummc.rank.max
Use the max rank-up feature (skips as many ranks as you can afford).
false
imperiummc.rank.skip
Skip a rank using Aureus.
false
imperiummc.rank.set
Admin: set a player's rank directly.
op
imperiummc.rank.reset
Admin: reset a player's rank.
op
imperiummc.rank.add
Admin: add ranks to a player.
op
imperiummc.rank.remove
Admin: remove ranks from a player.
op
imperiummc.rank.admin
Bundle: set + reset + add + remove.
op
imperiummc.mines.bypass
Bypass rank requirements on public-mine teleports.
op
Prestige
Permission Node
What It Grants
Default
imperiummc.prestige
Prestige progression bundle.
true
imperiummc.prestige.normal
Normal prestige.
true
imperiummc.prestige.skip
Skip a prestige with Aureus.
false
imperiummc.prestige.force
Admin: force-set a player's prestige level.
op
imperiummc.prestige.stats
View other players' prestige stats.
op
imperiummc.prestige.reset
Admin: reset a player's prestige.
op
Currency
Permission Node
What It Grants
Default
imperiummc.currency.*
All currency commands.
false
imperiummc.currency.balance
Check own currency balances.
true
imperiummc.currency.balance.others
Check other players' balances.
false
imperiummc.currency.check
Check specific currency balances.
true
imperiummc.currency.pay
Pay other players (Denarius, Auctoritas, Civitas, Aureus).
true
imperiummc.currency.give
Admin: give currency to a player.
op
imperiummc.currency.take
Admin: take currency from a player.
op
imperiummc.currency.set
Admin: set a player's currency balance.
op
imperiummc.currency.admin
Bundle: give + take + set.
op
Pickaxe & Enchants
Permission Node
What It Grants
Default
imperiummc.pickaxe.claim
Claim the starter pickaxe.
true
imperiummc.pickaxe.use
Right-click the pickaxe to open the enchant menu.
true
imperiummc.pickaxe.enchant
Access the enchant menu.
true
imperiummc.pickaxe.upgrade
Access the pickaxe upgrade GUI.
true
imperiummc.pickaxe.menu
Open pickaxe menus.
true
imperiummc.pickaxe.repair
Repair your pickaxe.
true
imperiummc.pickaxe.disenchant
Disenchant your pickaxe.
true
imperiummc.enchantbook.use
Apply, fuse, and extract pickaxe enchant books.
true
imperiummc.enchantbook.give
Staff: give enchant books to yourself or other players.
Jail, unjail, set the jail point, check jail status.
op
imperiummc.admin.migrate
Run the one-time EssentialsX data migration.
op
imperiummc.chat.mod
Receive chat-moderation alerts.
op
imperiummc.chat.mod.bypass
Bypass chat-moderation filters (staff).
false
imperiummc.database.logs
Access database logs.
op
imperiummc.performance
View server performance telemetry (/performance, /lag).
op
imperiummc.plugins
List loaded plugins and versions via /plugins (CVE-gated).
op
Anti-Cheat
Permission Node
What It Grants
Default
imperiummc.anticheat.bypass
Exempt from all anti-cheat checks.
op
imperiummc.anticheat.alerts
Receive anti-cheat violation alerts in chat.
op
imperiummc.anticheat.admin
Full anti-cheat administration (clear, freeze, rollback).
op
Quests, Battle Pass & Progression
Permission Node
What It Grants
Default
imperiummc.quest
Quest system access.
true
imperiummc.quest.admin
Quest administration.
op
imperiummc.battlepass
Battle Pass access.
true
imperiummc.battlepass.premium
Premium Battle Pass reward track (donor).
false
imperiummc.leaderboard
Leaderboard access.
true
imperiummc.dailyquest
Access the daily-quest rotation.
true
imperiummc.dailyquest.admin
Reload daily-quest templates.
op
imperiummc.challenge
Challenge system access.
true
imperiummc.crystals
Crystal management bundle (give/remove admin).
true
imperiummc.crystals.give
Give crystals to players.
op
imperiummc.crystals.remove
Remove crystals from players.
op
imperiummc.story
View story progression via /story.
true
imperiummc.story.admin
Manage story chapters.
op
Cosmetics, Capes, Tags & Pets
Permission Node
What It Grants
Default
imperiummc.milestones
Access mining milestones.
true
imperiummc.cosmetics
Access the cosmetics menu.
true
imperiummc.cosmetics.admin
Open /cosmeticsadmin and grant any cosmetic to yourself.
op
imperiummc.cape
Access the cape system (/cape).
true
imperiummc.cape.admin
Grant capes to yourself for testing.
op
imperiummc.tags
Access chat tags.
true
imperiummc.pet
Access the pet system.
true
imperiummc.mastery
Access the mastery system.
true
imperiummc.skin.admin
Grant/browse cosmetic skins via /skin gui and /skin grant.
op
Events, Crates, Drop Parties & Lucky Blocks
Permission Node
What It Grants
Default
imperiummc.event
Event system bundle (use + join + leave + info).
true
imperiummc.event.start
Start events.
op
imperiummc.event.stop
Stop events.
op
imperiummc.event.manage
Manage events.
op
imperiummc.event.admin
Bundle: start + stop + manage.
op
imperiummc.dropparty.admin
Manage drop parties (/dropparty start|stop|status|reload).
op
imperiummc.crate.admin
Admin crate management.
op
imperiummc.luckyblock.admin
Admin lucky-block management.
op
Kits, Auto-Miner, Boosters & Withdraw
Permission Node
What It Grants
Default
imperiummc.kit
Kit system access (starter + miner).
true
imperiummc.kit.starter
Claim the Starter kit.
true
imperiummc.kit.miner
Claim the Miner kit.
true
imperiummc.kit.elite
Claim the Elite kit (donor).
false
imperiummc.kit.legend
Claim the Legend kit (donor).
false
imperiummc.kit.pvp
Claim the PvP kit (donor).
false
imperiummc.kit.donor
Claim the Donor kit (donor).
false
imperiummc.kit.give
Give kits to players bypassing cooldown.
op
imperiummc.kit.admin
Bundle: kit.give.
op
imperiummc.sellwand.give
Give out Sell Wands.
op
imperiummc.autominer
Autominer bundle (basic + start + stop + menu).
true
imperiummc.autominer.advanced
Advanced autominer (donor).
false
imperiummc.autominer.elite
Elite autominer (donor).
false
imperiummc.autominer.legendary
Legendary autominer (donor).
false
imperiummc.autosell
/sellall command access.
true
imperiummc.dailyreward
Daily rewards access.
true
imperiummc.dailyreward.premium
Premium-tier daily-reward access (donor).
false
imperiummc.boosts
View active boosts.
true
imperiummc.booster
View/activate boosters.
true
imperiummc.booster.activate
Manually activate a booster.
op
Miscellaneous Admin Nodes
Permission Node
What It Grants
Default
imperiummc.withdraw
Currency withdrawal bundle (all four currencies).
true
imperiummc.withdraw.money
Withdraw money as a banknote.
true
imperiummc.withdraw.tokens
Withdraw Auctoritas tokens.
true
imperiummc.withdraw.beacons
Withdraw Civitas beacons.
true
imperiummc.withdraw.gc
Withdraw Aureus.
true
imperiummc.afk.admin
Manage AFK for other players.
op
imperiummc.afk.bypass
Bypass the AFK kick.
false
imperiummc.warp.admin
Create, move and delete warps and spawn.
op
imperiummc.mines.admin
Force-reset public mines.
op
imperiummc.npc.admin
Place and manage Citizens NPCs via /npcadmin.
op
imperiummc.ce.admin
Apply, remove and reload Custom Combat Enchants via /ce.
op
LuckPerms Staff Group Ladder
Imperium ships a complete staff ladder as permission bundles: imperiummc.group.member, imperiummc.group.trainee, imperiummc.group.jr.mod, imperiummc.group.mod, imperiummc.group.sr.mod, imperiummc.group.admin, imperiummc.group.sr.admin, imperiummc.group.head.admin, imperiummc.group.developer, imperiummc.group.builder, imperiummc.group.manager, imperiummc.group.owner, and imperiummc.group.tester. Each inherits the previous tier so promotion is a single /lp user ... parent add.
The cleanest setup is to mirror each bundle as a LuckPerms group:
# Bundle each rank tier into a single LuckPerms group.
# Inherit up the ladder so senior ranks automatically get junior perms.
/lp creategroup member
/lp group member permission set imperiummc.group.member true
/lp creategroup trainee
/lp group trainee parent set imperiummc.group.trainee
/lp group trainee parent add member
/lp creategroup jrmod
/lp group jrmod parent set imperiummc.group.jr.mod
/lp creategroup mod
/lp group mod parent set imperiummc.group.mod
/lp creategroup srmod
/lp group srmod parent set imperiummc.group.sr.mod
/lp creategroup admin
/lp group admin parent set imperiummc.group.admin
/lp creategroup headadmin
/lp group headadmin parent set imperiummc.group.head.admin
# Promote a player
/lp user <player> parent add mod
/lp user <player> parent remove jrmod
LuckPerms Donor Group Ladder
Donor tiers follow the same pattern. Imperium grants imperiummc.group.donor.<tier> automatically when a donor rank is purchased through the in-game /donor buy command or the web store. Each tier inherits the previous one — Peregrinus is the entry tier and Imperator stacks on every perk below it. See the Donor Ranks article for the full perk ladder.
# Donor ranks inherit up the SERVUS → PEREGRINUS → ... → IMPERATOR ladder.
# Imperium grants imperiummc.group.donor.<tier> itself when a tier is purchased.
/lp creategroup donor_peregrinus
/lp group donor_peregrinus parent set imperiummc.group.donor.peregrinus
/lp group donor_peregrinus meta setprefix "&f[&bPeregrinus&f] " 100
/lp creategroup donor_patrician
/lp group donor_patrician parent set imperiummc.group.donor.patrician
/lp group donor_patrician meta setprefix "&6[&ePatrician&6] " 100
# Assign to a player after purchase
/lp user <player> parent add donor_patrician
/lp user <player> parent remove donor_peregrinus
Tips for Server Owners
Start with the bundles. Granting imperiummc.user to your default LuckPerms group covers every default:true node automatically. You only need to touch individual nodes for donor perks and staff tools.
Lock down security nodes.imperiummc.plugins, imperiummc.performance, imperiummc.anticheat.bypass, and imperiummc.admin.migrate ship as op-only for good reason — keep them that way.
Donor perks are false by default. Nodes like imperiummc.chatcolor, imperiummc.homes.10, imperiummc.kit.donor, and imperiummc.battlepass.premium are dormant until a donor rank grants them. This is intentional — donors get them, regular players do not.
Use temporary grants for events. LuckPerms temporal grants are perfect for weekend double-XP — set imperiummc.booster.activate for the duration and let it auto-expire.
The wildcard imperiummc.* is for dev only. It grants every node including owner and anti-cheat bypass; never assign it to a real player.
