CommandSpy

CommandSpy

轻量级命令间谍插件，支持开关、日志记录及可配置消息格式。

实用

🕵️ CommandSpy

CommandSpy 是一款用于 Hytale 服务器的轻量级管理与审计工具。

获得授权的管理人员可以实时监控玩家的命令、私信和控制台活动。每个类别都有独立的权限和个人过滤器，可通过命令或简洁的游戏内界面进行管理。

可选的本地审计日志会为每次服务器启动将每个类别记录在独立的带时间戳的文件中。

 

 

✨ 功能特性

✔ 玩家、私信和控制台监控
✔ 独立的权限和个人过滤器
✔ 总开关控制
✔ 简洁的游戏内控制面板
✔ 完整的命令控制
✔ 按 UUID 存储的持久化设置
✔ 可配置的本地审计日志
✔ 每次启动使用独立的日志文件
✔ 防止重复条目
✔ 排除包含凭据的命令
✔ 内置七种语言
✔ 可自定义消息和颜色
✔ 无依赖项或外部数据传输

 

 

🖥️ 控制与权限

使用 /cmdspy gui 打开界面。

面板包含以下独立控制项：

总监控
私信
玩家命令
控制台

不可用的类别仍会显示，但无法修改。关闭总监控会暂停所有监控，但不会改变已选的类别过滤器。

完全访问权限

command.spy

命令：

/cmdspy 或 /commandspy — 切换总监控
/cmdspy gui — 打开控制面板
/cmdspy reload — 重新加载配置和已保存的状态

/cmdspy messages — 切换私信监控 - command.spy.messages

/cmdspy commands — 切换玩家命令监控 - command.spy.commands

/cmdspy console — 切换控制台监控 - command.spy.console

权限是累加的。完整的 command.spy 权限授予所有类别的访问权和管理控制权。

 

 

🔎 监控

玩家命令
无论命令由哪个模组注册，都能被检测到。

私信
识别常见的命令，如 /msg、/m、/pm、/tell、/w、/whisper、/r、/reply 和 /mail send。

私信与普通命令分开记录。

控制台命令
检测通过服务器控制台直接执行的命令。

与登录、注册、密码、PIN 码、一次性代码及类似凭据相关的命令会在监控或记录前被忽略。

 

 

📝 审计日志

CommandSpy 会在每次服务器启动时在以下位置创建一个独立的审计文件：

mods/CommandSpy/logs/

示例：2026-08-05_17-59-12_commands.log

日志功能通过以下选项独立配置：

log-player-commands
log-private-messages
log-console-commands

任意组合都可以启用，也可以完全不进行本地记录。

日志设置只影响审计文件。它们不会改变管理人员的权限或实时监控过滤器。

审计日志可能包含命令参数和私人对话，因此 CommandSpy 文件夹的访问权限应限制给可信的管理员。

 

 

⚙️ 文件与配置

CommandSpy 使用：mods/CommandSpy/

config.json / spy-state.json/ console-state.json/ server.lang/ logs/

管理人员设置会按 UUID 自动保存。

缺失的配置选项会自动添加，同时保留现有值。

 

 

🌍 语言与自定义

内置语言：

英语 / 意大利语 / 德语 / 法语 / 西班牙语 / 巴西葡萄牙语 / 俄语

系统会自动为每位玩家选择正确的语言。

聊天消息、监控格式、界面标签、错误提示和说明都可以通过 server.lang 进行自定义。

支持的颜色包括 &0–&f、&r 以及诸如 &#55FF55 的十六进制代码。

可用的占位符包括：

{player}
{command}

对内置语言资源的修改需要重启服务器才能生效。

 

 

📦 安装

  1. 将 CommandSpy JAR 文件放入服务器的 mods 文件夹中。

  2. 移除重复的 CommandSpy JAR 文件。

  3. 重启服务器。

  4. 分配 command.spy 或所需的类别权限。

  5. 使用 /cmdspy 或 /cmdspy gui。

更新时保留现有的 mods/CommandSpy 文件夹，以保存管理人员设置和日志。

 

 

✅ 兼容性

✔ Hytale Server 0.5.x
✔ 已在 Hytale Server 0.5.7 上测试
✔ 与权限管理插件兼容
✔ 无永久 HUD 覆盖层
✔ 隔离的 UI 资源以减少冲突
✔ 专为多人游戏和生产服务器设计

 

 

💙 灵感来源

灵感来自 Minecraft 服务器社区的命令监视（command-spy）和社交监视（social-spy）工具。

在等待 Hytale 出现类似工具无果后，我决定自己创建一个，既作为实用工具，也作为对原始概念的致敬。

 

 

AI 声明

ChatGPT 协助了封面图绘制、翻译、文档编写、代码清理建议和总体审查。

所有实现、测试、配置选择、编辑和发布决定均由我人工审查。

 

 

⭐ 最新完整版

CurseForge 版本仍然是 CommandSpy 的原版免费版本。

CommandSpy 的新扩展版可在 BuiltByBit 上获取。

在 BuiltByBit 上查看完整版本： https://builtbybit.com/resources/commandspy.100988/