{"id":44469,"date":"2026-06-02T05:43:25","date_gmt":"2026-06-02T02:43:25","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/"},"modified":"2026-06-02T05:43:25","modified_gmt":"2026-06-02T02:43:25","slug":"command-block-spy","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/","title":{"rendered":"Command Block Spy"},"content":{"rendered":"

# \ud83d\udd75\ufe0f\u200d\u2642\ufe0f CommandBlockSpy<\/p>\n

\u7b80\u4f53\u4e2d\u6587<\/p>\n

![Java Version](https:\/\/www.oracle.com\/java\/technologies\/javase\/jdk17-archive-downloads.html)
\n![Minecraft Version](https:\/\/www.minecraft.net\/en-us\/article\/minecraft-java-edition-1-21-4)
\n![Paper Version](https:\/\/papermc.io\/)
\n![License: MIT](https:\/\/opensource.org\/licenses\/MIT)
\n![Command Block Spy on Modrinth](https:\/\/modrinth.com\/plugin\/command-block-spy)
\n![GitHub – command-block-spy](https:\/\/github.com\/GoldenEggs-Workshop\/command-block-spy)<\/p>\n

\ud83d\udccc **CommandBlockSpy (CBS)** is a plugin designed for creative Minecraft servers with high degrees of freedom (command blocks enabled). It helps server admins manage command block activity by recording execution data and offering command control and security monitoring.<\/p>\n

\u2705 Tested on **Minecraft 1.21.4**, built on **Paper**.<\/p>\n

## \u2728 Plugin Features<\/p>\n

\ud83d\udcdd **SQLite-Based Execution Logging**
\nAutomatically records each command block\u2019s execution count, command content, last execution time, and coordinates into a database.<\/p>\n

\ud83d\udd14 **Real-Time Monitoring**
\nA toggleable real-time command monitoring system for both console and players.<\/p>\n

\ud83d\udeab **Dangerous Command Interception**
\nSupports custom regex-based interception rules, with customizable messages when blocked.<\/p>\n

\ud83d\udd01 **Repeating Command Block Interception**
\nOptionally intercepts repeating command blocks that are always active (`auto=true`).<\/p>\n

\u26a0\ufe0f **Disable Command Block Minecarts**
\nOptionally prevents players from placing command block minecarts.<\/p>\n

## \ud83e\uddea Available Commands<\/p>\n

| Command | Description | Permission |
\n|——————————–|—————————————————|—————-|
\n| `\/cbspy` | Toggle chat monitoring prompts | `cbspy.use` |
\n| `\/cbspy reload` | Reload plugin configuration | `cbspy.reload` |
\n| `\/cbspy query loc ` | Query execution history of a specific location | `cbspy.query` |
\n| `\/cbspy query recent ` | Query the most recent `` execution records | `cbspy.query` |<\/p>\n

—<\/p>\n

## \u2699\ufe0f Configuration Example<\/p>\n

> Note: All features are **disabled by default**. Please enable them as needed.<\/p>\n

“`yaml
\n# CBS\u63d2\u4ef6\u914d\u7f6e\u6587\u4ef6
\n# CBS Plugin Configuration<\/p>\n

# \u63d2\u4ef6\u8bed\u8a00\uff0c\u652f\u6301\u4e2d\u6587\uff08zh_CN\uff09\u548c\u82f1\u6587\uff08en_US\uff09
\n# Plugin language, supports Chinese (zh_CN) and English (en_US)
\nlanguage: zh_CN<\/p>\n

# \u662f\u5426\u542f\u7528\u6570\u636e\u5e93\u529f\u80fd
\n# Enable database logging
\ndatabase-logging-enabled: false<\/p>\n

# \u662f\u5426\u5f00\u542f\u540e\u53f0\u547d\u4ee4\u6267\u884c\u65e5\u5fd7\u76d1\u63a7\uff0c\u5f00\u542f\u540e\u63a7\u5236\u53f0\u4f1a\u6253\u5370\u547d\u4ee4\u65b9\u5757\u6267\u884c\u8bb0\u5f55
\n# Enable backend monitoring (logs to console)
\nbackend-monitor-enabled: false<\/p>\n

# \u662f\u5426\u62e6\u622a\u5faa\u73af\u547d\u4ee4\u65b9\u5757\u4fdd\u6301\u5f00\u542f\uff08auto=true\uff09\u7684\u547d\u4ee4\uff0c\u62e6\u622a\u540e\u4f1a\u81ea\u52a8\u8bbe\u7f6e\u4e3a\u7ea2\u77f3\u63a7\u5236
\n# Intercept always-on repeating command blocks (auto=true)
\nintercept-repeating-auto: false<\/p>\n

# \u662f\u5426\u7981\u6b62\u547d\u4ee4\u65b9\u5757\u77ff\u8f66\uff0c\u5f00\u542f\u540e\u73a9\u5bb6\u4f1a\u65e0\u6cd5\u653e\u7f6e\u547d\u4ee4\u65b9\u5757\u77ff\u8f66
\n# Disable command block minecarts
\nban-command-minecart: false<\/p>\n

# \u662f\u5426\u542f\u7528\u57fa\u4e8e\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u547d\u4ee4\u62e6\u622a\u529f\u80fd\uff0c\u62e6\u622a\u5339\u914d\u89c4\u5219\u7684\u6307\u4ee4\u5e76\u63d0\u793a\u539f\u56e0
\n# Enable regex-based command interception
\nregex-intercept-enabled: false<\/p>\n

# \u6b63\u5219\u8868\u8fbe\u5f0f\u62e6\u622a\u5217\u8868\uff0c\u683c\u5f0f\uff1a\u6b63\u5219\u8868\u8fbe\u5f0f: \u62e6\u622a\u63d0\u793a\u4fe1\u606f
\n# Regex interception list
\n# \u652f\u6301\u5e38\u89c1\u6b63\u5219\u8868\u8fbe\u5f0f\u8bed\u6cd5\uff0c\u4f8b\u5982\uff1a
\n# Format: regex pattern : block message
\nregex-block-list:
\n – pattern: ^say
\n message: \u7981\u6b62\u4f7f\u7528 say \u547d\u4ee4\uff01 # The ‘say’ command is not allowed!
\n“`<\/p>\n

## \ud83d\ude80 Quick Installation<\/p>\n

1. **Download the plugin**:<\/p>\n

* Modrinth Download
\n * GitHub Releases<\/p>\n

2. **Install to your server**:<\/p>\n

* Place the JAR file into your `plugins\/` folder
\n * Restart the server<\/p>\n

## \ud83d\udce6 Build & Install from Source<\/p>\n

Clone the project:<\/p>\n

“`bash
\ngit clone https:\/\/github.com\/GoldenEggs-Workshop\/command-block-spy
\ncd command-block-spy
\n“`<\/p>\n

Build the plugin:<\/p>\n

“`bash
\n.\/gradlew build
\n“`<\/p>\n

Copy `build\/libs\/commandblockspy-xxx.jar` to your server’s `plugins\/` folder, then restart the server.<\/p>\n

## \ud83d\udd10 Permission Nodes<\/p>\n

| Permission Node | Description |
\n|—————–|—————————–|
\n| `cbspy.use` | Toggle chat alerts |
\n| `cbspy.reload` | Reload plugin configuration |
\n| `cbspy.query` | Use query-related features |<\/p>\n

## \ud83d\udca1 TODO Roadmap<\/p>\n

* Full support for command block minecarts (logging\/interception\/disabling)
\n* Custom database configuration
\n* Multi-platform notification integration (Feishu \/ DingTalk \/ Discord)
\n* Visual query interface
\n* \u221a i18n (internationalization) support<\/p>\n

## \ud83d\udcc4 **License**<\/p>\n

This project is licensed under the **MIT License**. You are free to modify and use the plugin. For commercial deployment, please credit the original source.<\/p>\n","protected":false},"excerpt":{"rendered":"

[Open Source] Monitor\/Intercept Server Command Block<\/p>\n","protected":false},"featured_media":44470,"template":"","meta":{"_minecraft_slug":"command-block-spy","_minecraft_project_id":"YA8IJJg0","_minecraft_author":"DeepBlueIX","_minecraft_license":"MIT","_minecraft_downloads":75,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"command-block-spy.zip","_minecraft_size_bytes":3304173,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:21:11.453467Z","_minecraft_date_created":"2025-08-01T03:51:35.767700Z","_minecraft_date_modified":"2025-07-29T10:03:51.332268Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/command-block-spy","_minecraft_icon_attachment_id":44470,"_minecraft_imported_at":"2026-06-02T02:43:26+00:00","_minecraft_import_hash":"ab5b69da5644dc3dc2e5ead3805afb30","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,90,127,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-44469","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nCommand Block Spy - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Command Block Spy - Minecraft\" \/>\n<meta property=\"og:description\" content=\"[Open Source] Monitor\/Intercept Server Command Block\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/\",\"name\":\"Command Block Spy - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/command-block-spy-icon-b28f0ae3e3cd6fb4ffb8f7711607ed8ac2da4d36_96.webp\",\"datePublished\":\"2026-06-02T02:43:25+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/command-block-spy-icon-b28f0ae3e3cd6fb4ffb8f7711607ed8ac2da4d36_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/command-block-spy-icon-b28f0ae3e3cd6fb4ffb8f7711607ed8ac2da4d36_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/command-block-spy\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Command Block Spy\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Command Block Spy - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/","og_locale":"en_US","og_type":"article","og_title":"Command Block Spy - Minecraft","og_description":"[Open Source] Monitor\/Intercept Server Command Block","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/","name":"Command Block Spy - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/command-block-spy-icon-b28f0ae3e3cd6fb4ffb8f7711607ed8ac2da4d36_96.webp","datePublished":"2026-06-02T02:43:25+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/command-block-spy-icon-b28f0ae3e3cd6fb4ffb8f7711607ed8ac2da4d36_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/command-block-spy-icon-b28f0ae3e3cd6fb4ffb8f7711607ed8ac2da4d36_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/command-block-spy\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Command Block Spy"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/44469","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/44470"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=44469"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=44469"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=44469"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=44469"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}