## 🌐 Overview **IPViewer** is a plugin for [Paper](https://papermc.io/) Minecraft servers version _1.20_ and above, designed for server administrators and moderators. It provides a simple way to view players' IP addresses, helping with server management and detecting ban evasion or alt accounts.

All technical settings and features presented here are for the latest version of the plugin and will not always work on older versions.

## 🔍 Features * View all players who have joined the server since the plugin was installed, along with their IP addresses and last seen time * Filter and search player IPs easily * Detect shared IPs across multiple accounts * Helps track down ban evasion and suspicious activity ## 📜 Commands Here are all the commands that can be used in the plugin: * `/ipv help` - Displays all available plugin commands * `/ipv reload` - Reloads the plugin configuration * `/ipv list ` - Shows a list of players with optional filters (e.g., by IP or join time) ## 🪪 Filters for `/ipv list` The `/ipv list` command supports flexible filters to help you search and organize player IP data. All filters can be used together in a single command. | **Filter** | **Description** | |-------------------------------------|----------------------------------------------------------------------------------------------| | `page:` or just `` | Displays a specific results page (e.g., `/ipv list 2` or `/ipv list page:2`) | | `player:` | Filters results by player name (supports partial matches and wildcards) | | `ip:` | Filters by IP address (supports partial matches and wildcards) | | `country:` | Filters by country name or code (e.g., `country:United States`) | | `state:` | Filters by region or state (useful for more granular IP geolocation, e.g., `state:New York`) | | `time:` | Shows only players seen within a time range (e.g., `time:24h`, `time:30m`) | ### 🧠 Wildcards Filters that use text (`player`, `ip`, `country`, `state`) support SQL-style wildcards: * `%` - Matches any sequence of characters * `_` - Matches a single character You can also use spaces in filter values: * Replace spaces with `+` - `country:United+States` * Wrap the value in quotes - `state:"New York"` When quotes are used, `+` characters are preserved as written. ### 📌 Example ``` /ipv list player:stev% ip:192.168.% time:7d page:3 ``` This command shows page `3` of players whose names start with `stev`, IP starts with `192.168.`, and who have been seen in the last `7 days`. ## 📁 Configuration The config file is generated on first launch and modify it to adjust output formats or other plugin settings. View default config [here](https://github.com/MusiJVR/IPViewer/blob/main/src/main/resources/config.yml). All messages in the config use the [MiniMessage](https://docs.advntr.dev/minimessage/) format, which allows rich text formatting (colors, gradients, bold, etc.). You can preview and create formatted messages using the [MiniMessage Viewer](https://webui.advntr.dev/). ## ⚙️ Settings for Developers and Administrators The plugin has permissions: | **Permissions** | **Meaning** | |-----------------------------|---------------------------------------| | `ipviewer.ipviewer` | Grants access to the `/ipv` command | ## ❗ Issues Please leave messages about any errors you find [here](https://github.com/MusiJVR/IPViewer/issues) or on the [Discord](https://discord.gg/xY8WJt7VGr) ## 💬 Social Media - Page on [Modrinth](https://modrinth.com/plugin/ipviewer) - Page on [GitHub](https://github.com/MusiJVR/IPViewer) - Page on [Discord](https://discord.gg/xY8WJt7VGr)

MouseJava