What it does
Helmsman is a plugin for Paper / Spigot servers, made by wystn. Staff audit log, lag spike causes and moderation in a dashboard served by your Paper server.
It supports Minecraft 1.21 – 26.x. It has been downloaded 1 times on Hangar. That puts it at #145 of the 150 performance plugins listed here. The last update came out on Nov 16, 2026.
Supported versions
26.x1.21
Release history
The newest is 1.0.0, released on Nov 16, 2026. It is made for Minecraft 1.21.4 – 26.3. It runs on Paper. The download is 613 KB.
| Version | Released | Minecraft | Type |
|---|
1.0.0 | Nov 16, 2026 | 1.21.4 – 26.3 | Release |
Commands
The commands named on the Hangar page of Helmsman:
/hm/helmsman
Description from the author on Hangar
Every staff action on record. Every lag spike explained.
Helmsman adds a web dashboard to your Paper server. See which staff member ran which command, and what was loaded when the server lagged. The plugin serves the dashboard on its own port, with no account to create and no external service to rely on. Everything it stores stays in a single file on your server.
Features
- An audit log you can trust. Records commands entered by OPs, staff and the console, along with every kick, ban, mute, warning and settings change: who did it, when and from which address. Entries cannot be edited or deleted through the dashboard or in game, even by the owner. Risky commands are flagged, including permission changes, server stops and reloads, item and money commands, WorldEdit, large fills and commands targeting every player. Private messages and login commands are excluded. For other plugins' commands, only the command name is stored, except for common staff commands such as LuckPerms, economy, give and ban, plus any you add.
- Lag spikes with context. When ticks stay above 50 ms for 3 seconds, Helmsman records what was loaded: entity and block entity types, the busiest chunks, players and garbage collection time. Enable the profiler to sample the main thread during slow ticks and see which plugin and method used the time.
- Live status and history. View TPS, tick time, memory usage and player counts in real time and over the past 7 days.
- Player records. Track joins, play time, names, IP addresses, accounts that joined from the same address, manually linked alts and staff notes. IP addresses are kept for 90 days by default, with optional masking. Players who join while a linked or same-address account is banned are flagged for possible ban evasion.
- Moderation in the browser and in game. Kick, ban for up to 365 days or permanently, unban, mute and warn from the dashboard. Use /hm mute, /hm unmute and /hm warn in game. Includes styled kick and ban screens. Helmsman can handle moderation itself, delegate bans, mutes and warnings to LibertyBans, or delegate mutes to EssentialsX.
- Chat log, off by default. Search public chat and see which messages were blocked by a Helmsman mute.
- Staff list and activity. See who signed in to the dashboard, sign staff with lower roles out of all sessions, and review each staff member's kicks, bans, mutes, warnings and risky commands.
- Discord alerts. Send webhook alerts for risky commands, moderation actions, bans without a reason, lag spikes and possible ban evasion.
- Export and deletion. Export the audit log, metrics, lag spikes, sessions, punishments, chat and staff activity as CSV or JSON Lines, with an option to replace names with pseudonyms. Download or delete an individual player's records on request.
- Permission-based roles. Owner, admin, moderator and viewer roles use helmsman.web.* permissions. Staff sign in through a one-time link generated by /helmsman login.
- English and Korean. Available for the dashboard, in-game messages and Discord alerts.
- Light on the server. The main thread only reads values. Saving, the web server and Discord alerts run on separate threads.
Screenshots
Requirements
- Paper 1.21.4 (latest build) through 26.3. Java 21 or newer (Paper 26.x needs Java 25).
- One available TCP port for the dashboard, defaulting to 8180. Most hosts let you add a port through their control panel. The setup guide includes instructions for common hosts.
- Two features depend on your Paper version: the styled screen shown when a banned player tries to rejoin requires 1.21.7 or newer, and logging F3+F4 game mode switches requires 1.21.9 or newer. The dashboard shows which limitations apply.
- No other plugins required.
Install
- Put helmsman-1.0.0.jar in plugins/ and restart the server.
- Open the dashboard port. If possible, set web.public-url in plugins/Helmsman/config.yml to the address you will use to open the dashboard.
- Run /helmsman login in game, or helmsman login in the console, and open the link.
The setup guide covers host-specific steps, HTTPS and every setting: gist.github.com/wystn/3599a73ce6798ab37dacff701…
Good to know
- The dashboard uses plain HTTP until you add HTTPS. You can add it through your host's website proxy, your own reverse proxy or a certificate file loaded by the plugin. Sign-in links work once and expire after 5 minutes.
- Chat plugins that cancel chat and send it again, such as VentureChat and similar channel plugins, leave the chat log empty. Helmsman only records chat that the server itself delivers.
- The command log only records commands. It does not block them.
- Let your players know what is recorded: player records, plus chat if the chat log is on. Deleting a player's records does not remove their mutes, warnings or audit log entries.
Data and connections
- Stored on your server. All data is stored in plugins/Helmsman/helmsman.db. There is no Helmsman server.
- Discord. If you set a Discord webhook, the plugin sends alerts to it with player and staff names, the command or action, the reason and lag spike figures. It never sends IP addresses, and nothing is sent until you set a webhook.
- Player faces. The dashboard page loads player skins from Mojang's texture server (textures.minecraft.net) to draw player faces.
- IP addresses. Only admins and the owner can see them.
- No required dependencies. LibertyBans can handle bans, mutes and warnings, and EssentialsX can handle mutes. Both are optional. If AdvancedBan, BanManager or LiteBans is installed, the dashboard warns that it keeps a separate ban list.
Support
Email jiheon.yu@outlook.com. I reply within 5 days, usually sooner.
Helmsman is not affiliated with Mojang or Microsoft. "Minecraft" is a trademark of Microsoft.
Written by wystn. Read it with pictures on Hangar.
How to install Helmsman
Make sure your server runs Paper and Spigot on Minecraft 1.21 – 26.x.
Download the .jar file from Hangar and put it in the plugins folder of your server.
Restart the server. Avoid /reload, many plugins do not handle it well.
Type /plugins in the console: Helmsman should be listed in green. Its config files are created in the plugins folder on the first start.
Full guide: How to install plugins on a Minecraft server
Compatibility
- Minecraft versions
- 26.x, 1.21
- Runs on
- Paper, Spigot
- Edition
- Java
- Needs
- Nothing else
- License
- Free to use
- Price
- Free
- Upkeep
- Actively updated (Nov 16, 2026)
Questions
Does Helmsman work on Minecraft 26.x?
Yes. Helmsman supports Minecraft 26.x. All supported versions: 26.x, 1.21.
Is Helmsman free?
Yes. Helmsman is free to download from Hangar.
Which server software does Helmsman run on?
Helmsman runs on Paper and Spigot servers.
Is Helmsman still updated?
Yes. The last update came out in the past day.
Reviews
Log in to leave a review.