# \ud83d\udee1\ufe0f KatIPAuth (KIA)<\/p>\n
 <\/p>\n
**KatIPAuth** is an optimized plugin for **Minecraft 1.19 to 1.21.x** that locks accounts to IPs.
\nIt provides account security for cracked servers without the need for complex authentication plugins.
\nNo passwords. No sessions. Just **IP says yes or go home**.<\/p>\n
## \ud83d\ude80 Key Features<\/p>\n
### \ud83d\udc64 UUID-IP Identity Locking
\n– **Dual Binding**: Binds both player UUID and IP on first join for maximum security.
\n– **Bidirectional Verification**: UUID can only use its bound IP, and each IP can only be used by its bound UUID.
\n– **Multi-Account Support**: Optional multi-account mode allows multiple UUIDs on the same IP with configurable limits.
\n– **Login Block**: Automatically blocks access from mismatched UUID-IP combinations.
\n– **Specific Error Messages**: Clear, actionable kick messages that explain why access was denied.<\/p>\n
### \ud83d\udcf6 Subnet Locking (BETA)
\n– **Dynamic IP Support**: Solving dynamic IP issues by allowing connections within the same subnet.
\n– **Security Balance**: Provides flexibility for players whose IPs change within their ISP’s range while still blocking unauthorized access from elsewhere.<\/p>\n
### \ud83d\udce1 Discord Alerts & Logging
\n– **Real-time Discord Notifications**: Sends detailed embeds to your configured webhook with player info, stored ID, attempt details, and timestamps.
\n– **Console Logging**: All login attempts (success and failure) are logged to console and files for audit trails.
\n– **Complete Audit Trail**: Local log files with timestamps for compliance and troubleshooting.<\/p>\n
### \ud83d\udee0\ufe0f Maintenance & Utilities
\n– **Auto Config Update**: Automatically adds missing settings and comments to your `config.yml` on plugin updates.
\n– **H2 Database**: Persistent, reliable storage with automatic migrations from legacy formats.
\n– **Formatted Data**: View binding times in standard readable formats (`yyyy-MM-dd HH:mm:ss`).<\/p>\n
—<\/p>\n
## \ud83e\uddfe Commands<\/p>\n
### Player Commands
\n#### \/ipstatus
\n– Shows if your currently used IP is bound.
\n– Shows exactly **when** it was bound in a readable format.<\/p>\n
### Admin Commands (Permission: `ipauth.admin`) —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n This is a sample of the `config.yml` with explanations for each section:<\/p>\n “`yaml # Privacy settings # Debug settings # Security settings # Customizable messages # Beta features (Use with caution) ### Security Settings Explained —<\/p>\n ## \u2753 FAQ<\/p>\n ### Q: How does the UUID-IP binding work? ### Q: Can I allow multiple players on the same IP? ### Q: Can dynamic IP players use this? ### Q: Can VPNs bypass this? ### Q: Is this compatible with other auth plugins? ### Q: How do I see what’s blocked and why? ### Q: How do I reset a player’s binding? ### Q: Where are logs stored? Simple auth system using first join ip instead of a classic registration system<\/p>\n","protected":false},"featured_media":89728,"template":"","meta":{"_minecraft_slug":"katipauth","_minecraft_project_id":"7cGy8DrI","_minecraft_author":"oiupoyt","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":126,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"katipauth.zip","_minecraft_size_bytes":89123,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:07:58.709800Z","_minecraft_date_created":"2026-02-09T23:48:37.383925Z","_minecraft_date_modified":"2026-03-30T16:41:16.111817Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/katipauth","_minecraft_icon_attachment_id":89728,"_minecraft_imported_at":"2026-06-05T02:59:02+00:00","_minecraft_import_hash":"b8d74ce6a7161efb9ee3e32a5f2d5e08","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-89727","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\n
\n#### \/ipinfo
\n#### \/ipreset
\n#### \/ipforce
\n#### \/ipreload
\n– Reloads the `config.yml` and re-initializes all settings (including Discord webhooks).<\/p>\n
\n# Discord Webhook URL for logging IP changes (optional)
\ndiscord:
\n webhook: “PUT_WEBHOOK_URL_HERE”<\/p>\n
\nprivacy:
\n mask-ips: false # If true, last two octets of IPs will be replaced with x (e.g. 192.168.xx.xx)<\/p>\n
\ndebug:
\n verbose: false # If true, print debug info in console for player joins, blocks, IP changes, etc.<\/p>\n
\nsecurity:
\n allow-multiple-accounts: true # If true, multiple UUIDs can bind to the same IP.
\n max-accounts-per-ip: 2 # Maximum number of accounts allowed per IP. Need allow-multiple-accounts=true for this to work.<\/p>\n
\nmessages:
\n blocked: “&cLogin blocked. If you believe this is a mistake contact the owner” # Default fallback message
\n uuid-ip-mismatch: “&cLogin blocked: UUID bound to different IP. Contact the owner if this is a mistake”
\n ip-uuid-mismatch: “&cLogin blocked: IP already bound to another account”
\n max-accounts: “&cLogin blocked: Maximum number of accounts reached for this IP”<\/p>\n
\nbeta:
\n subnet-locking: false # If true, players can join as long as they are in the same \/24 subnet (e.g. 192.168.1.*)
\n“`<\/p>\n
\n– **allow-multiple-accounts**: When `true`, multiple players can use the same IP (useful for local networks). When `false`, each IP is locked to a single UUID.
\n– **max-accounts-per-ip**: When multi-account is enabled, limits the number of different UUIDs that can use the same IP.<\/p>\n
\n– A: On first join, a player’s UUID and IP are bound together. To access the server, a player must use both the same UUID (account) AND the same IP. This prevents account sharing across different IPs and IP sharing across different accounts (unless multi-account is enabled).<\/p>\n
\n– A: Yes. Enable `security.allow-multiple-accounts: true` and set `security.max-accounts-per-ip` to your desired limit (default: 2). This is useful for local networks or shared internet connections.<\/p>\n
\n– A: Yes. If their IP changes within the same subnet, you can enable **Subnet Locking** in the beta settings.
\n*Reminder: Subnet Locking is a beta feature and may not be fully stable.*<\/p>\n
\n– A: No. VPN users get blocked unless they join from an IP that matches their binding or the subnet.<\/p>\n
\n– A: Yes. It works independently before players even enter the server, making it a great second layer of security alongside plugins like AuthMe.<\/p>\n
\n– A: Check the console logs (filtered by [KatIPAuth]) or your local log files in `plugins\/KatIPAuth\/LOGS\/`. Enable `debug.verbose: true` for detailed information. Discord webhook (if configured) will also send alerts.<\/p>\n
\n– A: Ask an admin to use `\/ipreset
\n– A: Local logs are stored in `plugins\/KatIPAuth\/LOGS\/` with daily files named `yyyy-MM-dd.log`. Discord webhooks (if configured) provide real-time alerts.<\/p>\n","protected":false},"excerpt":{"rendered":"