NamelessIPLogger 是一款用于审核和安全审计的 Velocity 和 Paper 插件。它构建玩家 UUID、用户名和 IP 地址 之间的历史关联,记录连接活动,并使用 本地 GeoIP MMDB 数据 丰富 IP 记录。玩家查询在本地进行;不会为每个玩家发起外部 API 请求。
请注意,本插件根据 PolyForm Noncommercial License 1.0.0 许可证授权,因此不能用于参与/允许/促进以下任何涉及现实货币行为的服务器/代理:
- 出售排名(ranks),
- 接受与特权挂钩的捐赠,
- 出售外观装饰(cosmetics),
- 运行广告/赞助,
- 出售任何形式的付费访问权限,
- 以及/或产生任何其他形式的收入
(请参阅 GitHub README 以获取最新信息;此描述可能略有滞后)
功能介绍
- 建立长期的 UUID、用户名和 IP 关联记录。
- 记录带有时间戳、会话 ID 和会话时长的连接与断开连接事件。
- 当启用 GeoIP 日志记录时,使用国家、地区、城市、时区、ISP、ASN、经纬度和查询状态来丰富 IP 记录。
- 将数据存储为
plugins/namelessiplogger/下的纯文本 TSV 文件,以便审查、导出和外部分析。 - 支持可配置的日志控制选项,包括用户名、IP、GeoIP 丰富化、TSV 输出、控制台日志、命令访问权限和数据保留清理。
- 在内存中缓存 GeoIP 查询结果,以提高重复查询的速度。
适用场景
如果您正在调查封禁规避、小号、账号共享或可疑活动,此插件可为您的运营审核工作流提供快速的历史身份/IP 证据。
GeoIP 提供商
通过 config.yml 支持两种提供商:
- DB-IP(默认):无需注册账户,使用 DB-IP City Lite 和 ASN Lite MMDB 下载。
- MaxMind GeoLite2:需要 MaxMind 账户/许可密钥,使用 GeoLite2 City 和 ASN 下载。
数据库会在需要时下载,并在配置的过期间隔后刷新,也可以通过 /niplookup updatedb 强制立即重新下载。
命令
命令默认仅限控制台使用。设置 commands.allow-admin-permission: "true" 也允许拥有 namelessiplogger.admin 权限的玩家使用这些命令。
| 命令 | 描述 |
|---|---|
/niplookup uuid <uuid> |
查询特定 UUID 的所有数据 |
/niplookup username <name> |
查询特定用户名的所有数据 |
/niplookup ip <ip> |
查询特定 IP 的所有数据 |
/niplookup reload |
不重启平台的情况下重新加载配置 |
/niplookup updatedb |
强制立即重新下载 GeoIP 数据库 |
/niplookup checkupdates |
手动检查 GitHub Releases 是否有更新的稳定版本 |
别名:/niplog, /iplookup, /iplog
还支持其他子命令别名:user, name, update-db, refreshdb, checkupdate, updatecheck, update-check, 和 updates。
隐私和网络披露
此插件可以存储 UUID、用户名、IP、连接时间戳、会话时长以及可选的 GeoIP 丰富化数据。日志字段、TSV 输出、控制台输出、保留策略和玩家命令访问权限均可配置。
出站网络活动仅限于:
- 按需进行的 GeoIP 数据库下载。
- 可选的针对 GitHub Releases 的定期稳定版更新检查(默认启用)。
- 运行
/niplookup checkupdates时的手动更新检查。 - 可选的匿名遥测心跳包发送至 NamelessTelemetry(默认启用)。
遥测数据不发送玩家 UUID、用户名、玩家 IP、连接日志或 GeoIP 数据。它仅发送哈希后的本地实例 ID、UTC 日期、项目名称和计数。设置 telemetry.enabled: "false" 可禁用该功能。
请将存储的身份/IP 数据视为敏感信息,并根据您所在司法管辖区和服务器的政策设置适当的保留策略。
每晚自动构建
每晚的开发构建会自动从最新的 main 或 master 分支更改中发布,也可以手动触发。
每晚构建旨在用于测试,其变化频率可能高于具有版本号的稳定发行版。内置的更新检查会忽略预发布版本和 nightly 标签。
NamelessIPLogger is a Velocity and Paper plugin for moderation and security auditing. It builds historical correlations between player UUIDs, usernames, and IP addresses, logs connection activity, and enriches IP records with local GeoIP MMDB data. Player lookups are local; no per-player external API requests are made.
Please be aware, this plugin is licensed under the PolyForm Noncommercial License 1.0.0 and as such cannot be used by servers/proxies that participate in/allow/facilitate any of the following to occur with real-world money:
- the sale of ranks,
- the acceptance of donations tied to perks,
- the sale of cosmetics,
- the running of ads/sponsorships,
- the sale of any form of monetized access,
- and/or the generation of any other form of revenue
(Please see the GitHub README for the latest info; this description may lag behind slightly)
What it does
- Builds long-term UUID, username, and IP correlation records.
- Logs connection and disconnection events with timestamps, session IDs, and session duration.
- Enriches IP records with country, region, city, timezone, ISP, ASN, latitude, longitude, and lookup status when GeoIP logging is enabled.
- Stores data in plain TSV files under
plugins/namelessiplogger/for review, export, and external analysis. - Supports configurable logging controls for usernames, IPs, GeoIP enrichment, TSV outputs, console logs, command access, and retention pruning.
- Caches GeoIP lookups in memory for faster repeated lookups.
Why you would want it
If you investigate ban evasion, alt accounts, account sharing, or suspicious activity, this plugin gives you fast historical identity/IP evidence for operational moderation workflows.
GeoIP providers
Two providers are supported through config.yml:
- DB-IP (default): no account required, uses DB-IP City Lite and ASN Lite MMDB downloads.
- MaxMind GeoLite2: requires a MaxMind account/license key, uses GeoLite2 City and ASN downloads.
Databases are downloaded when needed, refreshed after the configured staleness interval, and can be forced immediately with /niplookup updatedb.
Commands
Commands are console-only by default. Set commands.allow-admin-permission: "true" to also allow players with namelessiplogger.admin to use them.
| Command | Description |
|---|---|
/niplookup uuid <uuid> |
Look up all data for a UUID |
/niplookup username <name> |
Look up all data for a username |
/niplookup ip <ip> |
Look up all data for an IP |
/niplookup reload |
Reload config without restarting the platform |
/niplookup updatedb |
Force immediate GeoIP database redownload |
/niplookup checkupdates |
Manually check GitHub Releases for a newer stable version |
Aliases: /niplog, /iplookup, /iplog
Additional subcommand aliases are also accepted: user, name, update-db, refreshdb, checkupdate, updatecheck, update-check, and updates.
Privacy and network disclosure
This plugin can store UUIDs, usernames, IPs, connection timestamps, session durations, and optional GeoIP enrichment. Logging fields, TSV outputs, console output, retention, and player command access are configurable.
Outbound network activity is limited to:
- GeoIP database downloads when needed.
- Optional scheduled stable-release update checks against GitHub Releases, enabled by default.
- Manual update checks when
/niplookup checkupdatesis run. - Optional anonymous telemetry pings to NamelessTelemetry, enabled by default.
Telemetry does not send player UUIDs, usernames, player IPs, connection logs, or GeoIP data. It sends only a hashed local instance ID, UTC date, project name, and count. Set telemetry.enabled: "false" to disable it.
Treat stored identity/IP data as sensitive and set retention policies appropriate for your jurisdiction and server policy.
Nightly auto-builds
Nightly development builds are published automatically from the latest main or master branch changes, and can also be triggered manually.
Nightly builds are intended for testing and may change more frequently than stable versioned releases. Built-in update checks ignore prereleases and the nightly tag.
下载 NamelessIPLogger
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NamelessIPLogger
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NamelessIPLogger
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NamelessIPLogger
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NamelessIPLogger
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NamelessIPLogger
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
重构代码格式,提升多个类的可读性;将插件版本更新为 0.0.6,API 版本更新为 1.20;为 MockBukkit 设置添加单元测试。
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧