# GateKeeper<\/p>\n
**Protect your server with a secret key system.** Instead of a traditional whitelist, GateKeeper requires players to enter a password when joining from an unrecognized IP \u2014 keeping unwanted visitors out without banning accounts.<\/p>\n
—<\/p>\n
## How It Works<\/p>\n
– When a player joins from an **unknown IP**, they are prompted to enter the secret key in chat
\n– Their input is **hidden from other players** and they are **frozen in place** until authenticated
\n– Once authenticated, their IP is **trusted for a configurable period** (default: 30 days)
\n– If they return on the **same IP within that period**, they get in with no prompt
\n– If they join from a **new IP**, they must authenticate again<\/p>\n
—<\/p>\n
## Failed Attempts<\/p>\n
– Players get a configurable number of attempts (default: 5)
\n– Exceeding the limit results in an **IP ban** \u2014 the player account itself is never banned
\n– Ban duration is configurable, or set to permanent<\/p>\n
—<\/p>\n
## Features<\/p>\n
– \ud83d\udd11 Secret key authentication on join
\n– \ud83c\udf10 Per-player trusted IP storage with expiry
\n– \ud83d\udeab IP ban on too many failed attempts
\n– \u26cf\ufe0f Mining Fatigue 255 applied while unauthenticated
\n– \ud83d\udd12 Movement and commands blocked until authenticated
\n– \u2699\ufe0f Fully configurable via `config.yml`<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
“`yaml
\nsecret-key: “changeme123”
\nmax-attempts: 5
\nban-duration-minutes: 60 # 0 = permanent
\ntrusted-ip-expiry-days: 30 # 0 = never expire, 7 = one week
\nkick-message: “Too many failed attempts. Your IP has been banned.”
\nprompt-message: “\u00a7eEnter the server secret key in chat:”
\nwrong-message: “\u00a7cWrong key. Attempts remaining: %attempts%”
\nsuccess-message: “\u00a7aAuthenticated! Welcome.”
\n“`<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– Paper \/ Spigot **1.20+**
\n– Java **17**<\/p>\n
—<\/p>\n
*Made by flintify*<\/p>\n","protected":false},"excerpt":{"rendered":"
An unique plugin that uses a never seen before method to replace whitelist!<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"gatekeeper-auth","_minecraft_project_id":"ZBa3snm4","_minecraft_author":"Flintify","_minecraft_license":"MIT","_minecraft_downloads":4,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gatekeeper-auth.zip","_minecraft_size_bytes":36157,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:15:07.798794Z","_minecraft_date_created":"2026-05-11T01:52:26.847294Z","_minecraft_date_modified":"2026-05-10T15:10:04.535297Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gatekeeper-auth","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-04T08:18:04+00:00","_minecraft_import_hash":"21ae6466664fa11dc7dd38f0a4816e43","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,123,92],"mod_loader":[132],"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,83,167,163],"class_list":["post-74893","mod","type-mod","status-publish","hentry","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n