StaffSee - 服务器管理

StaffSee - 服务器管理

StaffSee 是一个轻量级 Fabric 服务器管理模组。支持警告、禁言、踢出、冻结和举报,记录到 .txt 文件,并可选支持 LuckPerms。

管理

StaffSee 是一个用于服务器管理的轻量级 Fabric 模组。 警告、禁言、踢出、冻结和举报玩家。所有操作都会记录到世界文件夹中的简单 .txt 文件里。

仅服务端安装。原版客户端可以加入。


工作原理

StaffSee 完全在服务端运行。管理员使用斜杠命令;模组会将每个操作写入 world/StaffLog/ 中人类可读的文本文件——每位玩家一个文件夹,外加用于聊天和举报的共享审计文件。

没有数据库。没有网页面板。用任何文本编辑器打开文件即可查看。


命令

/warn <player> <reason> 警告一名玩家,并将该条目追加到其日志中。

/warns <player> 显示某位玩家最近的警告。

/mute <player> [duration] <reason> 屏蔽聊天消息。 时长:30m、2h、1d,或 perm 表示永久。

/unmute <player> 解除当前禁言。

/kick <player> <reason> 踢出一名玩家并记录原因。

/freeze <player> [reason] 将玩家冻结在原地——无法移动、无法交互。适用于查屏。

/unfreeze <player> 解除当前冻结。

/report <player> <reason> 举报一名玩家。在线管理员会立即收到通知。

/reports 列出未处理的举报(管理员)。

/reports resolve <id> 关闭一条举报并将其归档到 .txt 文件(管理员)。

默认需要 OP 等级 2,或 LuckPerms 权限节点(见下方权限部分)。


日志结构

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

每位玩家都有自己的文件夹。 管理操作被拆分到不同文件中——易于审查,易于分享。 聊天消息全局记录在 _chat/ 下,每天一个文件。


示例条目

world/StaffLog/Steve/warns.txt

[06.07.26  21:15:33]
by AdminName
Reason: Griefing spawn area

配置

首次启动时,StaffSee 会创建 config/staffsee.json:

{
  "autoKickAfterWarns": 0,
  "muteMessage": "You are muted.",
  "warnBroadcast": false,
  "freezeMessage": "You are frozen by staff.",
  "logChat": true,
  "reportCooldownSeconds": 60
}
选项 描述
autoKickAfterWarns 达到 N 次警告后自动踢出。设为 0 以禁用。
muteMessage 被禁言玩家尝试聊天时显示的消息。
warnBroadcast 向所有在线玩家广播警告。
freezeMessage 被冻结玩家尝试移动或聊天时显示的消息。
logChat 将所有聊天消息写入 _chat/YYYY-MM-DD.txt。
reportCooldownSeconds 每位玩家两次 /report 之间的冷却时间。设为 0 以禁用。

权限(可选——LuckPerms)

StaffSee 使用 fabric-permissions-api。没有 LuckPerms 时,管理命令需要 OP 等级 2。

节点 访问权限
staffsee.moderate 所有管理命令
staffsee.report /report(默认:所有人)

示例:

/lp group moderator permission set staffsee.moderate true

配套模组

StaffSee 可与 ChestSee 搭配使用——在 ChestLog/ 中记录容器交互,在 StaffLog/ 中处理玩家管理。


安装

  1. 为你的 Minecraft 版本安装 Fabric Loader 和 Fabric API
  2. 将 StaffSee.jar 放入服务器的 mods/ 文件夹
  3. 重启服务器

完成。无需额外设置。