原创 闭源 AltManager 1.0.3

交流群下载Q：741873025​

插件名称：AltManager

当前版本：1.0.3

适配核心：Bukkit/Paper 服务端

功能定位：MC 服务器同 IP 多开小号检测管控插件，实时维护玩家 IP 在线映射，实现小号查询、一键踢人 / 封禁批量管控，专治多开刷资源、违规养号行为。

核心作用​

监听玩家上下线行为，自动生成实时 IP - 玩家对照表；支持手动查询同 IP 账号、自动拦截多开登录、管理员批量处罚同 IP 在线玩家，兼容第三方封禁插件联动。

适用服务器场景​

• 生存服、RPG 公益服：限制小号多开刷物资、刷副本、刷掉落
• 管理运维场景：快速核查可疑玩家关联账号
• 风控场景：发现违规账号后，一键清理同 IP 所有在线违规账号

一、安装部署教程​

1. 将核心文件 AltManager-1.0.3.jar 上传至服务器 plugins 文件夹
2. 启动服务器，插件自动初始化基础目录与配置文件
3. 自动生成文件路径：
   • 主配置文件：plugins/AltManager/config/config.yml
   • IP 映射数据文件：plugins/AltManager/config/ipmap.yml
4. 关闭服务器，按需修改 config.yml 自定义规则，修改完成后重启服务器生效

二、配置文件详解（config.yml）​

表格

三、全指令手册（游戏内 / 控制台通用）​

基础帮助​

• 指令：/alt help
• 说明：展示插件全部可用指令与用法提示

玩家 IP 关联查询​

1. 按玩家查同 IP 账号
   • 指令：/alt check <玩家名>
   • 示例：/alt check Steve
   • 作用：查看目标玩家当前 IP，以及该 IP 下所有在线关联账号
2. 按 IP 查在线玩家
   • 指令：/alt list <IP地址>
   • 示例：/alt list 127.0.0.1
   • 作用：精准查询指定 IP 下当前全部在线游戏账号

违规批量处罚​

1. 自定义动作批量处罚
   • 指令：/alt punish <玩家名> [kick/ban]
   • 示例：
     
     /alt punish Alex kick（踢出同 IP 所有账号）
     
     /alt punish Alex ban（封禁同 IP 所有账号）
     
     /alt punish Alex（调用配置文件默认处罚动作）
2. 一键全员封禁
   • 指令：/alt banall <玩家名>
   • 示例：/alt banall Steve
   • 作用：直接永久封禁目标玩家所在 IP 的全部在线账号

配置重载​

• 指令：/alt reload
• 说明：不重启服务器，实时重载配置文件 + 刷新 IP 在线映射数据

---

四、权限节点（精细化管控）​

适配权限插件（LuckPerms 等）配置，精准分配管理员权限：

• altmanager.check：允许使用玩家 IP 查询指令
• altmanager.list：允许按 IP 地址检索在线玩家
• altmanager.punish：允许执行批量踢人 / 处罚操作
• altmanager.banall：允许执行一键全员封禁指令
• altmanager.reload：允许管理员重载插件配置
• altmanager.bypass：白名单权限，拥有该权限的账号无视自动小号踢出规则（可用作管理员大号特权）

---

五、数据文件说明（ipmap.yml）​

1. 文件作用：实时动态存储当前在线玩家的 IP 绑定关系，玩家上下线自动更新，无需手动编辑
2. 释义：IP 为127.0.0.1的设备，当前同时在线 Steve、Alex 两个游戏账号
3. 注意：禁止手动篡改该文件，篡改会导致插件 IP 检测逻辑异常

---

六、功能限制与兼容说明​

1. 数据范围：仅记录实时在线玩家 IP，不存储全服历史离线 IP 记录，无回溯溯源历史小号功能
2. IP 识别限制：若服务器使用域名转发、CDN、代理跳板、内网穿透，插件仅能获取转发后的代理 IP，无法识别真实本地 IP
3. 封禁兼容：Ppai 插件联动为反射适配，若服务端版本跨度极大、接口改版，会自动降级为 Bukkit 原生封禁，不影响基础使用
4. 核心定位：轻量化风控插件，专注小号多开拦截，无复杂数据统计、异地登录提醒等拓展功能