Newon GoogleMake CraftRank a preferred source in Google SearchAdd on Google ›
CraftRank SitesA free website and store for your server Make yours ›AshlarFree server software built on Paper, with DDoS and backdoor protection See Ashlar ›Security RadarA free check of your server's login, anti-bot and proxy settings, only with your OK See how it works ›CommunityAsk questions, share builds and find people to play with Join the forum ›
Resources / Plugins / IPTree

IPTree

Advanced sockpuppet & ban evasion detection plugin for Spigot 1.8.8

PluginsFree1.8
by TreesWorld_LP · listed from SpigotMC
Download ›

Direct download from SpigotMC · 3 downloads

What it does

IPTree is a plugin for Paper / Spigot servers, made by TreesWorld_LP. Advanced sockpuppet & ban evasion detection plugin for Spigot 1.8.8.

It supports Minecraft 1.8. It has been downloaded 3 times on SpigotMC. That puts it at #488 of the 556 admin and permission plugins listed here. The last update came out on Nov 15, 2026.

Supported versions

1.8

Release history

The newest is b38, released on Nov 15, 2026.

VersionReleasedType
b38Nov 15, 2026Release

Commands

The commands named on the SpigotMC page of IPTree:

/logs/iptree

Latest release on GitHub

IPTree is open source. Its newest release on GitHub is IPTree b38, published on Nov 15, 2026.

First public release of IPTree.

Description from the author on SpigotMC

IPTree

IPTree is scary surveillance. This plugin is meant as an advanced sockpuppet and ban-evasion detection plugin for Spigot servers. Unlike standard moderation plugins that only check a player's
current IP address, IPTree reconstructs complex historical account-to-IP graphs from compressed server logs and live sessions while trying to avoid dynamic-IP false positives. Running IPTree queries is very performance intensive, therefore this plugin does not offer any functionality to automatically punish ban evaders. IPTree is meant to assist moderators with their work. Use IPTree responsibly as it is a very powerful tool.

Requirements

  • IPTree may work on Spigot versions other than 1.8.8, however no support is given for those.
  • Java 8 or newer
  • MySQL or MariaDB as Database

Why IPTree?

Traditional IP-ban plugins miss rotating or dynamic IPs:

  • AccountA logs in from 203.0.113.10.
  • One hour later, AccountB logs in from 203.0.113.10.
  • The next day, AccountA's router gets a new IP like 198.51.100.42, they cheat, and get IP-banned.

A normal ban plugin only blocks
198.51.100.42 and never connects
AccountB to
AccountA. IPTree parses your historical
/logs directory and live joins/quits, links accounts that shared an IP and surfaces the full tree of related accounts & IPs per command. If you made backups of your server logs for many years, cheer up. Now you can actually use them for something. On the other hand, if you do not have a large collection of logs from your server, you will need to wait a few months after installation before IPTree reaches its potential.

Features

  • Retroactive Log Parsing: Reads both .log.gz archives and .log files from your server's /logs folder.
  • Time-Bounded Graph Analysis: Links accounts that shared an IP within a configurable time window to avoid false links when ISPs reassign dynamic IPs weeks or months later.
  • Cluster Merging: Optionally merge separate time clusters on an IP or player lookup to catch static-IP ban evaders returning months later.
  • Live Session Recording: Logs player join and leave times directly to MySQL in real time.
  • Multi-Server Support: Combine and merge historical logs across multiple servers (e.g., Lobby, Survival, Creative).
  • Local IP Filtering: Automatically skips local and private IP addresses such as 127.0.0.1.
  • Interactive Chat Output: Clickable usernames, UUIDs, and IPs in chat with full tab completion.

Installation & Setup

Spoiler: Single Server Setup

  • Put IPTree.jar into your server's plugins/ folder and start the server once to generate plugins/IPTree/config.yml.
  • Enter your MySQL database credentials in plugins/IPTree/config.yml and leave LiveMode: false for now. If you do not have a database set up yet, create one first.
  • Restart the server so IPTree connects to MySQL and creates its table.
  • If the database cannot be reached on startup, IPTree enters Sleep Mode until a valid database connection is configured and the server is restarted.
  • Run /iptree db create once to import your historical /logs into the database. Depending on how many log files you have, this can take anywhere from a few minutes to multiple hours. Make sure your server has enough free disk space, as IPTree temporarily decompresses log archives during this step (for example, 300 MB of compressed logs might require 15 GB of space).
  • Once the database has been created, stop the server, set LiveMode: true in plugins/IPTree/config.yml, and start the server again. Following this order ensures there are no gaps in your database.

Spoiler: Multi Server Instance Setup

When combining logs from multiple backend servers into one shared MySQL database:

Proxy Note: Make sure IP forwarding is enabled on your proxy (BungeeCord / Velocity) and
bungeecord: true is set in
spigot.yml. Otherwise, all players will show up with the IP
127.0.0.1.

  • On every Contributor server:
  • Set MultiServer: true and MultiServerRole: contributor in config.yml, then restart or run /iptree reload.
  • Run /iptree preparemultiserver to export the server's logs to logs/iptree_multisrvcache/.
  • On the main Architect server:
  • Set MultiServer: true and MultiServerRole: architect in config.yml, then restart.
  • Run /iptree preparemultiserver.
  • Copy the exported .yml files from all Contributor servers into the Architect server's logs/iptree_multisrvcache/ folder.
  • Run /iptree db create on the Architect server to merge all logs and populate the database.
  • Now enable LiveMode on all servers and restart them at the same time.

Commands & Permissions

Permission: iptree.admin

  • /iptree get <uuid/username/ip> [joinclusters (true/false)] Look up a player or IP address (joinclusters defaults to false).
  • /iptree massget <joinclusters (true/false)> <target1,target2,...> Look up multiple players or IPs separated by commas.
  • /iptree recentget <num> [joinclusters (true/false)] Look up the num most recent players on the server.
  • /iptree db create Import server logs into an empty database.
  • /iptree db stats Show total log entries, unique IPs, and unique accounts in the database.
  • /iptree db conflicts List recorded sessions where no leave timestamp was found.
  • /iptree cfg <config-option-name> [value] View or change config options in-game.
  • /iptree reload Reload configuration.
  • /iptree preparemultiserver Export local server logs for Multi-Server setups.

How joinclusters Works

  • false: Only links accounts that used the same IP within the configured time window AccountIPRelationHours.
  • true: Also merges accounts from older or newer sessions that used the same IP, regardless of how much time passed between them.

Important Remark: IPTree can still produce false positives due to dynamic IP pools (e.g., ISP address rotation or shared VPNs). The chance of false positives increases when
AccountIPRelationHours or
JoinLeaveRelationHours is set to a high value and when
joinclusters is enabled. The returned player list should therefore be taken as an indication of ban evasion, not as definitive proof.

Configuration

  • SQLHost: MySQL server address.
  • SQLPort: MySQL server port.
  • SQLDatabase: MySQL database name.
  • SQLUsername: MySQL username.
  • SQLPassword: MySQL password.
  • JoinLeaveRelationHours: Max hours between a join and leave in the logs to count them as one session.
  • AccountIPRelationHours: Max hours between two sessions on the same IP for two accounts to be linked.
  • SkipDirtyData: Ignore local and private IP addresses.
  • LiveMode: Record live player join and leave events to the database (requires a server restart when changed).
  • IPDisplayMode: How IPs are formatted in chat: raw (all on one line), bundle (grouped per line), or single (one IP per line).
  • ServerIdentifier: Auto-generated ID for this server.
  • MultiServer: Enable Multi-Server mode.
  • MultiServerRole: Server role when Multi-Server mode is enabled (contributor or architect).

Privacy & Security Notice

IPTree stores player UUIDs, usernames, session timestamps, and IP addresses in your MySQL database for server moderation and ban-evasion prevention. Server administrators are responsible for securing access to their SQL database and disclosing IP logging in their server's privacy policy where required by applicable laws such as the GDPR.

Source Code

Source code and build instructions are available on GitHub:
https://github.com/TreesPlay/IPTree

Written by TreesWorld_LP. Read it with pictures on SpigotMC.

How to install IPTree

  1. Make sure your server runs Paper and Spigot on Minecraft 1.8.

  2. Download the .jar file from SpigotMC and put it in the plugins folder of your server.

  3. Restart the server. Avoid /reload, many plugins do not handle it well.

  4. Type /plugins in the console: IPTree should be listed in green. Its config files are created in the plugins folder on the first start.

Full guide: How to install plugins on a Minecraft server

Compatibility

Minecraft versions
1.8
Runs on
Paper, Spigot
Edition
Java
Needs
Nothing else
Price
Free
Upkeep
Actively updated (Nov 16, 2026)

IPTree compared with similar ones Compare all alternatives

ResourceDownloadsRatingVersionsLast updatePrice
IPTreethe one you looked at3–1.822 hours agoFree
EmpireBanLucasTHCR27–1.8 – 26.x4 days agoFree
AdvancedBanLeoko824K4.31.8 – 1.21Oct 27, 2020Free
BanItemAndross109K4.61.8 – 26.xJul 19, 2026Free

Questions

Does IPTree work on Minecraft 26.x?

Not yet. The newest version it supports is Minecraft 1.8.

Is IPTree free?

Yes. IPTree is free to download from SpigotMC.

Which server software does IPTree run on?

IPTree runs on Paper and Spigot servers.

Is IPTree server-side?

Yes. IPTree is a server plugin: it goes in the plugins folder of the server, not in the mods folder of a player's game.

Is IPTree still updated?

Yes. The last update came out in the past day.

What are the best alternatives to IPTree?

The closest ones are EmpireBan, AdvancedBan and BanItem. Compare all alternatives

Alternatives to IPTree

BanPlusPlugins · 1.20 – 26.x

A lightweight and easy-to-use ban management plugin for Minecraft servers, featuring temporary bans, permanent bans, automatic unbanning, and multilingual…

Free32 downloads
BanSystemPlugins · 1.17 – 26.x

Ban-, Tempban-, Kick- und Mesh-Sync-System für Paper (1.17.1–26.3) und Velocity (3.1–4.3), zweisprachig (de/en). / Ban, tempban, kick & mesh-sync system for…

Free19 downloads
mBanPlugins · 1.21

A simple Ban system for a Minecraft Server. /mBan /mKick usw. With Timer and reason

Free18 downloads
Compare all alternatives ›

Reviews

–★★★★★
0 reviews
50
40
30
20
10

Log in to leave a review.