StaffSee – Server Moderation

StaffSee is a lightweight Fabric mod for server moderation.
Warn, mute, kick, freeze, and report players. Every action is logged to simple .txt files in your world folder.

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.

/freeze <player> [reason]
Freeze a player in place — no movement, no interactions. Useful for screenshares.

/unfreeze <player>
Remove an active freeze.

/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).

Requires OP level 2 by default, or LuckPerms nodes (see Permissions below).

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

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:

{
  "autoKickAfterWarns": 0,
  "muteMessage": "You are muted.",
  "warnBroadcast": false,
  "freezeMessage": "You are frozen by staff.",
  "logChat": true,
  "reportCooldownSeconds": 60
}

| 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. |

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) |

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

1. Install Fabric Loader and Fabric API for your Minecraft version
2. Place StaffSee.jar in your server’s mods/ folder
3. Restart the server

Done. No extra setup required.