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.