Sentinel

插件

· 作者 confect1on

基于 MySQL 实现的 Velocity 插件,作为一个大规模 Discord 链接系统运行。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.5 · Velocity

一键开服(送7天)

Sentinel

⚠️ 已在 Minecraft 1.20.1 上测试: 尽管 Sentinel 使用 Velocity 的登录 API,并不依赖于特定的 Minecraft 服务器软件或版本。它应该可以在你的 Velocity 代理支持的任何后端(包括 Paper、Spigot、Forge 和 Fabric 服务器)上正常工作。

Sentinel 是一个 Velocity 插件,用于安全地将 Minecraft 账号与 Discord 账号关联。它与一个 Discord 机器人集成,在允许玩家登录前进行验证,有助于防止冒充行为并协助玩家之间的连接。Sentinel 还提供隔离功能,以暂时限制问题玩家的访问权限。

命令

Discord 命令

/link <code>
将你的 Minecraft 账号链接到你的 Discord 账号。

/whois [discord: @user | minecraft: username]
查询已关联账号的信息。

/quarantine <user>
切换用户的隔离角色(Minecraft 用户名或 Discord @提及)。
需要员工角色权限。当用户被隔离时会自动踢出在线玩家。

特性

  • 账号关联:将 Minecraft 账号链接到 Discord 的安全验证系统
  • 登录保护:阻止未关联账号的玩家加入(可配置绕过服务器)
  • 角色管理:为已关联玩家自动分配 Discord 角色
  • 隔离系统:员工可以隔离问题玩家,阻止其登录并踢出在线玩家
  • 自动清理:移除离开 Discord 的用户数据库条目
  • 速率限制:通过智能速率限制尊重 Discord API 的限制

要求

  • Java 17+
  • Velocity 代理(已在 3.4.0-SNAPSHOT 上测试)
  • MySQL 或 MariaDB

设置

  1. 安装插件
    将阴影 JAR 文件放入 Velocity 代理的 plugins/ 文件夹中。

  2. 配置 MySQL 和 Discord
    首次运行时,将创建 plugins/sentinel/config.json。填写你的数据库凭据、Discord 令牌,并可选择配置隔离和员工角色:

    {
      "mysql": {
        "host": "localhost",
        "port": 3306,
        "database": "sentinel",
        "username": "sentinel_user",
        "password": "password"
      },
      "discord": {
        "token": "your_discord_bot_token",
        "linkedRole": "123456789012345678",
        "quarantineRole": "987654321098765432",
        "quarantineMessage": "Your account has been quarantined. Contact an administrator.",
        "staffRoles": ["111111111111111111", "222222222222222222"]
      },
      "bypassServers": {
        "servers": ["lobby", "auth"]
      }
    }
    

配置选项

  • bypassServers:绕过 Discord 验证要求的服务器名称。对于应允许未验证玩家加入的大厅或认证服务器非常有用。

  • linkedRole:(可选)自动分配给所有已关联玩家的 Discord 角色 ID。当配置时:

    • 所有现有的已关联账号在机器人启动时获得该角色(受速率限制)
    • 新关联的账号立即获得该角色
    • 角色同步在大数据库中大约需要 20 分钟完成
  • quarantineRole:(可选)被隔离玩家的 Discord 角色 ID。当配置时:

    • 拥有此角色的玩家将无法登录
    • 员工可以使用 /quarantine 命令切换此角色
    • 在线玩家在隔离时会被立即踢出
  • quarantineMessage:被隔离玩家尝试加入或被踢出时显示的消息

  • staffRoles:可使用 /quarantine 命令的 Discord 角色 ID 数组

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源