🕵️‍♂️ CommandBlockSpy

📌 创必查(CBS) 是一个专为较高自由度的创造服（开放命令方块）设计的插件，为便于管理，记录命令方块的执行情况，并提供命令控制与安全监控功能。

✅ 在 Minecraft 1.21.4 通过测试，基于 Paper 构建。

✨ 插件特性

📝 基于SQLite的执行记录 自动将每个命令方块的执行次数、命令内容、最后执行时间和坐标保存至数据库

🔔 实时提醒 后台及玩家可自由开关的实时命令监控系统

🚫 危险命令拦截 可自定义正则规则拦截命令，并在触发时提示拦截原因

🔁 循环命令方块拦截 可配置是否拦截保持开启的循环命令方块

⚠️ 禁用命令方块矿车 可配置是否禁用命令方块矿车

🧪 指令一览

指令	功能描述	所需权限
`/cbspy`	切换是否显示聊天监控提示	`cbspy.use`
`/cbspy reload`	重载插件配置	`cbspy.reload`
`/cbspy query loc <x> <y> <z>`	查询指定位置的历史执行记录	`cbspy.query`
`/cbspy query recent <count>`	查询最近执行的 `<count>` 条记录	`cbspy.query`

⚙️ 配置文件示例

注意: 所有功能默认关闭，请根据需要自行开启。

# CBS插件配置文件
# CBS Plugin Configuration

# 插件语言，支持中文（zh_CN）和英文（en_US）
# Plugin language, supports Chinese (zh_CN) and English (en_US)
language: zh_CN

# 是否启用数据库功能
# Enable database logging
database-logging-enabled: false

# 是否开启后台命令执行日志监控，开启后控制台会打印命令方块执行记录
# Enable backend monitoring (logs to console)
backend-monitor-enabled: false

# 是否拦截循环命令方块保持开启（auto=true）的命令，拦截后会自动设置为红石控制
# Intercept always-on repeating command blocks (auto=true)
intercept-repeating-auto: false

# 是否禁止命令方块矿车，开启后玩家会无法放置命令方块矿车
# Disable command block minecarts
ban-command-minecart: false

# 是否启用基于正则表达式的命令拦截功能，拦截匹配规则的指令并提示原因
# Enable regex-based command interception
regex-intercept-enabled: false

# 正则表达式拦截列表，格式：正则表达式: 拦截提示信息
# Regex interception list
# 支持常见正则表达式语法，例如：
# Format: regex pattern : block message
regex-block-list:
   - pattern: ^say
     message: 禁止使用 say 命令！ # The 'say' command is not allowed!

🚀 快速安装

下载插件：
- Modrinth下载
- GitHub Releases
安装到服务器：
- 将JAR文件放入plugins/文件夹
- 重启服务器

📦 构建 & 安装

克隆项目到本地：

git clone https://github.com/GoldenEggs-Workshop/command-block-spy
cd command-block-spy

构建插件：

./gradlew build

将 build/libs/commandblockspy-xxx.jar 拷贝至服务器 plugins/ 文件夹，重启服务器。

🔐 权限节点

权限节点	功能描述
`cbspy.use`	切换聊天提醒
`cbspy.reload`	重载插件配置
`cbspy.query`	查询记录相关功能

💡 TODO 计划

[ ] 支持命令方块矿车的完整功能（记录/拦截/禁用）
[ ] 自定义数据库配置
[ ] 多平台通知集成（飞书/钉钉/Discord）
[ ] 可视化查询界面
√ i18n支持

📄 许可证

本项目使用 MIT 协议发布。你可以自由修改和使用本插件，商业部署请注明来源。

创必查Command Block Spy

基本信息

我的世界Java版本

平台

运行环境

其他链接

创作团队

详情信息