IPViewer

插件

· 作者 MouseJava

用于管理 IP 地址的插件

0 本站下载 0 关注 更新于 2 周前

最新 1.1.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

Logo

Bukkit Spigot Paper Folia Purpur

? 概述

IPViewer 是一个插件,提供了一种查看玩家 IP 地址的简单方法,有助于服务器管理以及检测封禁规避或多开行为。

注意: 此处描述的所有技术设置和功能均针对该插件的最新版本,可能无法与旧版本完全兼容。

? 功能

  • 查看自安装插件以来加入服务器的所有玩家,包括其 IP 地址和最后在线时间
  • 轻松筛选和搜索玩家 IP
  • 检测多个账号共享同一 IP 的情况
  • 帮助追踪封禁规避和可疑活动

? 命令

以下是该插件中可用的所有命令:

  • /ipv help - 此命令允许你显示所有可能的插件命令
  • /ipv reload - 此命令允许你重载插件配置
  • /ipv script generate - 恢复内置的默认脚本,覆盖 plugins/IPViewer/scripts/default.js。这不会更改已选定的脚本
  • /ipv script set <file> - 选择一个现有的脚本,例如 /ipv script set custom.js,并将其文件名保存到 script_geo_location 中。文件名必须以 .js 结尾;不接受路径
  • /ipv list [filters] - 此命令允许你浏览玩家列表,并可选择应用过滤器

? /ipv list 的过滤器

/ipv list 命令支持灵活的过滤器,帮助你搜索和组织玩家 IP 数据。所有过滤器都可以在单个命令中组合使用。

过滤器 描述
page:<number> 或仅 <number> 显示特定结果页(例如,/ipv list 2 或 /ipv list page:2)
player:<text> 按玩家名称过滤结果(支持部分匹配和通配符)
ip:<text> 按 IP 地址过滤(支持部分匹配和通配符)
country:<text> 按国家名称或代码过滤(例如,country:"United States")
state:<text> 按地区或州过滤(用于更细粒度的 IP 地理位置信息,例如,state:"New York")
time:<duration> 仅显示在指定时间范围内出现的玩家(例如,time:24h, time:30m)

? 通配符

使用文本的过滤器(player、ip、country、state)支持 SQL 风格的通配符:

  • % - 匹配任意字符序列
  • _ - 匹配单个字符

你也可以在过滤器值中使用空格:

  • 将空格替换为 + - country:United+States
  • 用引号包裹值 - state:"New York"

当使用引号时,+ 字符将按原样保留。

? 示例

/ipv list player:stev% ip:192.168.% time:7d page:3

此命令显示名字以 stev 开头、IP 以 192.168. 开头且在最近 7 天 内出现过的玩家的第 3 页结果。

? 配置

配置文件会在首次启动时生成,你可以修改它以调整输出格式或其他插件设置。查看默认配置文件在此处。

配置文件中的所有消息均使用 MiniMessage 格式,支持丰富的文本格式化(颜色、渐变、粗体等)。你可以使用 MiniMessage Viewer 预览和创建格式化消息。

script_geo_location 用于选择用于解析玩家地理位置的 JavaScript 文件:

script_geo_location: 'default.js'

文件名将在 plugins/IPViewer/scripts/ 目录内解析。请使用诸如 custom.js 这样的名称,以拉丁字母、数字、下划线或连字符开头;其余字符也可包含点号。不接受目录路径和其他扩展名。执行 /ipv script set custom.js 会立即保存选择。如果你手动编辑配置文件,请使用 /ipv reload 来应用更改。

? 自定义地理位置脚本

脚本系统允许管理员选择如何获取玩家地理位置:使用其他提供商、通过请求头提供 API 密钥,或在无需重建插件的情况下转换提供商的响应。

在启动时,IPViewer 会检查 plugins/IPViewer/scripts/default.js 是否存在,如果缺失则复制内置的默认脚本。现有文件保持不变,包括空文件。执行 /ipv script generate 会将此默认文件显式替换为内置版本;它不会重置 script_geo_location。

每次玩家加入时,插件会读取所选脚本,并在异步调度器上通过 GraalJS 运行 getGeoLocation(ip)。对脚本的更改将在下次玩家加入时生效,无需重载。该函数必须同步返回一个包含字符串字段 country 和 state 的对象;接受包含这些字段的 JSON 字符串。IPViewer 使用 Gson 解析结果,并据此创建或更新玩家的档案。若出现脚本、HTTP 或结果格式错误,则会记录日志,且此次查询不会更新档案。

返回的 JSON 必须具备以下结构(两个字段均为必填项,且必须为字符串类型):

{
  "country": "United States",
  "state": "California"
}

返回等效的 JavaScript 对象,或使用 JSON.stringify({country: "United States", state: "California"}) 返回 JSON 字符串。

嵌入式 GraalJS 提供了诸如 JSON.parse 和 JSON.stringify 等 JavaScript 语言特性,但不包含浏览器或 Node.js 的网络 API。IPViewer 提供了 httpGet(url, headers?),因此脚本无需使用 Java 类:

function getGeoLocation(ip) {
  const url = `https://ipwho.is/${encodeURIComponent(ip)}?fields=success,message,country,region`
  const data = JSON.parse(httpGet(url, {Accept: "application/json"}))

  if (data.success !== true)
    throw new Error("GeoIP service error: " + (data.message || "Unknown error"))

  if (typeof data.country !== "string" || typeof data.region !== "string")
    throw new Error("GeoIP service returned invalid country or region")

  return {
    country: data.country,
    state: data.region
  }
}

httpGet 执行同步 HTTP/HTTPS GET 请求,并将响应体作为 UTF-8 文本返回。可选的对象参数用于提供字符串类型的请求头,例如 {Authorization: "Bearer YOUR_API_KEY"}。连接和请求超时时间为五秒;网络故障和非 2xx 响应将抛出错误。请使用普通函数;不支持 async 函数和 Promise 结果。禁止直接访问 Java 类。

要添加提供商,请创建类似 plugins/IPViewer/scripts/custom.js 的文件,实现针对该提供商的响应映射 getGeoLocation(ip),并通过 /ipv script set custom.js 进行选择。Tab 补全功能会列出可用的 .js 文件。默认提供商使用 HTTPS;有关其当前免费层限制,请参阅 提供商文档。

⚙️ 开发者或管理员设置

插件拥有以下权限:

权限 含义 默认访问
ipviewer.update_listener 接收更新 notifications 的权限 op
ipviewer.use 使用命令的权限 op
ipviewer.help 使用命令 help 的权限 op
ipviewer.reload 使用命令 reload 的权限 op
ipviewer.script 使用命令 script 的权限 op
ipviewer.list 使用命令 list 的权限 op

❗ 问题报告

如果您发现任何错误,请在此处 提交消息 或在 Discord 上留言。

? 社交媒体

? 指标

Metrics

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源