原创 开源 前置/API 工具 ip4player-一个显示玩家归属地ip的前置 1.0

[MD]# ip4player 一款适用于 Paper 服务端的轻量级插件，可在玩家加入时自动记录其 IP 地址，并通过 [ip2region](https://github.com/lionsoul2014/ip2region) 数据库解析归属地（国家、省份、城市、运营商）。 --- ## 功能介绍 - **自动下载数据库**：首次启动时自动从远程拉取 ip2region XDB 数据库（约 10 MB），无需手动配置。 - **归属地解析**：玩家加入时实时查询 IP 归属地，支持解析国家、省份、城市及运营商信息。 - **加入广播**：可向拥有权限的管理员广播玩家加入时的归属地信息，格式可在配置文件中自定义。 - **指令查询**：通过 `/ip` 指令查询在线玩家的 IP 及归属地。 - **PlaceholderAPI 支持**：提供多个变量，可在记分板、Tab 列表等位置展示玩家归属地。 - **Folia 兼容**：支持 Folia 服务端。 --- ## 环境要求 - Paper 26.1.2 或更高版本 - Java 25+ - PlaceholderAPI（可选，软依赖） --- ## 安装方法 1. 将插件 jar 放入服务端 `plugins/` 目录。 2. 启动服务器，插件将自动下载 ip2region 数据库。 3. 根据需要修改 `plugins/ip4player/config.yml`。 --- ## 指令 | 指令 | 说明 | 权限节点 | |---|---|---| | `/ip` | 查看自己的 IP 及归属地 | `ip4player.ip.self` | | `/ip <玩家名>` | 查看其他玩家的 IP 及归属地 | `ip4player.ip.others` | | `/ip reload` | 重载配置文件 | `ip4player.reload` | --- ## 权限节点 | 权限节点 | 默认 | 说明 | |---|---|---| | `ip4player.ip.self` | 所有人 | 查看自己的 IP 及归属地 | | `ip4player.ip.others` | OP | 查看其他玩家的 IP 及归属地 | | `ip4player.see-joins` | OP | 接收玩家加入时的归属地广播 | | `ip4player.reload` | OP | 重载插件配置 | --- ## 配置文件 ```yaml # 是否向拥有 ip4player.see-joins 权限的玩家广播加入信息 announce-join: true announce-format: "&8[&bip4player&8] &f{player} &7加入自 &f{region}" # 是否在控制台记录玩家加入日志 log-joins: true ``` 消息格式支持以下占位符：`{player}`（玩家名）、`{ip}`（IP 地址）、`{region}`（完整归属地）。 --- ## PlaceholderAPI 变量 | 变量 | 示例值 | 说明 | |---|---|---| | `%ip4player_ip%` | `1.2.3.4` | 玩家 IP 地址 | | `%ip4player_country%` | `中国` | 国家 | | `%ip4player_province%` | `广东省` | 省份（若有） | | `%ip4player_city%` | `深圳市` | 城市（若有） | | `%ip4player_isp%` | `电信` | 运营商 | | `%ip4player_region%` | `中国 广东省 深圳市 电信` | 完整归属地字符串 | --- ## 构建 ```bash ./gradlew shadowJar ``` 构建产物位于 `build/libs/` 目录。 --- ## 作者 Chen [/MD]