ServerSeekerBlocker

ServerSeeker is a publicly available tool that mass-scans the internet for open Minecraft servers, logs player data, and lets anyone look up which servers a player has visited. If you run a private or semi-private server, ServerSeeker bots will find you, join, collect data, and leave — and by default, your server logs every one of those visits.

ServerSeekerBlocker stops them cold — silently, and without a trace.

Blocked connection attempts are intercepted before the player ever fully joins, so no joined the game message is broadcast, no log entry is written, and to blocked IPs, your server appears completely offline in the multiplayer list.

Not just ServerSeeker — block any unwanted connection by name, IP, or UUID. Scanner bots, griefers, banned players, or anyone else you don't want on your server.

---

Features

• 🔇 Silent blocking — blocked players are denied at the pre-login stage. No join message, no console output, nothing.
• 🌐 Ping hiding — blocked IPs receive no server list response. Your server looks offline to them entirely.
• 🗂️ Three blocking methods — block by player name, IP address, or UUID. Each can be toggled independently.
• 🚪 Transfer mode — instead of kicking, silently redirect blocked players to another server using Minecraft's built-in Transfer Packet.
• 📋 Log suppression — a Log4j2 filter intercepts any log message containing a blocked name or IP before it reaches the console or log file.
• 🌍 Multi-language support — all plugin messages are defined in swappable lang/ YAML files. English and Korean are bundled.
• 🔄 Live reload with diff — /ssb reload applies changes instantly and prints a color-coded diff showing exactly what changed.

---

Requirements

| Item | Requirement |
|------|-------------|
| Server software | Paper or Purpur (Spigot / CraftBukkit not supported) |
| Minecraft version | 1.20.6 or higher |
| Java version | Java 21 or higher |

---

Installation

1. Drop the JAR into your server's plugins/ folder.
2. Start the server — plugins/ServerSeekerBlocker/ will be created automatically.
3. Edit config.yml to add the names, IPs, or UUIDs you want to block.
4. Run /ssb reload to apply changes without restarting.

---

config.yml

language: en_US
debug: false

blocking:
  name:
    enabled: true
    list:
      - "BotUsername"
  ip:
    enabled: true
    list:
      - "0.0.0.0"
  uuid:
    enabled: true
    list:

transfer:
  enabled: false
  host: ""
  port: 25565

hide-ping:
  enabled: true

suppress-logs:
  enabled: true

Options

| Key | Default | Description |
|-----|---------|-------------|
| language | en_US | Language file to use (filename in the lang/ folder) |
| debug | false | Log blocked/transferred players to console when true |
| blocking.name.enabled | true | Enable name-based blocking |
| blocking.name.list | [] | List of player names to block |
| blocking.ip.enabled | true | Enable IP-based blocking |
| blocking.ip.list | [] | List of IP addresses to block |
| blocking.uuid.enabled | true | Enable UUID-based blocking |
| blocking.uuid.list | [] | List of UUIDs to block |
| transfer.enabled | false | Redirect blocked players to another server instead of kicking |
| transfer.host | "" | Target server address for transfer |
| transfer.port | 25565 | Target server port for transfer |
| hide-ping.enabled | true | Make the server appear offline to blocked IPs |
| suppress-logs.enabled | true | Suppress console logs related to blocked players |

---

Commands

| Command | Permission | Description |
|---------|------------|-------------|
| /ssb reload | OP | Reloads config.yml and displays a color-coded diff of changes |

---

Language Support

Language files are automatically extracted to plugins/ServerSeekerBlocker/lang/ on first start.
Change the language value in config.yml and run /ssb reload to switch instantly.

Bundled languages

• en_US — English
• ko_KR — Korean

To add a new language, create a lang/yourlanguage.yml file using the same keys as an existing file.

---

How It Works

Block mode (transfer.enabled: false)

Players are blocked at the AsyncPlayerPreLoginEvent stage — before they fully join the server. No joined the game message is ever logged or broadcast.

Transfer mode (transfer.enabled: true)

At PlayerJoinEvent, the join message is suppressed and the player is immediately redirected to the configured server using Minecraft's Transfer Packet.

Ping hiding (hide-ping.enabled: true)

When a blocked IP pings the server from the multiplayer list, the response is dropped entirely. The server appears offline to that client.

Only the IP list is checked — usernames and UUIDs are not available at the ping stage.

Log suppression (suppress-logs.enabled: true)

A Log4j2 filter is installed on the root logger at startup. Any log message containing a blocked name or IP is intercepted before it reaches the console or log file.

---

Notes

• Paper / Purpur only. The plugin uses Paper-exclusive APIs and will not load on Spigot or CraftBukkit.
• hide-ping only checks the IP list — name/UUID filtering is not possible at the ping stage.