DiscordWebhook [Alts Support]

discordwebhook.yml new file

BEDROCK FIX

Bedrock/Floodgate Support

• Full support for Bedrock player names with prefix characters (.Steve, *Steve).
• Smart UUID resolution: online player > own database > Mojang API (skipped for Bedrock) > Bukkit fallback.
• Enhanced tab completion: typing Ste suggests both Steve and .Steve.
• All SQL queries handle special characters safely via prepared statements.

IPDynamic v2.0.0

Changelog

All notable changes to IPDynamic will be documented in this file.

---

[2.0.0] - 2026-03-24

Complete Rewrite - Premium Edition

This release is a complete ground-up rewrite of IPDynamic. Every file has been redesigned for production-grade quality, performance, and extensibility. The plugin has been upgraded from 13 source files to 78 source files across a clean modular architecture.

Backward Compatible: Existing v1.x databases are automatically upgraded on first startup. No data loss, no manual migration required.

---

Architecture

Database Layer

• HikariCP Connection Pool - Replaced single raw JDBC connection with HikariCP (pool size 3). Eliminates race conditions and database is locked errors under load.
• Repository Pattern - Split the monolithic 462-line DatabaseManager into 7 focused repositories (PlayerRepository, ConnectionRepository, IPRecordRepository, BanRepository, WhitelistRepository, AuditRepository, CountryRuleRepository), each under 150 lines.
• Transactional Writes - Multi-statement operations (player registration, IP record upsert) now use proper database transactions with commit/rollback.
• Idempotent Player Registration - Replaced SELECT-then-INSERT pattern with INSERT OR IGNORE + UPDATE to prevent race conditions when two connections for the same new player arrive simultaneously.
• Per-Connection PRAGMAs - SQLite journal_mode=WAL, foreign_keys=ON, and busy_timeout=5000 are now applied to every pool connection via connectionInitSql, not just the first one.
• Auto-Adaptive Schema - SchemaManager creates missing tables, adds missing columns, and creates missing indexes without ever dropping data. Seamless upgrade from any v1.x database.

Service Layer

• 9 dedicated services with single responsibility: GeoIPService, BanService, WhitelistService, AltDetectionService, VPNDetectionService, CountryService, AuditService, AlertService, DataRetentionService.
• lateinit initialization - All services use lateinit var with proper error handling. If initialization fails, the plugin disables itself cleanly instead of running in a broken state with null references.
• Coroutine Scoping - All async operations use MCCoroutine.launch with proper dispatchers. Database I/O runs on Dispatchers.IO, never blocking the main server thread.

Command System

• SubCommand Pattern - Replaced the 560-line monolithic command class with CommandRegistry + 15 individual command implementations, each focused and under 100 lines.
• Adventure API - All command output uses clickable and hoverable text components. Player names link to /ipdy check, IP addresses link to /ipdy ip, UUIDs are copy-to-clipboard.
• Pagination - List commands (history, banlist, whitelist list, audit) feature clickable [<< Prev] / [Next >>] page navigation.

Caching

• ExpiringCache - Generic TTL cache with LRU eviction. Configurable max size and time-to-live. Replaces the old unbounded ConcurrentHashMap that could cause memory leaks.
• BanPatternIndex - Trie-based data structure for O(1) IP ban pattern matching. Replaces the old O(n) linear scan that iterated all bans for every player login.

---

New Features

VPN/Proxy Detection

• Detect VPN, proxy, and hosting provider connections on player join.
• Configurable action: ALERT (notify staff), KICK (disconnect player), or BAN (auto-ban range).
• Uses extended GeoIP API fields (proxy, hosting, isp) from ip-api.com.
• Dedicated VPN results cache with separate TTL (default 120 minutes).
• Whitelisted players can bypass VPN checks (configurable).

Country Restriction System

• Block or allow players by country with BLACKLIST or WHITELIST mode.
• Use full country names in config: "Chile", "Russia", "United States" (no cryptic ISO codes).
• Runtime management via /ipdy country add <name> and /ipdy country remove <name>.
• Persistent storage - Country rules added via commands are saved to the database and survive reloads/restarts.
• Config.yml countries serve as base rules; database rules are merged on startup.

Staff Alert System

• Real-time notifications to online staff with the ipdynamic.alerts permission.
• Alert types: alt detected, VPN detected, new IP, country change.
• Optional alert sound (configurable pling notification).
• Each alert type individually toggleable in config.

First-Join Console Notification

• Professional formatted console notification when a brand-new player joins for the first time.
• Shows: username, IP address, country, and detected alt accounts.
• Disabled by default (first-join-console: false in config).
• Fully customizable message template in messages.yml.

Audit Log

• Immutable audit trail for all administrative actions.
• Tracks: who performed the action, what action, target, details, timestamp.
• Actions logged: ban add/remove, whitelist add/remove, country add/remove, reload, export, import, VPN kick, country kick.
• Viewable via /ipdy audit [page] with pagination.
• Configurable retention: auto-cleanup entries older than audit-max-days (default 90 days).

Data Retention

• Automatic cleanup of old connection records to prevent unbounded database growth.
• Configurable: connections-max-days (default 180 days) and audit-max-days (default 90 days).
• Runs on a configurable interval (default every 24 hours).
• Disabled by default - enable in config.yml when needed.

Rate Monitoring

• Detects potential bot attacks by monitoring connection rates per /24 IP range.
• Sliding window algorithm with configurable threshold and window size.
• Fires SuspiciousActivityEvent when threshold exceeded for webhook/alert integration.

CIDR Ban Support

• New ban type alongside OP1/OP2: CIDR notation (e.g., /ipdy ban cidr/24 192.168.1.0 reason).
• Bitwise prefix matching for accurate CIDR range calculations.
• Estimated IP count display for all ban types.

Export/Import

• Export bans or whitelist to JSON files: /ipdy export bans, /ipdy export whitelist.
• Import from JSON files: /ipdy import bans, /ipdy import whitelist.
• Files saved in the plugin data folder.

Public API

• IPDynamicAPI interface for other plugins to integrate with.
• Access via Bukkit's ServicesManager.
• CompletableFuture returns for async operations (profiles, alts, GeoIP).
• Direct synchronous returns for cached data (ban checks, whitelist checks).

PlaceholderAPI Integration

• 9 placeholders under the %ipdynamic_*% namespace:
  • %ipdynamic_country% - Player's country
  • %ipdynamic_country_code% - Country ISO code
  • %ipdynamic_connections% - Total connection count
  • %ipdynamic_alts% - Number of alt accounts
  • %ipdynamic_is_banned% - Whether player's IP is banned
  • %ipdynamic_is_whitelisted% - Whether player is whitelisted
  • %ipdynamic_is_vpn% - Whether player is on VPN/proxy
  • %ipdynamic_ban_count% - Total active bans
  • %ipdynamic_whitelist_count% - Total whitelisted players

Event System

• 6 custom async Bukkit events for other plugins to listen to:
  • AltDetectedEvent - Alt account detected on join
  • VPNDetectedEvent - VPN/proxy detected on join
  • NewIPDetectedEvent - Player connected from new IP
  • FirstJoinEvent - Brand-new player's first connection
  • CountryBlockedEvent - Player blocked by country restriction
  • SuspiciousActivityEvent - Rate anomaly detected

---

New Configuration

config.yml (NEW)

Full plugin configuration file with sections for:

• Database (pool size, filename)
• GeoIP (providers, cache TTL, max size, request timeout)
• VPN detection (enabled, action, providers, cache TTL, whitelist bypass)
• Country restriction (enabled, mode, country names, kick message)
• Staff alerts (enabled, per-type toggles, permission, sound)
• Data retention (enabled, max days for connections and audit, cleanup interval)
• Pagination (page size)
• Rate monitoring (enabled, threshold, window)

messages.yml (EXPANDED)

• All existing v1 messages preserved.
• New sections: VPN messages, country restriction messages, audit messages, alert formats, pagination format, first-join console notification, export/import messages.

---

New Commands

Command	Permission	Description
/ipdy country add <name>	ipdynamic.country	Add country to restriction list
/ipdy country remove <name>	ipdynamic.country	Remove country from restriction list
/ipdy country list	ipdynamic.country	View restricted countries
/ipdy audit [page]	ipdynamic.audit	View audit log with pagination
/ipdy export <bans|whitelist>	ipdynamic.export	Export data to JSON file
/ipdy import <bans|whitelist>	ipdynamic.import	Import data from JSON file

New Permissions

Permission	Default	Description
ipdynamic.country	OP	Manage country restrictions
ipdynamic.audit	OP	View audit log
ipdynamic.export	OP	Export plugin data
ipdynamic.import	OP	Import plugin data
ipdynamic.alerts	OP	Receive staff alerts

---

Performance Improvements

Area	Before (v1)	After (v2)	Improvement
Ban checking	O(n) linear scan all bans	O(1) trie lookup	Constant time regardless of ban count
GeoIP cache	Unbounded, no TTL, no eviction	TTL + LRU eviction + max size	No more memory leaks
GeoIP rate limiting	None (429 errors under load)	Token bucket 40 req/min	No more API bans
DB connections	Single shared JDBC connection	H...

IPDynamic v1.0.0

🌐 IPDynamic

Advanced IP Tracking & Alt Detection System for Minecraft Servers

Protect your server from ban evaders and manage player connections like never before.

---

📋 Table of Contents

• ✨ Features
• 📥 Installation
• 🎮 Commands
• 🔐 Permissions
• ⚙️ Configuration
• 🗄️ Database
• 🔧 Technical Details
• 📸 Screenshots
• ❓ FAQ

---

✨ Features

🔍 IP Tracking

Track every player connection with detailed information including IP address, country, and timestamps.

👥 Alt Account Detection

Automatically detect alt accounts by analyzing shared IP addresses across your player database.

🚫 IP Range Banning

Powerful IP banning system with two operation modes:

Mode	Pattern	Example	IPs Affected
OP1	x.x.x.*	192.168.1.*	~256 IPs
OP2	x.x.*.*	192.168.*.*	~65,536 IPs

✅ Whitelist System

Allow specific players to bypass IP bans with UUID and username verification via Mojang API.

🌍 GeoIP Integration

Automatic country detection for every connection using free GeoIP services.

💾 Persistent Storage

SQLite database with auto-adaptive schema - your data survives plugin updates seamlessly.

⚡ Async Operations

Built with Kotlin Coroutines for non-blocking database operations that won't lag your server.

🎨 Customizable Messages

Full message customization via messages.yml - translate or customize every plugin message.

🔒 Granular Permissions

Fine-grained permission system allowing you to give moderators exactly the access they need.

---

📥 Installation

1. Download the latest IPDynamic.jar from Releases
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/IPDynamic/

Requirements

Requirement	Version
Minecraft Server	1.17.x - 1.21.x
Server Software	Paper or Spigot
Java	17 or higher

---

🎮 Commands

Base command: /ipdynamic (aliases: /ipdy, /ipd)

📊 Information Commands

Command	Description
/ipdy check <player>	View complete player profile with IP history and alt accounts
/ipdy history <player> [limit]	View player's connection history
/ipdy alts <player>	List all detected alt accounts for a player
/ipdy ip <address>	Find all accounts that have used a specific IP
/ipdy stats	View plugin statistics

🚫 Ban Management

Command	Description
/ipdy ban <op1|op2> <ip> [reason] [duration]	Ban an IP range
/ipdy unban <pattern>	Remove an IP ban
/ipdy banlist	View all active IP bans

Duration Examples:

• 30m - 30 minutes
• 12h - 12 hours
• 7d - 7 days
• 4w - 4 weeks
• No duration = Permanent ban

✅ Whitelist Management

Command	Description
/ipdy whitelist add <player> [reason]	Add player to whitelist
/ipdy whitelist remove <player>	Remove player from whitelist
/ipdy whitelist list	View all whitelisted players

⚙️ Administration

Command	Description
/ipdy reload	Reload plugin configuration
/ipdy help	Display available commands

---

🔐 Permissions

Master Permission

Permission	Description	Default
ipdynamic.*	Full access to all commands	OP

Individual Permissions

Permission	Commands	Recommended For
ipdynamic.check	/ipdy check	Moderators
ipdynamic.history	/ipdy history	Moderators
ipdynamic.alts	/ipdy alts	Moderators
ipdynamic.ip	/ipdy ip	Moderators
ipdynamic.ban	/ipdy ban	Administrators
ipdynamic.unban	/ipdy unban	Administrators
ipdynamic.banlist	/ipdy banlist	Administrators
ipdynamic.whitelist	/ipdy whitelist	Administrators
ipdynamic.stats	/ipdy stats	Administrators
ipdynamic.reload	/ipdy reload	Administrators

Example Permission Setup

For Moderators (LuckPerms):

/lp group moderator permission set ipdynamic.check true
/lp group moderator permission set ipdynamic.history true
/lp group moderator permission set ipdynamic.alts true
/lp group moderator permission set ipdynamic.ip true

For Administrators:

/lp group admin permission set ipdynamic.* true

---

⚙️ Configuration

📁 messages.yml

Customize all plugin messages with full color code support:

# Prefix for all messages
prefix: "&b&lIPDynamic &8|"

# Ban screen shown to banned players
ban-screen:
  - "&c&l⚠ IP BANNED ⚠"
  - ""
  - "&7Your IP: &f{ip}"
  - "&7Matched Pattern: &c{pattern}"
  - "&7Reason: &f{reason}"
  - "&7Banned by: &f{banned_by}"
  - "&7Date: &f{banned_date}"
  - "&7Duration: &f{duration}"
  - ""
  - "&7Contact an administrator if you believe this is an error."

# Duration formats
duration:
  permanent: "&cPermanent"
  expired: "&aExpired"

# Command messages
messages:
  no-permission: "&cYou don't have permission to use this command."
  player-not-found: "&cPlayer not found in database."
  invalid-ip: "&cInvalid IP address format."
  # ... more messages

🎨 Color Codes

Code	Color	Code	Color
&0	Black	&8	Dark Gray
&1	Dark Blue	&9	Blue
&2	Dark Green	&a	Green
&3	Dark Aqua	&b	Aqua
&4	Dark Red	&c	Red
&5	Dark Purple	&d	Pink
&6	Gold	&e	Yellow
&7	Gray	&f	White
&l	Bold	&o	Italic
&n	Underline	&m	Strike

---

🗄️ Database

IPDynamic uses SQLite for data storage with automatic schema management.

Database Location

plugins/IPDynamic/ipdynamic.db

Tables Structure

📦 ipdynamic.db
├── 📋 players          - Player profiles and first connection data
├── 📋 connections      - Complete connection history log
├── 📋 ip_records       - IP address records per player
├── 📋 ip_bans          - Active IP range bans
└── 📋 whitelist        - Whitelisted players

Auto-Adaptive Schema

The database automatically adapts to plugin updates:

• ✅ Creates missing tables on startup
• ✅ Adds new columns without data loss
• ✅ Preserves all existing data during updates

---

🔧 Technical Details

Built With

Technology	Purpose
Kotlin 1.9	Primary language
MCCoroutine	Async operations on Bukkit
Paper API	Server integration
Adventure API	Modern text components
SQLite + JDBC	Data persistence
Mojang API	UUID verification

Performance Optimizations

• 🚀 In-memory caching for bans and whitelist
• 🚀 Async database operations prevent server lag
• 🚀 WAL mode for SQLite concurrent access
• 🚀 Connection pooling for efficient queries
• 🚀 Lazy loading for player profiles

Version Compatibility

Server Version	Status
1.17.x	✅ Supported
1.18.x	✅ Supported
1.19.x	✅ Supported
1.20.x	✅ Supported
1.21.x	✅ Supported

---

📸 Screenshots

Player Check

╭─────────────────────────────────────────╮
│  IPDynamic | Player Information         │
├─────────────────────────────────────────┤
│  Username: ExamplePlayer                │
│  UUID: 12345678-1234-1234-1234-1234567  │
│  First Connection: 01/01/2024 12:00:00  │
│  Total Connections: 150                 │
│                                         │
│  First IP                               │
│  Address: 192.168.1.100                 │
│  Country: United States                 │
│                                         │
│  IP History (3)                         │
│  - 192.168.1.100 (First)               │
│    Country: United States               │
│    Connections: 100                     │
│                                         │
│  Alt Accounts Detected (2)              │
│  - AltAccount1                          │
│    Shared IP: 192.168.1.100            │
│  - AltAccount2                          │
│    Shared IP: 10.0.0.50                │
╰─────────────────────────────────────────╯

Ban Screen

╭─────────────────────────────────────────╮
│           ⚠ IP BANNED ⚠                │
├─────────────────────────────────────────┤
│                                         │
│  Your IP: 192.168.1.100                 │
│  Matched Pattern: 192.168.1.*           │
│  Reason: Ban evasion                    │
│  Banned by: AdminName                   │
│  Date: 01/01/2024 15:30:00             │
│  Duration: 7d 0h                        │
│                                         │
│  Contact an administrator if you        │
│  believe this is an error.    ...