无效玩家绕过列表

InvalidPlayerBypassList 允许被添加到可配置绕过列表中的特定玩家,即使 online-mode 设置为 true,也能在不通过 Mojang 身份验证的情况下加入服务器。

管理

目标

InvalidPlayerBypassList 允许特定玩家在服务器处于**在线模式(online mode)**时加入 Minecraft 服务器,而无需经过 Mojang 身份验证。 这对于私人测试、局域网环境或回退场景特别有用,在这些场景中,某些用户名(以及可选的 IP)应被允许绕过身份验证检查。

此模组仅在服务器设置为 online-mode=true 时生效,它会拦截登录尝试,并在玩家名称和 IP 与可配置绕过列表中的条目匹配时允许访问。

工作原理

当玩家尝试加入服务器时,模组会检查其是否存在于绕过列表中。该列表由以下配对定义:

  • 用户名
  • 可选 IP 地址

如果通过配置启用了 IP 强制验证,则玩家必须同时匹配名称和 IP。否则,如果指定为 "none",则仅需匹配名称即可。

命令

你可以直接使用 Minecraft 服务器命令管理绕过列表:

/bypasslist add <player> [ip]

  • 将玩家(可附带 IP)添加到绕过列表。
  • 如果启用了 IP 检查,则必须提供 IP。

/bypasslist remove <player> [ip]

  • 从绕过列表中移除特定玩家。
  • 如果未提供 IP,则将移除该玩家的所有条目。

/bypasslist list

  • 列出绕过列表中当前的所有条目及其关联的 IP。

/bypasslist on

  • 在运行时启用绕过列表。

/bypasslist off

  • 在运行时禁用绕过列表。

所有命令需要权限等级 2 或更高(例如,服务器管理员)。

配置

配置文件位于 invalidplayerbypasslist.properties,包含以下设置:

属性 描述 类型 默认值
ip-required 如果为 true,玩家必须同时匹配用户名和 IP 才能绕过身份验证。 boolean true
enforce-bypasslist 如果为 true,绕过列表将在服务器启动时激活。 boolean true

使用场景

此模组适用于:

  • 白名单开发环境
  • 使用已知用户名/IP 的测试服务器
  • 在 online-mode 下仍需要离线访问回退
  • 为已知玩家提供受控的安全绕过

报告问题

如果你发现 bug 或想要请求新功能:

  1. 前往仓库的 Issues 标签页。
  2. 点击 New Issue。
  3. 使用相应的模板(Bug Report 或 Feature Request)。
  4. 填写所有相关详细信息。
  5. 提交问题。