无效玩家绕过列表
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 或想要请求新功能:
- 前往仓库的 Issues 标签页。
- 点击 New Issue。
- 使用相应的模板(Bug Report 或 Feature Request)。
- 填写所有相关详细信息。
- 提交问题。
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。