Synkai IP Limiter

插件

· 作者 SirRocking

限制可绑定到同一 IP 的账号数量,支持 Webhooks 以及 Velocity 端命令。

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

最新 1.0.0 · 1.21.11 · Velocity

一键开服(送7天)

Advanced Synkai IP 限制器

一个功能强大的 Velocity 代理插件,可防止多个账户使用同一 IP 地址加入你的服务器。包含账户绑定、小号检测以及 Discord Webhook 通知功能。


功能特性

  • ? 基于 IP 的玩家限制 - 限制每个 IP 地址的并发连接数
  • ? 账户绑定 - 将玩家账户与其 IP 地址绑定
  • ? 小号检测 - 自动检测并阻止小号登录
  • ? 基于权限的绕过 - 允许管理员(ops)和 VIP 用户绕过限制
  • ? 自定义消息 - 支持颜色代码(&c, &4 等)
  • ? Discord Webhook 支持 - 实时获取违规通知
  • ⪯ IP 白名单 - 配置受信任的 IP 及其自定义限制
  • ⏰ 绑定过期 - 设置绑定持续时间(永不、1 周、1 个月)
  • ? 调试模式 - 增强的日志记录以辅助故障排除

安装方法

  1. 从构建目录下载最新编译的 JAR 文件
  2. 将其放入 Velocity 代理的 plugins/ 目录中
  3. 重启 Velocity 代理服务器
  4. 配置文件将在 plugins/IPLimit/config.yml 自动生成

配置

编辑 plugins/IPLimit/config.yml 以自定义插件:

# IP 限制配置

# 每个 IP 允许的最大玩家数(这限制了有效账户的并发会话数量)
max-players-per-ip: 1

# 用于绕过检查的权限(管理员通常拥有此权限)
bypass-permission: "iplimit.bypass"

# 因 IP 限制或绑定被踢出时显示的消息(支持如 &c, &4 的颜色代码)
kick-message: "&c你不允许使用该 IP 加入!每个 IP 仅限 1 个账户。"

# 因使用小号被踢出时显示的消息
alt-kick-message: "&c不允许使用小号!该 IP 已绑定到其他账户。"

# 绑定过期策略(never, 1w, 1m)
binding-expiration: "never"

# Discord Webhook 设置(可选)
discord-webhook-enabled: false
discord-webhook-url: "webhookurl here"
discord-webhook-username: "Advanced Synkai IP limiter"
discord-webhook-embed-color: 16711680

# 白名单 IP(这些 IP 将绕过所有检查)
whitelisted-ips:
  - "192.168.1.1"
  - "10.0.0.1"

# 白名单 IP 的可选限制(覆盖正常最大值)
whitelisted-ip-limits:
  "127.0.0.1": 3

# 调试模式(在控制台中打印更多信息)
debug: false

配置选项

选项 类型 描述 默认值
max-players-per-ip Integer 每个 IP 允许的最大玩家数 1
bypass-permission String 绕过检查的权限节点 iplimit.bypass
kick-message String 玩家达到 IP 限制时的踢出消息 可自定义
alt-kick-message String 小号账号的踢出消息 可自定义
binding-expiration String 绑定持续时间:never、1w、1m never
discord-webhook-enabled Boolean 启用 Discord 通知 false
discord-webhook-url String Discord Webhook URL webhookurl here
discord-webhook-username String Webhook 使用的机器人用户名 Advanced Synkai IP limiter
discord-webhook-embed-color Integer 嵌入颜色(RGB 十进制) 16711680
whitelisted-ips List 绕过所有检查的 IP 地址列表 -
whitelisted-ip-limits Map 特定 IP 的自定义限制 -
debug Boolean 启用调试控制台输出 false

权限

权限 描述 默认值
iplimit.bypass 绕过 IP 限制和绑定检查 Ops
iplimit.admin 访问管理命令 Ops

命令

/iplimit [subcommand]

子命令

  • info - 显示玩家 IP 绑定信息
  • reload - 从磁盘重新加载配置
  • unbind <player> - 移除玩家的 IP 绑定
  • whitelist <ip> - 将 IP 加入白名单
  • debug [on|off] - 切换调试模式

Discord Webhook 设置

要获取 IP 违规的实时通知:

  1. 在服务器设置中创建一个 Discord webhook
  2. 复制 webhook URL
  3. 编辑 config.yml:
    discord-webhook-enabled: true
    discord-webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN"
    
  4. 根据需要自定义 webhook 用户名和嵌入颜色
  5. 使用 /iplimit reload 重新加载插件

工作原理

  1. 首次连接 - 玩家带着其 IP 加入,账户与该 IP 绑定
  2. 相同 IP,相同账户 - ✅ 允许(再次登录)
  3. 相同 IP,不同账户 - ❌ 踢出(检测到小号)
  4. 不同 IP,相同账户 - ⚠️ 允许(新 IP,重新绑定)
  5. 白名单 IP - ✅ 始终允许
  6. 绕过权限 - ✅ 管理员和 VIP 可绕过所有检查

功能详解

账户绑定

一旦玩家加入,其账户将与 IP 地址绑定。这可以防止其他账户使用相同的 IP。

绑定过期时间

配置绑定保持活跃的时间:

  • never - 绑定永久有效
  • 1w - 绑定在一周后过期
  • 1m - 绑定在一个月后过期

IP 白名单

将受信任的 IP(代理、测试环境、企业网络)加入白名单以绕过所有检查:

whitelisted-ips:
  - "192.168.1.1"
  - "10.0.0.1"

为白名单中的 IP 设置自定义限制:

whitelisted-ip-limits:
  "127.0.0.1": 5  # 允许来自本机的 5 名玩家

调试模式

启用调试日志以排查问题:

debug: true

查看控制台获取以下方面的详细信息:

  • 玩家连接
  • IP 绑定
  • 权限检查
  • Webhook 请求

故障排除

玩家被意外踢出

  1. 检查玩家的 IP:/iplimit info <player>
  2. 如有需要,验证白名单中的 IP
  3. 检查玩家是否具有 iplimit.bypass 权限
  4. 启用调试模式以获取更多详情

Discord Webhook 无法工作

  1. 验证 Webhook URL 是否正确
  2. 确认已设置 discord-webhook-enabled: true
  3. 确保该 Webhook 未被从 Discord 删除
  4. 在启用调试的情况下,检查控制台的错误消息

配置未更新

  1. 使用 /iplimit reload 重新加载配置
  2. 确保 YAML 格式有效
  3. 检查 config.yml 的文件权限

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源