返回首页
前置需求
- 基础环境:LiteLoaderBDS
核心特性
- 五重关联打击:同时记录玩家的 Name、XUID、UUID、IP 和 设备ID(ClientID)。只要其中一项匹配黑名单,小号立马被封。
- IP归属地查询:自动解析玩家进服IP的地理位置,并在后台记录,方便管理员排查异常登录。
-
全GUI管理:无需记忆繁杂指令,通过
/ikbangui即可调出图形化菜单,轻松封禁/解封/查阅名单。 - 自动解封:支持设置临时封禁时长(秒/分/时/天/年),到期后系统自动执行解封操作。
指令与权限
/ikbangui
打开封禁管理主菜单 (仅管理员)
/ikban
快速封禁玩家 (支持时长与原因)
/ikbanip
封禁指定IP地址 (仅OP)
配置文件说明
配置文件路径:plugins/IKBan/config.json
| 配置项 | 类型 | 说明 |
|---|---|---|
| autoUnbanIntervalMinutes | Integer | 自动检查解封的时间间隔(分钟)。 |
| ipGeolocation.enabled | Boolean | 是否启用进服IP归属地查询功能。 |
| messages.kickMessageFormat | String | 被踢出时的提示信息格式,支持变量替换。 |
IKBan.js (Anti-Evasion)
// 关联数据检测逻辑functionfindBannedRecordByPlayerInfo(info) {for(constxuidinplayerData) {constids = playerData[xuid];// 仅仅换个名字是没用的...if(ids.xuids.includes(info.xuid) || ids.uuids.includes(info.uuid) || ids.ips.includes(info.ip) || ids.client_ids.includes(info.clientId)) {if(blacklist.banned_players[xuid]) {returnblacklist.banned_players[xuid]; } } }returnnull; }