IPLock is a plugin designed for Minecraft servers running on Paper 1.21.1, aimed at enhancing player account security by binding accounts to a specific IP address. The plugin restricts account access to only the registered IP, helping to prevent unauthorized logins in case an account is compromised. All messages are fully customizable via a language file, making it adaptable for servers with diverse language preferences.<\/p>\n
Plugin Functionality IPLock is a plugin designed for Minecraft servers running on Paper 1.21.1, aimed at enhancing player account security by binding accounts to a specific IP address.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"iplocker","_minecraft_project_id":"G37Mnsq5","_minecraft_author":"RedBounce_","_minecraft_license":"Apache-2.0","_minecraft_downloads":471,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"iplocker.zip","_minecraft_size_bytes":5686,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T10:42:30.306349Z","_minecraft_date_created":"2025-04-16T06:23:31.034701Z","_minecraft_date_modified":"2025-04-12T19:44:48.579491Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/iplocker","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-04T22:20:29+00:00","_minecraft_import_hash":"08c9441d228ede84096a893325797c5c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128],"mod_loader":[132,133],"minecraft_version":[62,37,73,74,38,78],"class_list":["post-86287","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\nAutomatic IP Binding:
\nUpon a player’s first login to the server, their UUID (unique identifier) and IP address are automatically stored in the ipdata.yml file.
\nThis ensures seamless IP registration without requiring any action from the player.
\nIP Verification on Login:
\nEach time a player logs in, the plugin compares their current IP address with the one stored in ipdata.yml.
\nIf the IP does not match, the login is denied, and the player receives a customizable error message (default: “\u00a7cYour IP does not match the registered IP for this account!”).
\nThis protects accounts from being accessed from unrecognized devices or networks.
\nIP Unbinding Command:
\nThe plugin provides the \/ipdel
\nThis command removes the IP binding for the specified player, allowing them to log in from a new IP on their next attempt.
\nCommand-related messages (e.g., success, error, or no binding found) are fully customizable.
\nCustomizable Messages:
\nAll plugin messages are stored in the lang.yml file, which is generated in the plugins\/IPLock\/ folder on first startup.
\nMessages support Minecraft color codes (\u00a7) and placeholders (e.g., {player} for the player\u2019s name, {error} for error details).
\nExamples of customizable messages:
\nLogin error: “\u00a7cYour IP does not match the registered IP for this account!”.
\nSuccessful unbinding: “\u00a7aIP binding for {player} has been removed!”.
\nCommand error: “\u00a7cUsage: \/ipdel
\nAdministrators can edit lang.yml to modify text, language, or style without rebuilding the plugin.
\nData Storage:
\nIP binding data is stored in ipdata.yml in the format UUID: IP.
\nThe file is automatically created and updated during player logins or when the \/ipdel command is used.
\nYAML usage ensures readability and reliable data persistence.
\nSecurity and Performance:
\nThe plugin uses UUIDs instead of player names to avoid issues with name changes.
\nIP checks are performed only during login, minimizing server load.
\nThe language file is loaded once at startup, ensuring no performance impact during operation.
\nUsage
\nFor Players:
\nNo action is required \u2014 IP binding happens automatically on first login.
\nIf a player\u2019s IP changes (e.g., due to a dynamic IP), they won\u2019t be able to log in until an operator removes the old binding with \/ipdel.
\nFor Administrators:
\nUse \/ipdel
\nCustomize messages in lang.yml to match the server\u2019s style (e.g., translate to another language or add a unique prefix).
\nCheck ipdata.yml to view current IP bindings (useful for debugging).
\nExample Workflow
\nPlayer Steve logs in for the first time from IP 192.168.1.1:
\nThe plugin saves to ipdata.yml: Steve_UUID: 192.168.1.1.
\nSteve tries to log in from IP 192.168.1.2:
\nThe plugin denies the login and displays: “\u00a7cYour IP does not match the registered IP for this account!”.
\nAn operator runs \/ipdel Steve:
\nThe plugin removes the binding from ipdata.yml and sends: “\u00a7aIP binding for Steve has been removed!”.
\nSteve logs in again from the new IP, and the binding process repeats.
\nTechnical Details
\nCompatibility: Paper 1.21.1.
\nDependencies: Maven, Paper API (included in pom.xml).
\nPlugin Files:
\nIPLock.java \u2014 main code (package org.example.iplock.iplock).
\nplugin.yml \u2014 plugin configuration.
\nipdata.yml \u2014 IP binding storage.
\nlang.yml \u2014 customizable messages.
\nBuild: Uses Maven (mvn clean install).
\nLimitations:
\nOnly one IP per account is supported. Dynamic IPs require manual unbinding via \/ipdel.
\nNo built-in support for reloading lang.yml without a server restart (can be added if needed).
\nSummary
\nIPLock is a straightforward yet effective tool for securing player accounts on Minecraft servers. It combines automatic IP binding, operator-controlled unbinding, and fully customizable messages, making it user-friendly for both players and administrators. The plugin is ideal for servers prioritizing account security, with its flexible message system allowing seamless integration into any server\u2019s branding or language.<\/p>\n","protected":false},"excerpt":{"rendered":"