EmptyNet

插件

· 作者 JohnDingleSin

一个独立的插件,通过命令在服务器之间传输玩家。还包含一个简单的登录系统。

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

最新 1.2.0 · 26.2 · Paper / Purpur

一键开服(送7天)

EmptyNet

一个独立的 Paper 1.21.1+ 插件,提供服务器转移功能、内置的登录/注册系统以及双因素认证(2FA)支持。

功能特性

  • 独立运行 - 无需 BungeeCord、Velocity 或其他任何代理
  • 无限服务器 - 在配置文件中添加任意数量的服务器条目
  • 自定义命令 - 每个服务器都拥有其专属命令(例如 /lobby、/survival)
  • 服务器列表 - 使用 /server 列出所有可用服务器
  • 返回原服 - 使用 /serverback 返回到你上次连接的服务器
  • 转移超时 - 可配置的超时时间,若转移连接失败则通知玩家
  • 登录/注册系统 - 玩家必须在游玩前完成注册和登录
  • 2FA 支持 - 可选的 6 位双因素认证代码,提供额外安全保障
  • H2 数据库 - 所有密码均以 BCrypt 哈希形式存储在嵌入式 H2 数据库中
  • 配置开关 - 可独立启用或禁用转移系统和登录系统
  • 自定义消息 - 可配置连接到每个服务器时显示的消息
  • Tab 补全 - 在 /server 命令中自动补全服务器名称

要求

  • Paper 1.21.1 或更高版本
  • Java 21 或更高版本

安装

  1. 从发布页面下载 EmptyNet-1.2.0.jar
  2. 将 jar 文件放入服务器的 plugins/ 文件夹中
  3. 重启你的服务器
  4. 编辑 plugins/EmptyNet/config.yml 以配置你的服务器
  5. 重启服务器或使用 /reload 应用更改

配置

编辑 plugins/EmptyNet/config.yml:

# EmptyNet 配置
# 通过复制并粘贴以下部分,可以添加任意数量的服务器。

# =====================================================
# 转移设置
# =====================================================

# 服务器转移系统的主开关。设置为 false 以禁用所有转移命令。
transfer-enabled: true

# 等待玩家成功连接到目标服务器的时间(秒)。
# 如果玩家在此时间内未连接成功,系统将通知他们
# 连接失败,玩家可以尝试重新连接。设置为 0 以禁用。
timeout: 120

# =====================================================
# 登录系统
# =====================================================

# 登录/注册系统的主开关。设置为 false 以禁用。
login-enabled: true

# 在未登录状态下给予玩家失明效果。
login-blindness: true

# 如果在超时时间内未完成登录/注册,则踢出玩家。设置为 false 以禁用。
login-kick-enabled: true

# 玩家在因未登录/注册被踢出之前拥有的时间(秒)。
login-kick-timeout: 30

servers:
  example:
    # 向玩家显示的显示名称
    name: "Example Server"
    # 命令名称(例如 /example)
    command: "example"
    # 要连接的服务器 IP 和端口
    ip: "127.0.0.1:25566"
    # 连接时向玩家显示的消息
    message: "&aConnecting to Example Server..."

添加更多服务器

只需复制并粘贴服务器条目块,然后修改值即可:

servers:
  lobby:
    name: "Lobby"
    command: "lobby"
    ip: "192.168.1.10:25565"
    message: "&aSending you to the Lobby..."

  survival:
    name: "Survival Server"
    command: "survival"
    ip: "192.168.1.10:25566"
    message: "&aConnecting to Survival..."

  creative:
    name: "Creative Server"
    command: "creative"
    ip: "192.168.1.10:25567"
    message: "&aTeleporting to Creative..."

配置字段说明

字段 描述 示例
transfer-enabled 转移系统的主开关 true
timeout 在判定转移失败前等待的秒数(0 = 禁用) 120
login-enabled 登录/注册系统的主开关 true
login-blindness 给未认证的玩家施加失明效果 true
login-kick-enabled 踢出未能及时登录的玩家 true
login-kick-timeout 未认证玩家被踢出前的秒数 30
name 在 /server 列表中显示的显示名称 "Survival Server"
command 玩家使用的命令(例如 /survival) "survival"
ip 服务器 IP 地址和端口 "192.168.1.10:25566"
message 连接时显示的消息(使用 & 表示颜色代码) "&aConnecting..."

命令

命令 描述 权限
/server 列出所有可用服务器 emptynet.use
/server <name> 连接到特定服务器 emptynet.use
/serverback 返回到你的上一台服务器 emptynet.use
/<command> 每个已配置服务器的直接命令 emptynet.use
/register <password> <confirm> 注册账号 true
/login <password> 登录账号 true
/2fa <code> 登录后输入你的 2FA 验证码 true
/2fa set <code> 设置 6 位 2FA 验证码(需处于登录状态) true
/2fa remove 移除你的 2FA 验证码(需处于登录状态) true

示例

  • /server - 显示所有已配置服务器的列表
  • /server lobby - 连接到 "lobby" 服务器
  • /lobby - 与上述相同(如果配置了 command: "lobby")
  • /serverback - 返回到你之前的服务器
  • /register mypass mypass - 注册新账号
  • /login mypass - 使用密码登录
  • /2fa 123456 - 登录后输入你的 2FA 验证码
  • /2fa set 654321 - 设置 2FA 验证码(需处于登录状态)
  • /2fa remove - 移除你的 2FA 验证码(需处于登录状态)

权限

权限 描述 默认值
emptynet.use 允许使用 /server 和 /serverback 命令 true (所有玩家)
emptynet.admin 保留用于未来的管理员命令 op

工作原理

服务器转移

此插件使用 Paper 内置的 Player#transfer(String host, int port) API 将玩家直接传输至另一台服务器。无需代理或外部依赖——插件内部处理一切。

当玩家使用 /server <name> 或直接命令如 /lobby 时,插件会:

  1. 查找服务器配置
  2. 将目标服务器保存为 /serverback 的“上一服务器”
  3. 启动传输超时监控器(可配置,默认 120 秒)
  4. 向玩家发送配置好的消息
  5. 将玩家传输至目标 IP:端口

如果超时后玩家仍停留在当前服务器,则会收到连接失败的提示,并可尝试重新连接。

登录系统

当玩家加入服务器时,系统会提示其注册或登录:

  1. 新玩家使用 /register <密码> <确认密码> 创建账号
  2. 老玩家使用 /login <密码> 进行身份验证
  3. 如果启用了双重认证(2FA),玩家随后需输入 /2fa <验证码>
  4. 验证通过后,玩家即可正常游戏

在未认证状态下,玩家无法:

  • 移动
  • 破坏或放置方块
  • 与世界互动
  • 丢弃物品
  • 打开物品栏
  • 受到伤害
  • 聊天
  • 使用除 /login、/register 和 /2fa 之外的任何命令

此外,未认证的玩家会获得失明效果(可通过 login-blindness 配置)。如果 login-kick-enabled 为 true,未在 login-kick-timeout 秒内登录/注册的玩家将被踢出服务器。

双因素认证

玩家可以在登录后使用 /2fa set <6位数字代码> 启用双重认证(2FA)。启用后,每次登录时都必须在密码之后输入此代码。使用 /2fa remove 来禁用它。

H2 数据库

所有用户账户均存储在嵌入式 H2 数据库中,路径为 plugins/EmptyNet/emptynet.mv.db。密码以 BCrypt 哈希形式存储(绝非明文)。数据库会在首次运行时自动创建。

赞助商

ChunkHost

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源