Commands and permissions
Commands
Everything is under /ac (alias /admincontrol). With modules.reports: true, /report works
without the prefix too, unless another plugin already has a /report command (then use /ac report). With
punishments.shortcuts: true the punishment commands and /punish do as well (/ban, /mute, ...); when another
plugin already owns a name, use /ac. With EssentialsX, its punishment commands (/ban, /mute, /kick, also
/essentials:ban and /eban) run as AdminControl's (see Integrations). Durations: minutes, hours,
days and weeks (10m, 2h, 7d, 4w), combined like 1d12h.
| Command | What it does | Who |
|---|---|---|
/ac help |
List of commands. | admincontrol.command |
/ac version |
Plugin version, license, database and panel status. | admincontrol.command |
/ac reload |
Reload config.yml and messages (some keys need a restart; it tells you which). |
admincontrol.reload |
/ac whitelist off |
Turn the panel IP whitelist off. Server console only. | console |
/ac resetowner |
Print a link to set up a new Owner account. Server console only. | console |
/ac link <code> |
Link your Minecraft account to your panel account (code from Settings → My account). | admincontrol.link |
/ac report <player> [category] <text> |
Report a player to the staff. Categories: cheating, chat, griefing, other. | admincontrol.report |
/ac ban <player> <reason> |
Permanent ban. | punishment rights |
/ac tempban <player> <time> <reason> |
Timed ban. | punishment rights |
/ac ipban <player> <reason> |
Permanent IP ban. | punishment rights |
/ac tempipban <player> <time> <reason> |
Timed IP ban. | punishment rights |
/ac mute <player> <reason> |
Permanent mute. | punishment rights |
/ac tempmute <player> <time> <reason> |
Timed mute. | punishment rights |
/ac warn <player> <reason> |
Warning. | punishment rights |
/ac kick <player> <reason> |
Kick from the server. | punishment rights |
/ac unban <player> [reason] |
Lift a ban (also an IP ban). | punishment rights |
/ac unmute <player> [reason] |
Lift a mute. | punishment rights |
/ac unwarn <player> [reason] |
Lift the newest warning. | punishment rights |
/ac punish <player> <template> [reason] |
Punish with a template: the player's next escalation step. | punishment rights |
/ac history <player> |
A player's 10 latest punishments. | punishment rights |
/ac rollback <player> <time> [all|blocks|containers] |
Roll back a player's changes over a time on every server with CoreProtect (see Integrations). | admincontrol.rollback |
/ac restore <player> <time> [all|blocks|containers] |
Restore a player's rolled back changes. | admincontrol.rollback |
With CoreProtect, a ban can roll the player's changes back: /ac ban <player> -r <time> <reason> (also ipban;
for tempban and tempipban the flag comes after the time of the ban, e.g. /ac tempban Gracz 7d -r 24h grief).
/ac unban <player> -restore lifts the ban and restores what was rolled back with it. A player using
/ac rollback, /ac restore, -r or -restore needs players.rollback in the role of their linked panel account
and stays within its rollback limit; the console has no limit. In game, -r and -restore need admincontrol.rollback
as well (like /ac rollback); a ban from a template with a rollback window is then given without the rollback.
Punishment rights: the console and RCON may do everything. A player needs admincontrol.punish and a linked panel
account (/ac link); what they may do and for how long comes from the role of that account, the same as in the
panel. IP bans of a player who connects from 127.0.0.1 (a proxy without IP forwarding) are refused, because they
would lock out everyone.
On a Velocity network the proxy has these commands too, apart from the server-only ones: see Velocity network.
Bukkit permissions
| Permission | Default | Meaning |
|---|---|---|
admincontrol.command |
op | Use /ac. |
admincontrol.reload |
op | /ac reload. |
admincontrol.resetowner |
op | See /ac resetowner in help (it runs from the console only). |
admincontrol.whitelist |
op | See /ac whitelist off in help (it runs from the console only). |
admincontrol.link |
everyone | /ac link <code>. |
admincontrol.punish |
everyone | Use the punishment commands; what you may do comes from your linked panel role. |
admincontrol.rollback |
op | /ac rollback and /ac restore (CoreProtect); a player also needs players.rollback in their panel role. |
admincontrol.report |
everyone | /report. |
admincontrol.reports.notify |
op | See new reports in game and the open-reports reminder on join. |
admincontrol.staff |
op | Counted in %admincontrol_staff_online% (see Integrations). |
admincontrol.reports.bypasscooldown |
op | Send reports without waiting for the cooldown. |
admincontrol.chat.bypass |
op | Talk while the chat is muted or in slow mode. |
admincontrol.chat.notify |
op | See chat filter notifications in game. |
Panel roles
Every panel account has one role. Built-in roles (you can change all but Owner, and add your own in Team → Roles):
| Permission | Owner | Admin | Moderator | Helper |
|---|---|---|---|---|
dashboard.view — dashboard |
✓ | ✓ | ✓ | ✓ |
players.view — players and punishments list |
✓ | ✓ | ✓ | ✓ |
players.view_ip — player IPs and alt accounts |
✓ | ✓ | ||
players.notes — notes on players |
✓ | ✓ | ✓ | |
players.rollback — roll back and restore a player's changes (CoreProtect) |
✓ | ✓ (up to 7 days) | ||
punish.kick |
✓ | ✓ | ✓ | |
punish.warn |
✓ | ✓ | ✓ | ✓ |
punish.mute |
✓ | ✓ | ✓ | ✓ (up to 1 h) |
punish.ban |
✓ | ✓ | ✓ (up to 7 days) | |
punish.ipban |
✓ | ✓ | ||
punish.revoke — lift punishments (of the kinds the role may give: lifting an IP ban needs punish.ipban too) |
✓ | ✓ | ✓ | |
punish.templates — templates and warning rules |
✓ | ✓ | ||
punish.import — import from other plugins |
✓ | |||
reports.view |
✓ | ✓ | ✓ | ✓ |
reports.manage — claim, resolve, block reporters |
✓ | ✓ | ✓ | |
chat.view — chat log |
✓ | ✓ | ✓ | ✓ |
chat.manage — send, mute chat, slow mode, filters |
✓ | ✓ | ✓ | |
chat.private — private messages |
✓ | ✓ | ||
announcements.manage |
✓ | ✓ | ||
console.view — see the console |
✓ | ✓ | ||
console.execute — run commands |
✓ | ✓ | ||
team.manage — accounts, invites, roles |
✓ | ✓ | ||
audit.view — audit log |
✓ | ✓ | ||
settings.manage — server settings |
✓ |
Roles are ordered: an account manages only roles below its own, and cannot give a permission or a longer punishment
limit than it has. The console needs a fresh 2FA code before it unlocks, and roles below Owner cannot run the
commands on Console → Blocked commands (stop, op, deop, lp, luckperms by default).