🌐 Overview
IPViewer is a plugin for Paper 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 <filters (optional)>- 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:<number> or just <number> |
Displays a specific results page (e.g., /ipv list 2 or /ipv list page:2) |
player:<text> |
Filters results by player name (supports partial matches and wildcards) |
ip:<text> |
Filters by IP address (supports partial matches and wildcards) |
country:<text> |
Filters by country name or code (e.g., country:United States) |
state:<text> |
Filters by region or state (useful for more granular IP geolocation, e.g., state:New York) |
time:<duration> |
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.
All messages in the config use the MiniMessage format, which allows rich text formatting (colors, gradients, bold, etc.). You can preview and create formatted messages using the MiniMessage Viewer.
⚙️ 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 or on the Discord
