NoEntrance(禁止入内)

插件

· 作者 Liuliqiansui

NoEntrance 是一款适用于 Minecraft Spigot/Paper 服务器的插件,用于管理玩家加入审批与访问控制。当非白名单玩家加入服务器时,该插件会自动拦截他们,执行安全策略,并通知在线管理员进行审批。

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

最新 NoEntrance-26.1-R0.1-1.3 · 26.2 · Bukkit / Paper

一键开服(送7天)

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> kick removes 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 allow only approves online players, preventing offline mis-approval
  • Debug Logging — Optional detailed logs at key execution points (debug toggle) 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 / 安装

  1. Download NoEntrance.jar
  2. Place it in the server's plugins/ directory
  3. Restart the server or run /reload confirm
  4. Edit plugins/NoEntrance/config.yml to adjust settings (restart or /reload confirm required after changes)
  5. (Optional) Edit language files in plugins/NoEntrance/language/ to customize messages
中文
  1. 下载 NoEntrance.jar
  2. 放入服务器 plugins/ 目录
  3. 重启服务器或执行 /reload confirm
  4. 编辑 plugins/NoEntrance/config.yml 调整配置(调整配置后需重启服务器或执行 /reload confirm)
  5. (可选)编辑 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。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源