XeroWP
J

JTZL's Bot Maze

5/5 (1 ratings) 10 active installs Updated Sep 9, 2026
ai botanti-scrapingbot protectionhoneypotsecurity
Download v1.6.2 Plugin Website

JTZL’s Bot Maze protects your WordPress site from unwanted AI crawlers and scrapers by planting invisible trap links that only bots will follow. When a bot enters the trap maze, it gets lost in an ever-expanding maze of realistic-looking fake pages while it quietly builds a suspicion score based on its behavior.

How it works:

  1. Trap link injection — Invisible links are added to your real pages. Legitimate visitors never see them, but bots following every link on the page will enter the trap maze.
  2. Lazy maze generation — Trap pages link to more trap pages, generated on demand. The deeper a bot goes, the more time it wastes.
  3. Bot scoring — Each trap page visit adds suspicion points. Deeper traversal earns bonus points. Once a threshold is reached, the visitor is flagged as a bot.
  4. Blocking and tarpitting — Flagged bots can be blocked outright (403), served decoy pages (light tarpit), or slowed down with a deliberate delay (full tarpit).
  5. Crawler verification — Known search engine crawlers (Googlebot, Bingbot, etc.) are verified via reverse DNS and exempted from scoring.

Features:

  • Zero impact on legitimate visitors — trap links are hidden from humans and search engines
  • Configurable injection method (content, footer, or both)
  • Adjustable scoring thresholds and blocking behavior
  • robots.txt integration to signal trap paths as disallowed
  • Analytics dashboard showing bot activity, top IPs, and score distribution
  • Blocked Bots detail page showing full user agent, score, visit history
  • Optional comprehensive tracking mode to monitor blocked bot persistence
  • Automatic log retention and maintenance via WP-Cron
  • Privacy policy suggestion for GDPR compliance
  • Geographic heat map of bot activity by country with two GeoIP provider options
  • MaxMind GeoLite2 local database — all lookups on your server, GDPR-friendly (recommended)
  • ip-api.com external API — simple setup, no license key required
  • Optional AbuseIPDB reporting for eligible blocked public IP addresses, with a one-press catch-up for blocked bots that carry no report yet
  • Lightweight — minimal footprint, geographic tracking is fully optional

Third-Party Services

Every external service listed below is optional and off by default. No data is sent to any of them unless a site administrator explicitly enables the corresponding feature.

MaxMind GeoLite2 (Recommended)

When MaxMind GeoLite2 is selected as the GeoIP provider (Settings > Bot Maze > Geographic Tracking), the plugin downloads the GeoLite2-Country database from MaxMind and performs all IP-to-country lookups locally. No visitor data leaves your server.

ip-api.com

When ip-api.com is selected as the GeoIP provider, the plugin sends visitor IP addresses to ip-api.com to resolve their country of origin. This data is used to display a geographic heat map of bot activity in the admin dashboard.

  • What is sent: The visitor’s IP address only, over unencrypted HTTP.
  • When it is sent: At the time a trap page visit is recorded, only while this provider is selected.
  • Service website: http://ip-api.com
  • Terms of service: https://ip-api.com/docs/legal
  • Privacy policy: ip-api.com does not log queries from the free API endpoint.
  • Note: The free tier only supports HTTP (not HTTPS). If your site must comply with GDPR, use the MaxMind local database option instead.

Geographic tracking is off by default and requires explicit opt-in by a site administrator.

AbuseIPDB Reporting

AbuseIPDB reporting is off by default. It requires explicit enablement plus an administrator-owned AbuseIPDB account and API key from the API dashboard. Protect the API key like a password.

An address is queued for reporting in exactly three situations:

  1. A non-verified crawler’s persisted score crosses the configured blocking threshold.
  2. An address that is already blocked requests a trap page while reporting is on, which is fresh evidence it is still crawling the maze.
  3. An administrator presses the catch-up button on the Blocked Bots page, which covers blocked addresses AbuseIPDB has not accepted a report for, whatever the reason.

Every queued address must also be publicly routable. Private, loopback, reserved, documentation and multicast addresses are never reported, because AbuseIPDB only accepts reports about addresses reachable on the public internet. Verified search engine crawlers are never scored in the first place, so they are never candidates.

The catch-up in (3) reports each address against the time it was actually last seen, rather than the time the button was pressed, and covers addresses seen within your configured data retention period (Settings > Bot Maze > Maintenance, 30 days by default). That is the period you have declared this evidence meaningful for, and the same period after which the plugin deletes the record, so the catch-up offers exactly the blocked addresses your site still holds evidence for. It reports up to 500 addresses per press.

In all three cases the report sends only the public IP address, category 19 (Bad Web Bot), the time of the observation being reported, and a generic explanation for security reporting. It sends these four fields over HTTPS to the AbuseIPDB service. It never sends the user agent, referrer, trap URL, session, score, or traversal depth.

The plugin limits reports to once per IP address in any 24-hour period. A queued report that cannot be delivered for seven days is abandoned. Delivery runs in the background through WP-Cron, so reports may wait on low-traffic sites and are not real-time. Disabling reporting or clearing the key stops delivery and deletes queued reports.

The current free Individual plan includes 1,000 IP checks and reports per day. See AbuseIPDB pricing; your account limit may differ. Review AbuseIPDB’s terms and privacy policy before enabling reporting.

Cloudflare IP Ranges

When the Trusted Client IP Header is set to Cloudflare (CF-Connecting-IP) (Settings > Bot Maze > Trusted Proxy), the plugin fetches Cloudflare’s published edge IP range lists from cloudflare.com to keep the trusted-proxy allowlist current without any manual action.

This fetch only runs while the Cloudflare trusted client IP header is selected. If the fetch fails validation, the previously stored list (or a bundled fallback) is kept — a failed response never narrows or widens the trusted set.