Advanced Synkai IP 限制器
一个功能强大的 Velocity 代理插件,可防止多个账户使用同一 IP 地址加入你的服务器。包含账户绑定、小号检测以及 Discord Webhook 通知功能。
功能特性
- ? 基于 IP 的玩家限制 - 限制每个 IP 地址的并发连接数
- ? 账户绑定 - 将玩家账户与其 IP 地址绑定
- ? 小号检测 - 自动检测并阻止小号登录
- ? 基于权限的绕过 - 允许管理员(ops)和 VIP 用户绕过限制
- ? 自定义消息 - 支持颜色代码(&c, &4 等)
- ? Discord Webhook 支持 - 实时获取违规通知
- ⪯ IP 白名单 - 配置受信任的 IP 及其自定义限制
- ⏰ 绑定过期 - 设置绑定持续时间(永不、1 周、1 个月)
- ? 调试模式 - 增强的日志记录以辅助故障排除
安装方法
- 从构建目录下载最新编译的 JAR 文件
- 将其放入 Velocity 代理的
plugins/目录中 - 重启 Velocity 代理服务器
- 配置文件将在
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 违规的实时通知:
- 在服务器设置中创建一个 Discord webhook
- 复制 webhook URL
- 编辑
config.yml:discord-webhook-enabled: true discord-webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN" - 根据需要自定义 webhook 用户名和嵌入颜色
- 使用
/iplimit reload重新加载插件
工作原理
- 首次连接 - 玩家带着其 IP 加入,账户与该 IP 绑定
- 相同 IP,相同账户 - ✅ 允许(再次登录)
- 相同 IP,不同账户 - ❌ 踢出(检测到小号)
- 不同 IP,相同账户 - ⚠️ 允许(新 IP,重新绑定)
- 白名单 IP - ✅ 始终允许
- 绕过权限 - ✅ 管理员和 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 请求
故障排除
玩家被意外踢出
- 检查玩家的 IP:
/iplimit info <player> - 如有需要,验证白名单中的 IP
- 检查玩家是否具有
iplimit.bypass权限 - 启用调试模式以获取更多详情
Discord Webhook 无法工作
- 验证 Webhook URL 是否正确
- 确认已设置
discord-webhook-enabled: true - 确保该 Webhook 未被从 Discord 删除
- 在启用调试的情况下,检查控制台的错误消息
配置未更新
- 使用
/iplimit reload重新加载配置 - 确保 YAML 格式有效
- 检查
config.yml的文件权限
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧