ServerSeekerBlocker
ServerSeeker 是一款公开可用的工具,它会对互联网进行大规模扫描以查找开放的 Minecraft 服务器,记录玩家数据,并允许任何人查询某个玩家访问过哪些服务器。如果你运行的是私有或半私有服务器,ServerSeeker 的机器人会找到你、加入服务器、收集数据然后离开——并且默认情况下,你的服务器日志会记录每一次这样的访问。
ServerSeekerBlocker 彻底阻止它们——悄无声息,不留痕迹。
被阻止的连接尝试在玩家完全加入之前就被拦截了,因此不会广播 joined the game(加入了游戏)消息,不会写入日志条目,对于被阻止的 IP 来说,你的服务器在多人游戏列表中看起来完全处于离线状态。
不仅仅是 ServerSeeker——你可以按名称、IP 或 UUID 阻止任何不需要的连接。无论是扫描机器人、破坏者、被封禁的玩家,还是其他任何你不希望出现在你服务器上的人。
功能特性
- ? 静默阻止 — 被阻止的玩家在预登录阶段即被拒绝。无加入消息,无控制台输出,无任何痕迹。
- ? Ping 隐藏 — 被阻止的 IP 无法收到服务器列表响应。对它们而言,你的服务器完全显示为离线。
- ?️ 三种阻止方式 — 支持按玩家名称、IP 地址或 UUID 进行阻止。每种方式均可独立启用或禁用。
- ? 转移模式 — 与其踢出玩家,不如使用 Minecraft 内置的 Transfer Packet(传输数据包),将被阻止的玩家静默重定向到另一台服务器。
- ? 日志抑制 — Log4j2 过滤器会在包含被阻止名称或 IP 的任何日志消息到达控制台或日志文件之前将其拦截。
- ? 多语言支持 — 所有插件消息均定义在可替换的
lang/ YAML 文件中。已捆绑英文和韩文。
- ? 实时重载与差异对比 —
/ssb reload 即时应用更改,并打印颜色编码的差异对比,清晰显示具体变更内容。
- ℹ️ 一目了然的状态信息 —
/ssb info 显示当前运行版本、Modrinth 上的最新版本以及每个开关的当前状态。
- ⛔ 运行时封禁命令 —
/ssb ban、/ssb pardon、/ssb ban-ip、/ssb pardon-ip、/ssb ban-uuid、/ssb pardon-uuid 可直接编辑并重载 config.yml,无需手动编辑文件。UUID 封禁通过玩家名称输入并自动解析,因此即使玩家更改名称也能继续生效。
- ? 更新检查器 — 定期检查 Modrinth,并在有新版本可用时通知控制台和在线 OP。
要求
| 项目 |
要求 |
| 服务端软件 |
Paper 或 Purpur(不支持 Spigot / CraftBukkit) |
| Minecraft 版本 |
1.20.6 或更高 |
| Java 版本 |
Java 21 或更高 |
安装
- 将 JAR 文件放入服务端的
plugins/ 文件夹中。
- 启动服务器 —
plugins/ServerSeekerBlocker/ 目录会自动创建。
- 编辑
config.yml 以添加你想要阻止的名称、IP 或 UUID。
- 运行
/ssb reload 以应用更改而无需重启服务器。
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
update-checker:
enabled: true
选项说明
| 键值 |
默认值 |
描述 |
language |
en_US |
要使用的语言文件(lang/ 文件夹中的文件名) |
debug |
false |
当设为 true 时,将阻止/转移的玩家记录到控制台 |
blocking.name.enabled |
true |
启用基于名称的阻止 |
blocking.name.list |
[] |
要阻止的玩家名称列表 |
blocking.ip.enabled |
true |
启用基于 IP 的阻止 |
blocking.ip.list |
[] |
要阻止的 IP 地址列表 |
blocking.uuid.enabled |
true |
启用基于 UUID 的阻止 |
blocking.uuid.list |
[] |
要阻止的 UUID 列表 |
transfer.enabled |
false |
将阻止的玩家重定向到另一台服务器而不是踢出 |
transfer.host |
"" |
转移目标服务器的地址 |
transfer.port |
25565 |
转移目标服务器的端口 |
hide-ping.enabled |
true |
使服务器对被阻止的 IP 显示为离线 |
suppress-logs.enabled |
true |
抑制与控制台相关的被阻止玩家的日志 |
update-checker.enabled |
true |
检查 Modrinth 上是否有新版本发布 |
命令
| 命令 |
权限 |
描述 |
/ssb info |
OP |
显示运行版本、Modrinth 上的最新版本以及当前设置 |
/ssb reload |
OP |
重载 config.yml 并显示颜色编码的变更差异对比 |
/ssb ban <name> |
OP |
将玩家名称添加到阻止列表并保存 config.yml |
/ssb pardon <name> |
OP |
从阻止列表中移除玩家名称 |
/ssb ban-ip <ip> |
OP |
将 IPv4 地址添加到阻止列表 |
/ssb pardon-ip <ip> |
OP |
从阻止列表中移除 IPv4 地址 |
/ssb ban-uuid <name> |
OP |
查找玩家 UUID 并将其添加到阻止列表 |
/ssb pardon-uuid <name> |
OP |
查找玩家 UUID 并将其从阻止列表中移除 |
ban-uuid 和 pardon-uuid 为了方便起见接受玩家名称作为输入,但存储的是UUID,因此即使玩家更改名称,该条目仍能继续生效。在线玩家和曾见过的玩家会立即解析;其他玩家则通过 Mojang API 异步查询,因此服务器永远不会卡住。在离线模式服务器中,UUID 会在本地根据名称生成。
语言支持
首次启动时,语言文件会自动提取到 plugins/ServerSeekerBlocker/lang/ 目录中。
更改 config.yml 中的 language 值并运行 /ssb reload 即可即时切换语言。
捆绑语言
要添加新语言,请使用与现有文件相同的键值创建一个 lang/yourlanguage.yml 文件。
工作原理
阻止模式(transfer.enabled: false)
玩家在 AsyncPlayerPreLoginEvent 阶段被拦截——此时他们尚未完全加入服务器。不会记录或广播任何“已加入游戏”的消息。
转移模式(transfer.enabled: true)
在 PlayerJoinEvent 时,加入消息会被抑制,并且玩家会通过 Minecraft 的传输数据包立即被重定向到配置的目标服务器。
Ping 隐藏(hide-ping.enabled: true)
当被阻止的 IP 从多人游戏列表中 ping 服务器时,响应将被完全丢弃。对该客户端而言,服务器显示为离线状态。
仅检查 IP 列表——在 ping 阶段无法获取用户名和 UUID。
日志抑制(suppress-logs.enabled: true)
在启动时,根日志记录器上安装了一个 Log4j2 过滤器。任何包含被阻止的名称、IP 或 UUID 的日志消息都会在到达控制台或日志文件之前被拦截。
服务器打印的某些关于拒绝连接的消息可能只提及上述三者之一——例如,“Disconnecting Foo (/1.2.3.4)”不包含 UUID——因此当连接被阻止时,插件还会短暂记录该尝试的名称、IP 和 UUID,并对这些值也进行过滤。这些观测到的值会在 30 秒后过期,因此后来属于其他玩家的名字永远不会继续隐藏该玩家的日志行。
更新检查器(update-checker.enabled: true)
在启动后不久,以及此后每 6 小时,插件会查询 Modrinth API 以获取其自身项目的最新信息,并将最新发布的版本与当前运行版本进行比较。如果存在更新版本,则会在每次服务器启动时向控制台打印一次警告(后续的重新检查将在日志中保持静默),并在每个 OP 加入时向他们显示。在聊天中,下载链接是可点击的,直接打开 Modrinth 页面,鼠标悬停时会显示完整 URL;由于控制台无法点击,因此会以纯文本形式打印 URL。该检查异步执行,绝不会阻塞主服务器线程。
注意事项
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.
- ℹ️ Status at a glance —
/ssb info shows the running version, the latest release on Modrinth, and every toggle's current state.
- ⛔ Runtime ban commands —
/ssb ban, /ssb pardon, /ssb ban-ip, /ssb pardon-ip, /ssb ban-uuid, /ssb pardon-uuid edit and reload config.yml for you, no manual file editing needed. UUID bans are entered by player name and resolved automatically, so they survive name changes.
- ? Update checker — checks Modrinth periodically and notifies the console and online OPs when a newer version is available.
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
- Drop the JAR into your server's
plugins/ folder.
- Start the server —
plugins/ServerSeekerBlocker/ will be created automatically.
- Edit
config.yml to add the names, IPs, or UUIDs you want to block.
- 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
update-checker:
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 |
update-checker.enabled |
true |
Check Modrinth for newer releases |
Commands
| Command |
Permission |
Description |
/ssb info |
OP |
Shows the running version, the latest version on Modrinth, and the current settings |
/ssb reload |
OP |
Reloads config.yml and displays a color-coded diff of changes |
/ssb ban <name> |
OP |
Adds a player name to the block list and saves config.yml |
/ssb pardon <name> |
OP |
Removes a player name from the block list |
/ssb ban-ip <ip> |
OP |
Adds an IPv4 address to the block list |
/ssb pardon-ip <ip> |
OP |
Removes an IPv4 address from the block list |
/ssb ban-uuid <name> |
OP |
Looks up the player's UUID and adds it to the block list |
/ssb pardon-uuid <name> |
OP |
Looks up the player's UUID and removes it from the block list |
ban-uuid and pardon-uuid take a player name for convenience but store the UUID, so the entry keeps working even if the player renames. Online and previously seen players resolve instantly; anyone else is looked up through the Mojang API asynchronously, so the server never stalls. On offline-mode servers the UUID is derived from the name locally instead.
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, IP, or UUID is intercepted before it reaches the console or log file.
Some lines the server prints about a rejected connection mention only one of those three — Disconnecting Foo (/1.2.3.4) carries no UUID, for example — so when a connection is blocked the plugin also notes that attempt's name, IP, and UUID for a short while and filters on those too. These observed values expire after 30 seconds, so a name that later belongs to a different player never keeps hiding that player's log lines.
Update checker (update-checker.enabled: true)
Shortly after startup, and every 6 hours after that, the plugin queries the Modrinth API for its own project and compares the newest published version against the running version. If a newer version exists, a warning is printed to console once per server start — the later re-checks stay silent in the log — and shown to each OP when they join. In chat the download link is a clickable link that opens the Modrinth page directly, with the full URL on hover; the console prints the plain URL since it can't be clicked. The check runs asynchronously and never blocks the main server thread.
Notes
评论 0
登录后参与评分
还没有评论,来抢沙发吧