- 版权类型
- 原创
- 插件中文名称
- IP限制
- 插件英文名称
- IP Limit
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- PufferFish
- 语言支持
- 多语言
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
[MD]
# IP Limit —— 限制相同IP在线玩家数量



## ✨ 功能特性
- **IP同玩家数限制**: 自动检测并阻止超过设定数量的 IP 连接
- **IP白名单**: 支持配置忽略的特殊 IP 地址(默认忽略127.0.0.1)
- **阈值提醒**: 当同IP X位玩家时进行提示
- **权限绕过**: 允许拥有iplimit.bypass权限的玩家不受限制
- **富文本支持**: 支持 MiniMessage 富文本格式(渐变、点击事件、悬停提示等)
- **Velocity支持**: 可无缝切换配置文件(Bukkit/Velocity),如需限制全服IP限制,请使用Velocity版本,如仅需限制单个服务器,请使用Bukkit版本(两者无冲突)
如需使用轻量版本,可使用[Skript脚本版](https://www.minebbs.com/resources/skript-ip-limit-ip.12459/)

## ⚙️ 配置指南
默认配置 (`config.yml`):
```yaml
# 同一IP允许的最大连接数
# Maximum connections allowed per IP
max-connections: 2
# 触发警告的连接数阈值
# Threshold for sending alerts
warn-threshold: 1
# 忽略检查的IP列表
# Trusted IPs excluded from rules
ignored-ips:
- "127.0.0.1" # 本机地址 | Localhost
- "192.168.1.100" # 内网设备 | Internal network device
# 语言设置 (en/zh)
# Interface language (en/zh)
language: zh
```
语言文件示例 (`messages/messages_zh.yml`):
```yaml
prefix: "<dark_gray>[<gold>IP限制</gold>]"
kick-message: "<prefix> <yellow>你不能同时登录多个游戏账号,如有疑问请联系管理员"
warning-message: "<prefix> <red>您正在使用小号进入服务器,服务器仅允许同时使用 <yellow><bold><max>个</bold></yellow> 账号登录"
no-permission: "<prefix> <red>没有权限执行此操作!"
reload-success: "<prefix> <green>配置重载成功!"
```
## 🛠️ 使用说明
**权限节点**:
- `iplimit.bypass` - 绕过连接限制
- `iplimit.reload` - 重载插件权限
**命令**:
- `/iplimitreload` - 重载插件配置
## 🌍 多语言支持
英语(默认) 中文
## ❓ 常见问题
Q: 如何让某个玩家的 IP 不受限制?
A: 将 IP 加入 `ignored-ips` 列表或在用户组添加 `iplimit.bypass` 权限(OP默认不限制)
Q/A:插件使用了Adventure API,如Lib内容无法下载,请更换网络环境
> Tips:关于[MiniMessage的使用,可参考本帖](https://www.minebbs.com/resources/simpleannouncement-velocity-minimessage-x.12463/)
[/MD]