NoEntrance
NoEntrance 是一个 Minecraft Spigot/Paper 服务端插件,用于管理玩家加入审批与访问控制。当非白名单玩家尝试加入服务器时,插件会自动拦截、执行安全策略,并通知在线管理员审批。支持验证码自助验证、超时自动处理、一键踢出等功能。
⚠️ 请注意: 如果遇到任何错误请及时通过邮箱联系开发者,否则这些问题可能不会被修复。邮件标题请填写为 "NoEntrance 错误报告",否则邮件可能被忽略。联系邮箱:jzt0673375@163.com
功能特性 / Features
- 加入审批 — 非白名单玩家进入时,向管理员发送可点击的
[允许]/[拒绝]聊天消息 - 验证码自助验证 — 管理员创建有时效的验证码(格式
tk-xxxxxxxxxx),玩家通过/token自行验证 - 验证消息白名单 — 可配置仅向指定 OP 发送审批通知,避免骚扰无关管理员
- 一键踢出 —
/noe <玩家名> kick移出白名单 + 拉黑 + 踢出,一步完成 - 超时自动处理 — 管理员未响应时,自动执行封禁 / 加白名单 / 不处理
- 安全措施 — 新玩家强制设置待验证游戏模式并传送至指定坐标,与验证开关独立运作
- 验证后切换游戏模式 — 玩家通过验证(
/noe allow、/token、超时放行)后,自动切换为配置的默认游戏模式 - 在线审批限制 —
/noe allow仅允许审批在线玩家,防止离线误批 - 调试日志 —
debug开关控制关键执行点的详细日志输出,便于排查问题 - 交互式 GUI — 黑白名单、在线玩家列表均支持点击操作
- 控制台支持 — 所有功能均可在控制台通过文本方式使用
- 多语言 — 内置简体中文和英文,可自行扩展
English
- Join Approval — Sends clickable
[Allow]/[Deny]chat messages to admins when non-whitelisted players join - Token Self-Verification — Admins create time-limited tokens (format
tk-xxxxxxxxxx), players self-verify via/token - Notify Whitelist — Optionally restrict approval notifications to a specific list of OPs
- One-Click Kick —
/noe <player> kickremoves from whitelist, bans, and kicks in one step - Auto Timeout Handling — Automatically ban, whitelist, or do nothing when admins don't respond in time
- Security Measures — Force pending game mode and teleport new players to a set location, independent of verification toggle
- Game Mode Switch on Verify — Auto-switch to the configured default game mode when a player is verified (
/noe allow,/token, or timeout-whitelist) - Online-Only Approval —
/noe allowonly approves online players, preventing offline mis-approval - Debug Logging — Optional detailed logs at key execution points (
debugtoggle) for troubleshooting - Interactive GUI — Clickable blacklist, whitelist, and online player lists
- Console Support — All features available via console commands
- Multi-Language — Built-in Simplified Chinese and English, extensible
工作流程 / Workflow
玩家加入审批
未列入白名单的玩家加入 │ ├─ ① 安全措施立即生效 │ ├─ 游戏模式设置为配置的模式(默认:冒险模式 ADVENTURE) │ └─ 传送至配置的位置(可切换,支持世界/坐标/x/y/z/偏航角/俯仰角) │ ├─ ② 通知玩家 │ ├─ “您正在等待管理员验证,请稍候...” │ └─ “如果您拥有令牌,请使用 /token <tk-xxxxxxxxxx> 直接进行验证” │ ├─ ③ 通知管理员 │ ├─ 在线的 OP/管理员收到可点击的聊天消息 [✔允许] [✖拒绝] │ ├─ 如果启用了白名单通知,则仅列出的 OP 会收到这些消息 │ └─ 控制台也会打印批准命令提示 │ ├─ ④ 启动超时计时器(默认:30秒,可配置) │ │ │ ├─ 管理员点击 [✔允许] → 加入白名单,玩家可以正常游戏 │ ├─ 管理员点击 [✖拒绝] → 封禁 + 踢出服务器 │ ├─ 玩家使用 /token → 验证通过,加入白名单(通知管理员) │ │ │ └─ 超时且无操作 │ ├─ timeout-action: BAN → 自动封禁 │ ├─ timeout-action: WHITELIST → 自动加入白名单 │ └─ timeout-action: NONE → 不做任何处理(玩家保留但未加入白名单) │ └─ ⑤ 如果 timeout=0,跳过审批流程,玩家直接进入(安全措施仍然适用)
令牌验证流程
管理员创建令牌 玩家使用令牌
│ │
├─ /noe token tk-xxxxxxxxxx ├─ 加入服务器(未列入白名单)
│ 生成 tk- + 10位字母或数字 │
│ 默认有效期为 30 分钟 ├─ 收到等待验证的消息
│ │
├─ 重复令牌(未过期) ├─ 输入 /token tk-xxxxxxxxxx
│ → 被拒绝并显示“已存在” │
│ ├─ 格式错误 → 显示格式提示
└─ 通过外部渠道发送令牌给玩家 │
├─ 验证通过 → 立即加入白名单
│
└─ 通知管理员:“玩家 XXX 已通过令牌验证”
(控制台 + 在线 OP)
踢出白名单玩家
管理员运行 /noe <player> kick
│
├─ ① 从白名单中移除
├─ ② 添加到黑名单(封禁)
└─ ③ 如果玩家在线,立即将其踢出服务器
English
Player Join Approval
Non-whitelisted players join the server
│
├─ ① Security measures take effect immediately
│ ├─ Game mode is set to a specified mode (default: ADVENTURE, configurable)
│ └─ Teleported to a specified coordinate (can be disabled, world/xyz/orientation configurable)
│
├─ ② Send prompts to the player
│ ├─ "You are waiting for administrator verification, please do not leave..."
│ └─ "If you have a verification code, enter /token <tk-xxxxxxxxxx> to pass verification directly"
│
├─ ③ Notify administrators
│ ├─ Online OPs/administrators receive clickable chat messages [✔Allow] [✖Deny]
│ ├─ If message whitelist is enabled, only OPs on the list receive notifications
│ └─ Console simultaneously outputs approval command prompts
│
├─ ④ Start timeout timer (default: 30 seconds, configurable)
│ │
│ ├─ 管理员点击 [✔允许] → 加入白名单,正常游戏
│ ├─ 管理员点击 [✖拒绝] → 封禁 + 踢出
│ ├─ 玩家输入 /token → 验证通过,加入白名单(通知管理员)
│ │
│ └─ 超时无人处理
│ ├─ timeout-action: BAN → 自动封禁
│ ├─ timeout-action: WHITELIST → 自动加入白名单
│ └─ timeout-action: NONE → 不处理(玩家仍在服务器但未白名单)
│
└─ ⑤ 若 timeout=0,跳过审批,玩家直接进入(安全措施仍生效)
验证码使用流程
管理员创建验证码
│
├─ /noe token tk-xxxxxxxxxx
│ 生成 tk- + 10位字母/数字
│ 有效期默认 30 分钟(可配置)
│
├─ 重复创建未过期验证码
│ → 提示"已存在"拒绝创建
│
└─ 通过外部渠道发给玩家
玩家使用验证码
│
├─ 加入服务器(非白名单)
│
├─ 收到等待验证提示
│
├─ 输入 /token tk-xxxxxxxxxx
│
├─ 若格式错误 → 提示正确格式
│
├─ 验证通过 → 立即加入白名单
│
└─ 通知管理员"玩家 XXX 通过验证码验证"
(控制台 + 在线 OP 均收到)
踢出白名单玩家
管理员执行 /noe <玩家名> kick
│
├─ ① 移出白名单
├─ ② 加入黑名单(封禁)
└─ ③ 若在线,立即踢出服务器
Compatibility / 兼容性
| Component / 项目 | Version Support / 版本 支持 |
|---|---|
| Server / 服务端 | Spigot / Paper / Arclight 1.19 ~ 26.1 |
| Java | 17+ / 21+ / 26+ |
Installation / 安装
- Download
NoEntrance.jar - Place it in the server's
plugins/directory - Restart the server or run
/reload confirm - Edit
plugins/NoEntrance/config.ymlto adjust settings (restart or/reload confirmrequired after changes) - (Optional) Edit language files in
plugins/NoEntrance/language/to customize messages
中文
- 下载
NoEntrance.jar - 放入服务器
plugins/目录 - 重启服务器或执行
/reload confirm - 编辑
plugins/NoEntrance/config.yml调整配置(调整配置后需重启服务器或执行/reload confirm) - (可选)编辑
plugins/NoEntrance/language/下的语言文件自定义文本
Commands / 命令
Admin (requires noentrance.admin permission) / 管理员
| Command / 命令 | Description / 说明 |
|---|---|
/noe <player> allow |
Approve and whitelist the player / 审批通过,加入白名单 |
/noe <player> ban |
Deny and ban the player / 审批拒绝,封禁玩家 |
/noe <player> kick |
Remove from whitelist → ban → kick / 移出白名单 → 拉黑 → 踢出 |
/noe token <tk-xxxxxxxxxx> |
Create a token (tk- + 10 letters/digits) / 创建验证码 |
/noe blacklist |
View blacklist (banned players) / 查看黑名单 |
/noe whitelist |
View whitelist / 查看白名单 |
/noe players |
View online players / 查看在线玩家 |
/noe reload |
Reload configuration and language files / 重载配置和语言文件 |
Player / 玩家
| Command / 命令 | Description / 说明 |
|---|---|
/token <tk-xxxxxxxxxx> |
Use a token to verify / 使用验证码通过验证 |
Permissions / 权限
| Permission / 权限节点 | Description / 说明 | Default / 默认 |
|---|---|---|
noentrance.admin |
Use /noe command and receive approval notifications / 使用 /noe 命令及接收审批通知 |
OP |
Configuration / 配置文件
Configuration file is located at plugins/NoEntrance/config.yml, with the following defaults:
配置文件位于 plugins/NoEntrance/config.yml,默认内容如下:
# ============================================================
# NoEntrance — Minecraft 玩家加入审批与管理插件
# ----------------------------------------------------------
# 项目地址:https://modrinth.com/plugin/noentrance
# 作者: Liuliqiansui
# 联系邮箱: jzt0673375@163.com
# ============================================================
# 语言设置:CN (简体中文) 或 EN (英文)
# Language: CN (Simplified Chinese) or EN (English)
language: CN
# 启动时检查 Modrinth 是否有新版本(建议开启)
# Check for updates on Modrinth at startup. Recommended: true.
check-updates: true
# 调试日志开关:在关键执行点输出详细日志,便于排查问题
# Debug logging: output detailed logs at key execution points for troubleshooting.
debug: false
# 验证等待时间(秒),设为 0 则不启用验证直接放行
# Verification timeout in seconds. Set to 0 to disable verification and allow all.
timeout: 30
# 超时未验证时的操作: BAN (拉黑/ban), WHITELIST (加白名单/whitelist), NONE (不处理/do nothing)
# Action on timeout: BAN, WHITELIST, or NONE
timeout-action: "BAN"
# 验证码有效期(分钟)
# Token expiry time in minutes.
token-expiry: 30
# 封禁时长(分钟),0 = 永久
# Ban duration in minutes. 0 = permanent.
ban-duration: 0
# 验证码速率限制
# Token rate limiting
token-rate-limit:
# 时间窗口内最大尝试次数
# Max attempts within the time window
max-attempts: 5
# 时间窗口(秒)
# Time window in seconds
window-seconds: 10
# 连续失败多少次后封禁,0 = 禁用
# Ban after this many consecutive failures. 0 = disabled.
max-failures: 10
# 通知冷却时间(秒):同一玩家在此时间内不重复通知 OP,0 = 无冷却
# Notification cooldown in seconds. Same player won't trigger repeat OP notifications within this period. 0 = disabled.
notify-cooldown: 0
# 是否在控制台输出加入请求日志
# Whether to log join requests to the console
notify-console: true
# 安全设置
# Security Settings
security:
# 是否将玩家传送到指定坐标
# Teleport player to specified location
teleport-enabled: true
# 传送坐标:世界名, x, y, z, 水平朝向(yaw), 俯仰角(pitch)
# Teleport location: world, x, y, z, yaw, pitch
location:
world: "world"
x: 100.0
y: 64.0
z: 100.0
yaw: 0
pitch: 0
# 待验证玩家(新加入)的游戏模式
# Game mode for pending (newly joined) players.
pending-game-mode: "ADVENTURE"
# 验证通过后的游戏模式(/noe allow、/token、超时放行时切换)
# Game mode applied after verification.
default-game-mode: "SURVIVAL"
# 是否向在线 OP/管理员 发送可点击的验证消息
# Send clickable verification messages to online OPs/admins.
notify-ops: true
# 验证消息白名单:开启后仅向列表中的玩家发送验证消息(不在列表中的 OP 不会收到)
# 列表区分大小写,玩家必须同时是 OP 或拥有 noentrance.admin 权限
# 关闭后恢复默认行为:向所有在线 OP/管理员 发送
# ---
# Notify whitelist: if enabled, only listed players receive verification messages.
# Names are case-sensitive. Players must also be OP or have noentrance.admin permission.
# Disable to restore default: all online OPs/admins receive messages.
notify-whitelist:
enabled: true
players:
- "Notch"
- "Player1"
如需自定义消息,请编辑 plugins/NoEntrance/language/ 目录下的 lang-cn.yml 或 lang-en.yml。支持使用 & 颜色代码。修改后重启服务器即可生效。若要添加新语言,请新建 lang-xx.yml 文件,并在 config.yml 中设置 language: XX。
中文
如需修改语言文本,编辑 plugins/NoEntrance/language/ 下的 lang-cn.yml 或 lang-en.yml。支持 & 颜色代码,修改后重启生效。添加新语言:新建 lang-xx.yml,在 config.yml 中设置 language: XX。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧