StaffSee - Server Moderation
Fabric server moderation: ban, mute, warn, kick, freeze, vanish, staff chat and reports. Logged to .txt files, optional LuckPerms and Discord webhook.
No ratings yet
Be the first to rate it.
Community listing page
Community listing page, reviews may not be monitored by the author.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
Runs entirely on the server. Also works in singleplayer.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
StaffSee is a lightweight Fabric server moderation mod for Minecraft. Ban, mute, warn, kick, freeze, vanish and report players. Every action is logged to simple .txt files in your world folder. Optional Discord webhook and LuckPerms support.
Server-side only. Vanilla clients can join.
How it works
StaffSee runs entirely on the server. Staff use slash commands; the mod writes each action to world/StaffLog/ in human-readable text files - one folder per player, plus shared audit files for chat and reports.
No database. No web panel. Open the files in any text editor.
Commands
/warn <player> <reason>
Warn a player and append the entry to their log.
/warns <player>
Show recent warnings for a player.
/mute <player> [duration] <reason>
Block chat messages.
Durations: 30m, 2h, 1d, or perm for permanent.
/unmute <player>
Remove an active mute.
/kick <player> <reason>
Kick a player and log the reason.
/ban <player> [reason] / /tempban <player> <duration> [reason] / /unban <player>
Ban or unban a player. Uses the normal ban list (banned-players.json and the vanilla ban screen keep working) and is logged to bans.txt. Offline players can be banned too. /pardon works like /unban and is logged the same way.
/freeze <player> [reason]
Freeze a player in place - no movement, no interactions. Useful for screenshares.
/unfreeze <player>
Remove an active freeze.
/history <player> [page]
One paged list with all warns, mutes, kicks, freezes, bans and reports of a player, newest first. Shows if the player is banned right now.
/history <player> chests [page]
When ChestSee is installed, shows the player's container activity from the ChestSee logs. Click an entry to open it with /chestsee lookup. ChestSee stays optional.
/vanish
Hide from the tab list and the world for normal players, with no join/leave messages while vanished. Other staff still see you. Vanished players are also left out of /list, the player count and player list in the server list, and name suggestions in commands. Stays on after relogging and restarts.
/sc <message> / /sc
Send a message to staff only, or toggle staff chat so normal chat goes to staff. Works while muted.
/report <player> <reason>
Report a player. Online staff are notified instantly.
/reports
List open reports (staff).
/reports resolve <id>
Close a report and archive it to a .txt file (staff).
Staff commands need OP level 2 by default, or LuckPerms nodes (see Permissions below).
/reportis available to everyone by default.
Log structure
world/
└── StaffLog/
├── _mutes.json
├── _counts.json
├── _freezes.json
├── _reports.json
├── _chat/
│ └── 2026-07-07.txt
├── _reports/
│ └── 2026-07-07.txt
└── Steve/
├── warns.txt
├── mutes.txt
├── kicks.txt
├── freezes.txt
└── bans.txt
Each player gets their own folder.
Staff actions are split into separate files - easy to review, easy to share.
Chat messages are logged globally under _chat/, one file per day.
Example entry
world/StaffLog/Steve/warns.txt
[06.07.26 21:15:33]
by AdminName
Reason: Griefing spawn area
Config
On first start, StaffSee creates config/staffsee.json. New options are added automatically on update; your values are kept.
{
"autoKickAfterWarns": 0,
"muteMessage": "You are muted.",
"warnBroadcast": false,
"freezeMessage": "You are frozen by staff.",
"logChat": true,
"reportCooldownSeconds": 60,
"discordWebhookUrl": "",
"discordReports": true,
"discordPunishments": false
}
| Option | Description |
|---|---|
autoKickAfterWarns |
Auto-kick after N warnings. Set to 0 to disable. |
muteMessage |
Message shown when a muted player tries to chat. |
warnBroadcast |
Broadcast warnings to all online players. |
freezeMessage |
Message shown when a frozen player tries to move or chat. |
logChat |
Write all chat messages to _chat/YYYY-MM-DD.txt. |
reportCooldownSeconds |
Cooldown between /report per player. Set to 0 to disable. |
discordWebhookUrl |
Discord webhook URL. Leave empty to disable. |
discordReports |
Send player reports to Discord. |
discordPunishments |
Also send warns, mutes, kicks, freezes and bans. |
Discord messages are sent in the background and never ping anyone.
Permissions (optional - LuckPerms)
StaffSee uses fabric-permissions-api. Without LuckPerms, staff commands require OP level 2.
| Node | Access |
|---|---|
staffsee.moderate |
All staff commands |
staffsee.report |
/report (default: everyone) |
staffsee.vanish |
/vanish (defaults to staffsee.moderate) |
staffsee.vanish.see |
See vanished staff (defaults to staffsee.moderate) |
staffsee.staffchat |
/sc (defaults to staffsee.moderate) |
Example:
/lp group moderator permission set staffsee.moderate true
Companion mod
StaffSee pairs with ChestSee - log container interactions in ChestLog/, handle player moderation in StaffLog/.
Install
- Install Fabric Loader and Fabric API for your Minecraft version
- Place
StaffSee.jarin your server'smods/folder - Restart the server
Done. No extra setup required.
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
Stats
- Downloads
- 1k
- Used in
- 0 modpacks
- Followers
- 0
- In stacks
- 0
- Created
- Last synced
-
Nov 19, 2026 3:15 AM UTC
New file updates sync automatically.
When ModDex last fully re-synced this project from CurseForge or Modrinth. A new file release triggers a resync usually within minutes, and every project is also re-synced on a schedule. Edits that don't ship a file, such as a new description or screenshots, are checked every few hours and can appear before this date changes.
How syncing works
External Links
Stats
- Downloads
- 1k
- Used in
- 0 modpacks
- Followers
- 0
- In stacks
- 0
- Created
- Last synced
-
Nov 19, 2026 3:15 AM UTC
New file updates sync automatically.
When ModDex last fully re-synced this project from CurseForge or Modrinth. A new file release triggers a resync usually within minutes, and every project is also re-synced on a schedule. Edits that don't ship a file, such as a new description or screenshots, are checked every few hours and can appear before this date changes.
How syncing works