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.<\/p>\n
—<\/p>\n
#### 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:
\n– **the sale of ranks,**
\n– **the acceptance of donations tied to perks,**
\n– **the sale of cosmetics,**
\n– **the running of ads\/sponsorships,**
\n– **the sale of any form of monetized access,**
\n– **and\/or the generation of any other form of revenue**<\/p>\n
—<\/p>\n
(Please see the GitHub README for the latest info; this description may lag behind slightly)<\/p>\n
## What it does<\/p>\n
– Builds long-term UUID, username, and IP correlation records.
\n– Logs connection and disconnection events with timestamps, session IDs, and session duration.
\n– Enriches IP records with country, region, city, timezone, ISP, ASN, latitude, longitude, and lookup status when GeoIP logging is enabled.
\n– Stores data in plain TSV files under `plugins\/namelessiplogger\/` for review, export, and external analysis.
\n– Supports configurable logging controls for usernames, IPs, GeoIP enrichment, TSV outputs, console logs, command access, and retention pruning.
\n– Caches GeoIP lookups in memory for faster repeated lookups.<\/p>\n
## Why you would want it<\/p>\n
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.<\/p>\n
## GeoIP providers<\/p>\n
Two providers are supported through `config.yml`:<\/p>\n
– **DB-IP** (default): no account required, uses DB-IP City Lite and ASN Lite MMDB downloads.
\n– **MaxMind GeoLite2**: requires a MaxMind account\/license key, uses GeoLite2 City and ASN downloads.<\/p>\n
Databases are downloaded when needed, refreshed after the configured staleness interval, and can be forced immediately with `\/niplookup updatedb`.<\/p>\n
## Commands<\/p>\n
Commands are console-only by default. Set `commands.allow-admin-permission: “true”` to also allow players with `namelessiplogger.admin` to use them.<\/p>\n
| Command | Description | Aliases: `\/niplog`, `\/iplookup`, `\/iplog`<\/p>\n Additional subcommand aliases are also accepted: `user`, `name`, `update-db`, `refreshdb`, `checkupdate`, `updatecheck`, `update-check`, and `updates`.<\/p>\n ## Privacy and network disclosure<\/p>\n 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.<\/p>\n Outbound network activity is limited to:<\/p>\n – GeoIP database downloads when needed. 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.<\/p>\n Treat stored identity\/IP data as sensitive and set retention policies appropriate for your jurisdiction and server policy.<\/p>\n ## Nightly auto-builds<\/p>\n Nightly development builds are published automatically from the latest `main` or `master` branch changes, and can also be triggered manually.<\/p>\n https:\/\/github.com\/NanashiTheNameless\/NamelessIPLogger\/releases\/tag\/nightly<\/p>\n 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.<\/p>\n","protected":false},"excerpt":{"rendered":" Velocity\/Paper plugin that correlates player UUIDs, usernames, and IPs over time. Logs connection events with session durations and enriches records with local GeoIP data for moderation, security auditing, and ban-evasion investigation.<\/p>\n","protected":false},"featured_media":108618,"template":"","meta":{"_minecraft_slug":"namelessiplogger","_minecraft_project_id":"39ZhGuIU","_minecraft_author":"NamelessNanashi","_minecraft_license":"PolyForm-Noncommercial-1.0.0","_minecraft_downloads":14,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"namelessiplogger.zip","_minecraft_size_bytes":27540296,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T22:51:23.127125Z","_minecraft_date_created":"2026-05-10T00:53:04.612728Z","_minecraft_date_modified":"2026-05-10T22:33:03.569982Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/namelessiplogger","_minecraft_icon_attachment_id":108618,"_minecraft_imported_at":"2026-06-06T06:46:48+00:00","_minecraft_import_hash":"a54990a632dd55c0472d04c6ae419a0e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,92,985],"mod_loader":[132,986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-108617","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-utility","mod_category-velocity","mod_loader-paper","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| `\/niplookup uuid
\n| `\/niplookup username
\n| `\/niplookup ip
\n| `\/niplookup reload` | Reload config without restarting the platform |
\n| `\/niplookup updatedb` | Force immediate GeoIP database redownload |
\n| `\/niplookup checkupdates` | Manually check GitHub Releases for a newer stable version |<\/p>\n
\n– Optional scheduled stable-release update checks against GitHub Releases, enabled by default.
\n– Manual update checks when `\/niplookup checkupdates` is run.
\n– Optional anonymous telemetry pings to NamelessTelemetry, enabled by default.<\/p>\n