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 `** Warn a player and append the entry to their log. **`/warns `** Show recent warnings for a player. **`/mute [duration] `** Block chat messages. Durations: `30m`, `2h`, `1d`, or `perm` for permanent. **`/unmute `** Remove an active mute. **`/kick `** Kick a player and log the reason. **`/freeze [reason]`** Freeze a player in place — no movement, no interactions. Useful for screenshares. **`/unfreeze `** Remove an active freeze. **`/report `** Report a player. Online staff are notified instantly. **`/reports`** List open reports (staff). **`/reports resolve `** 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`: ```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](https://modrinth.com/mod/chestsee-chestlogger)** — 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.

MafuuuX