原创 开源 [1.13-26.x] TinyWatch 网页监控面板 · 实时日志 / 世界管理 / 网页操作 1.1.1

它是什么

一个装在服务端里的网页面板。不是地图，也不是回档工具 —— 它回答的是同一个问题：

现在，服务器里正在发生什么？

玩家坐标、血量、饥饿、延迟、在线时长；服务器 TPS、MSPT、内存、实体数；谁挖了方块、
开了谁的箱子、敲了什么命令、在聊天框说了什么。全部实时，1 秒刷新，SSE 推送，不用手动刷页面。

和别的插件不一样在哪

市面上两类工具都很好，但不是同一件事：

• Plan：功能极全，但 jar 装完 20+ MB、要数据库、全英文，而且数据是定时聚合的 —— 你看到的是「过去 30 分钟」。
• CoreProtect：方块日志的标杆，但它是事后回滚工具，没有实时面板，也不看服务器负载。

TinyWatch 只做「现在正在发生什么」。它不替代上面两个，也不需要替代。

特色是这三条：

• 纯中文界面，物品名、方块名、提示语都是中文，不用对着英文猜。
• 零依赖单 jar：不用 Vault、不用 PlaceholderAPI、不用数据库，网页本身打包在插件里。
• 能在网页上直接操作：踢人、封禁、禁言、给物品、传送到坐标、改世界时间和天气。

面板有 8 个页签

概览：TPS / MSPT / 内存 / 实体数三条曲线，最近 5 分钟。
玩家：在线玩家表，点进去看背包、装备、最近操作、最近 5 分钟走位轨迹。
聊天：玩家发言 + 系统公告 + 插件提示 + 指令，按类筛选，可导出 CSV。
日志：破坏 / 放置 / 容器 / 命令 / 死亡 / 进出服 / 管理操作，按玩家、类型、关键词筛选。
世界：主世界、下界、末地分别设时间、天气、难度、14 条游戏规则、出生点、边界。
插件：列出所有已装插件，看监听器数量、命令数、任务数、jar 大小，点开看依赖详情。
黑名单：服务器封禁和网页封禁合并成一张表，一键解除。
系统：版本检查、只读分享链接、处罚记录、计划任务。

几个用得上但别人没有的

• 预警横幅：TPS 掉下去、内存快满、实体数爆、有人一分钟拆了一百个方块 —— 顶部直接挂红条，恢复正常自动消失。
• 玩家轨迹：最近 5 分钟的走位画成俯视图。查「谁拆了我的房子」比翻日志快得多。
• 撤销：给错 OP、清错背包、传错人，5 分钟内点「撤销」就能反着做一遍。
• 处罚记录落盘：禁言了谁、为什么、到什么时候，重启服务器后禁言还在。
• 只读分享链接：给别的管理员一个只能看不能操作的临时链接，到期自动失效。
• 计划任务：定时广播、定时保存世界、定时清掉落物。

安装

1. 把 tinywatch-1.1.1.jar 放进 plugins/ 目录
2. 重启服务器
3. 控制台会打印一个自动生成的登录密码，只显示这一次，记下来

然后浏览器打开 http://服务器ip:8123/ ，输入密码即可。

忘了密码：游戏里执行 /watch 新密码 重新生成一个。

关于安全（请一定看一下）

默认监听 0.0.0.0，也就是装完就能从外网打开。方便，但意味着登录页对全网可见，只有密码挡着。

长期使用建议二选一：

• 前面挂 nginx / Caddy 反代，插件改监听 127.0.0.1，对外走 HTTPS；
• 或者至少在防火墙 / 安全组里限制来源 IP，只放行自己的地址。

插件本身的安全措施：密码只存 PBKDF2 哈希（配置文件里没有明文）、登录失败 5 次按 IP 锁 5 分钟、
只读分享链接的写操作直接 403。

配置

配置文件是 plugins/TinyWatch/config.yml，每一项都有中文注释。改完执行 /watch 重载 生效，不用重启。

升级插件不会丢配置：启动时会自动把新版本新增的项补进去，你改过的值、注释都会保留，
动手前还会先备份成 config.yml.bak。

已知限制

• 操作日志只存在内存里，重启清空（要长期存档请配合 CoreProtect）。
• 不能跨服，多个子服要每个服装一个。
• 插件页不给「内存占用」数字 —— Bukkit 没有按插件拆分内存的接口，编一个只会误导判断。
• 只记录插件装上之后发生的事，装之前的方块改动查不到。

开源

GitHub：https://github.com/TinyAII/TinyWatch （MIT）

有 bug 或者想要的功能，在这里回帖或者开 issue 都行。