What Is the AdminsOnly Plugin?
Running a Minecraft server is a constant balancing act between welcoming your community and maintaining order when you need to test new features, fix bugs, or simply take a break from the chaos. The AdminsOnly plugin hands you a professional-grade whitelist system that locks down your server to administrators with a single command. Instead of fiddling with vanilla whitelists or kicking players manually, you get a streamlined toggle that respects your server’s permission structure, broadcasts clear messages, and even updates the MOTD automatically.
Core Features That Set AdminsOnly Apart
AdminsOnly isn’t just a simple on/off switch. It’s built for server owners who want full control without compromising the player experience. Here’s what makes it stand out:
- Instant lockdown toggle – flip the server into admin-only mode with
/ao toggle, no config editing required. - Permission-driven access – grant the
adminsonly.loginnode to trusted staff, so they can join even when the server is locked. - Automatic kick of non-admins – enable
kickallonlockdownin the config and all unauthorized players are removed the moment you activate the mode. - Customizable kick and MOTD messages – use color codes and placeholders to inform players exactly why they can’t connect.
- Op bypass support – if you prefer to rely on operator status rather than permission nodes, the
bypassforopsoption lets ops join without the extra permission. - Broadcast on failed join – see who tried to log in while the server was in admin-only mode, great for spotting persistent troublemakers.
Commands and Permissions at a Glance
Every function in AdminsOnly is tied to a clear command and a specific permission node. You don’t need to memorize complex syntax; the plugin keeps it simple.
| Command | Description | Permission Node |
|---|---|---|
/adminsonly or /ao |
Displays the current AdminsOnly status. | – |
/ao toggle (or /ao t) |
Toggles admin-only mode on or off. | adminsonly.admin |
/ao reload (or /ao r) |
Reloads the plugin configuration without restarting the server. | adminsonly.admin |
The adminsonly.login permission is the key that lets specific staff members bypass the lockdown. Assign it to your moderators and admins through your permissions plugin (LuckPerms, PermissionsEx, etc.), and they’ll walk right in while everyone else sees the kick message.
Deep Dive into Configuration
The plugin’s config.yml gives you granular control over how the lockdown behaves. Every setting is documented and straightforward. Here are the most impactful options:
- locked –
falseby default. You can set this totruebefore a restart, but the toggle command is usually faster. - kickmsg – the message players see when they’re kicked. Supports color codes (e.g.,
&cfor red). Default is"&cOnly admins can join at this time!" - kickallonlockdown –
trueby default. When you toggle admin-only mode, any online player withoutadminsonly.logingets kicked immediately. - bypassforops –
trueby default. If you prefer not to manage extra permission nodes for your operators, leave this on. - broadcastonfailedjoin –
trueby default. Sends a server-wide message when someone tries to join and is blocked. Useful for monitoring. - usemotd and motd – when enabled, the server’s MOTD in the multiplayer list changes to your custom message, warning players before they even attempt to connect.
Adjusting these values is a matter of stopping the server, editing the file, and restarting—or simply using /ao reload to apply changes on the fly. If you’re managing multiple plugins and mods, you’ll appreciate how effortlessly AdminsOnly integrates. For those who prefer a launcher that simplifies the entire server setup process, the foxygame.net launcher lets you download and install plugins like AdminsOnly directly from its built-in mod menu, keeping everything organized without ever leaving the interface.
Installing AdminsOnly on Your Server
Getting started takes less than a minute. Follow these steps:
- Download the AdminsOnly JAR file from your preferred plugin repository.
- Place the JAR into your server’s
/pluginsfolder. - Restart the server or run a plugin reload command if your server supports it.
- Verify the plugin loaded by typing
/aoin chat or console. You’ll see the current status. - Optionally, edit
config.ymlto customize messages and behavior.
Because AdminsOnly is lightweight, it won’t cause lag or conflicts with other plugins. It works on Spigot, Paper, and most forks without issues. Once installed, give your staff the adminsonly.admin permission so they can toggle the mode, and assign adminsonly.login to anyone who should retain access during a lockdown.
Real-World Use Cases for AdminsOnly
This plugin isn’t just for emergencies. Savvy server owners use it in a variety of scenarios:
- Maintenance windows – lock the server while you update plugins or test world edits, then open it back up with a single command.
- Staff meetings – bring your team online to discuss rules or plan events without random players interrupting.
- Event setup – build arenas or spawn structures in peace, then disable admin-only mode right before the event starts.
- Security incidents – if you suspect a dupe exploit or a griefing wave, lock down instantly and investigate without kicking everyone manually.
Because the plugin broadcasts failed join attempts, you can even gauge how many players are trying to get in and decide when to reopen. The custom MOTD feature acts as a polite “closed for maintenance” sign, reducing frustration and support tickets.
Best Practices and Pro Tips
To get the most out of AdminsOnly, keep these tips in mind:
- Always test the toggle command on a private test server first, especially if you’ve customized the kick message with complex color codes.
- Use a permissions plugin to create a “maintenance” group that inherits
adminsonly.loginso you can easily add or remove temporary staff. - Combine AdminsOnly with a backup plugin – lock the server, run a backup, then unlock. This prevents players from altering chunks during the backup process.
- If you run a network, install the plugin on each server and use the same config for consistency. You can even toggle multiple servers via a script if you have console access.
Why AdminsOnly Beats Vanilla Whitelists
Minecraft’s built-in whitelist is functional but clunky. You have to manually add and remove players, and there’s no way to let ops bypass it without giving them full whitelist management permissions. AdminsOnly flips the script by focusing on permission nodes instead of player lists. It’s dynamic, fast, and integrates with your existing staff hierarchy. The ability to reload the config without a restart is a huge time-saver, and the broadcast feature keeps you informed without digging through logs.
Final Thoughts
AdminsOnly is one of those plugins that you don’t think about until you desperately need it – and then you wonder how you ever managed without it. Its straightforward commands, permission-based logic, and customizable messages make server lockdowns feel professional rather than panicked. Whether you’re a small community server owner or managing a large network, this plugin earns a permanent spot in your toolbox. Set it up once, grant the right permissions, and you’ll have instant, reliable admin-only access whenever the situation calls for it.