ServerSeekerBlocker

插件

· 作者 russy1037

通过 UUID 屏蔽 Block ServerSeeker 扫描机器人和其他不需要的玩家,在游戏中检查插件状态,并获取更清晰的更新通知和日志抑制。

0 本站下载 0 关注 更新于 2 个月前

最新 1.3.0 · 26.3 · Paper / Purpur

一键开服(送7天)

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 或更高

安装

  1. 将 JAR 文件放入服务端的 plugins/ 文件夹中。
  2. 启动服务器 — plugins/ServerSeekerBlocker/ 目录会自动创建。
  3. 编辑 config.yml 以添加你想要阻止的名称、IP 或 UUID。
  4. 运行 /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 即可即时切换语言。

捆绑语言

  • en_US — 英语
  • ko_KR — 韩语

要添加新语言,请使用与现有文件相同的键值创建一个 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。该检查异步执行,绝不会阻塞主服务器线程。


注意事项

  • 仅限 Paper / Purpur。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源