\n\n\ud83d\udd0d Mod Detection<\/h3>\nSee every mod, resource pack, and shader a player has installed \u2014 in real time<\/p>\n<\/td>\n | \n\ud83d\udee1\ufe0f Launcher Enforcement<\/h3>\nKnow exactly which launcher each player is using and block the ones you don’t trust<\/p>\n<\/td>\n<\/tr>\n<\/table>\n —<\/p>\n ## Features<\/p>\n – **Mod Detection** \u2014 Detects all client-side mods, resource packs, and shaders via the Hidder companion mod
\n– **Launcher Detection & Enforcement** \u2014 Identifies the player’s launcher using native OS-level inspection and enforces a configurable whitelist
\n– **3-Layer Verification** \u2014 Independent security layers that must all pass before a player is admitted
\n– **Encrypted Communication** \u2014 All data is encrypted end-to-end and integrity-verified
\n– **Player Whitelist** \u2014 Trusted players bypass verification entirely
\n– **Discord Webhooks** \u2014 Real-time notifications for joins, mod lists, blacklist violations, and verification failures
\n– **Floodgate Support** \u2014 Optionally bypass verification for Bedrock players
\n– **Admin Dashboard** \u2014 `\/modseeker status` for live monitoring of verification statistics<\/p>\n —<\/p>\n ## Version Compatibility<\/p>\n | Minecraft Version | Paper | Java | Status |
\n|——————-|——-|——|——–|
\n| 26.1 \/ 26.1.1 | Paper 26.1+ | Java 25+ | \u2705 Latest |
\n| 1.21.4 \u2013 1.21.11 | Paper 1.21+ | Java 21+ | \u2705 Supported |<\/p>\n ModSeeker’s Paper plugin is forward-compatible \u2014 a single JAR works across all supported versions within the same API generation.<\/p>\n —<\/p>\n ## Requirements<\/p>\n – PaperMC **1.21.4** or higher (including **26.1**)
\n– Java **21+** (Java **25+** for Minecraft 26.1)
\n– Hidder Fabric mod installed on clients<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Download the latest `modseeker.jar` from Modrinth or Releases
\n2. Place it in your server’s `plugins\/` folder
\n3. Start the server \u2014 configuration files are generated automatically
\n4. Edit `config.yml`, `modblacklist.json`, or `whitelist.json` as needed
\n5. Run `\/modseeker reload` to apply changes<\/p>\n —<\/p>\n ## Security Architecture<\/p>\n ModSeeker uses three independent verification layers. Each layer operates autonomously \u2014 disabling one does not weaken the others.<\/p>\n “`
\nPlayer Joins
\n |
\n v
\n[ Layer 1: Cryptographic Handshake ] — Is this the authentic Hidder mod?
\n |
\n v
\n[ Layer 2: Launcher Detection ] — Is the player using an approved launcher?
\n |
\n v
\n[ Layer 3: Mod Verification ] — Does the mod list contain banned mods?
\n |
\n v
\nPlayer Approved \u2705
\n“`<\/p>\n ### Layer 1 \u2014 Identity Verification<\/p>\n The server issues a unique cryptographic challenge for every connection. The client must produce a valid signed response using a native security module. Challenges are one-time-use with strict time limits, preventing replay attacks and spoofing.<\/p>\n ### Layer 2 \u2014 Launcher Detection<\/p>\n The companion mod detects which launcher started the game using native OS-level inspection. The server validates the result against a configurable whitelist. Supports 15 launchers including Prism Launcher, MultiMC, CurseForge, Modrinth App, ATLauncher, GDLauncher, Technic, FTB App, Lunar Client, Badlion Client, Feather Client, LabyMod, TLauncher, SKLauncher, and Pojav Launcher.<\/p>\n ### Layer 3 \u2014 Mod Verification<\/p>\n The client collects its installed mods, resource packs, and shader packs directly from the Fabric runtime registry. The data is encrypted end-to-end using hybrid RSA\/AES and includes a session-bound integrity signature. The server decrypts and verifies the signature before inspecting the mod list.<\/p>\n —<\/p>\n ## Configuration<\/p>\n ModSeeker generates the following files on first run:<\/p>\n | File | Purpose |
\n|——|———|
\n| `config.yml` | Main configuration \u2014 timeouts, kick messages, display settings, Discord webhook |
\n| `modblacklist.json` | List of banned mod IDs |
\n| `whitelist.json` | Players who skip verification entirely |
\n| `client-list.yml` | Per-launcher whitelist for Layer 2 \u2014 enable\/disable individual launchers |<\/p>\n ### config.yml<\/p>\n “`yaml
\n# —————————————————————
\n# Timeout Configuration
\n# —————————————————————
\nhandshakeTimeoutSeconds: 10
\nmodlistTimeoutSeconds: 15<\/p>\n # —————————————————————
\n# Mod List Filter
\n# Base mods hidden from console output (still checked)
\n# —————————————————————
\nmodlistFilter:
\n – “java”
\n – “minecraft”
\n – “fabricloader”<\/p>\n # —————————————————————
\n# Kick Messages
\n# Supports {mods}, {plural}, {maxMods} placeholders
\n# —————————————————————
\nkickMessages:
\n missingHidder: “Please Install Hidder Mod To Enter The Server”
\n blacklistedMods: “Please Remove {mods} Illegal Mod{plural} To Join The Server”
\n modlistTimeout: “Player Verification Failed”
\n modlistRequestFailed: “Player verification failed – unable to send mod list request.”
\n modCountExceeded: “You have too many mods installed. Maximum allowed: {maxMods}”<\/p>\n # —————————————————————
\n# Player Notification
\n# —————————————————————
\nenablePlayerNotifications: true
\nwelcomeMessage: “Welcome To The Server”<\/p>\n # —————————————————————
\n# Mod Count Threshold
\n# —————————————————————
\nenableModCountThreshold: false
\nmaxModCount: 50<\/p>\n # —————————————————————
\n# Mod List Display Settings
\n# —————————————————————
\nshowModList: true
\noneModPerLine: false
\nhighlightMods: true
\nhighlightBlacklistedMods: true<\/p>\n # —————————————————————
\n# Floodgate \/ Bedrock Player Handling
\n# —————————————————————
\nallowFloodgate: true<\/p>\n # ==================================================================
\n# Discord Webhook Integration
\n# ==================================================================
\ndiscord:
\n enabled: false
\n webhookUrl: “https:\/\/discord.com\/api\/webhooks\/YOUR_WEBHOOK_URL_HERE”
\n events:
\n playerJoin: true # Notify when a player joins
\n modListReceived: true # Notify with the player’s mod list
\n blacklistViolation: true # Notify when a banned mod is detected
\n verificationFailed: true # Notify when verification fails<\/p>\n # —————————————————————
\n# Mod Verification (Layer 3)
\n# Set to false to disable mod checking while keeping Layer 1-2 active
\n# —————————————————————
\nModVerification: true<\/p>\n # ==================================================================
\n# Launcher\/Client Verification (Layer 2)
\n# ==================================================================
\nlauncherVerification:
\n enabled: false
\n kickMessage: “Please use an approved launcher to join this server”
\n allowUnknownClients: false
\n“`<\/p>\n ### modblacklist.json<\/p>\n “`json
\n{
\n “blacklist”: [“exampleCheatMod”, “anotherBannedMod”]
\n}
\n“`<\/p>\n ### whitelist.json<\/p>\n “`json
\n[“trustedPlayerName”]
\n“`<\/p>\n ### client-list.yml<\/p>\n Controls which launchers are allowed to connect when Layer 2 (launcher verification) is enabled. Each launcher can be individually toggled.<\/p>\n “`yaml
\n# Launcher\/Client Whitelist
\n# enabled: true = allowed, enabled: false = blocked<\/p>\n prism:
\n enabled: false
\n name: “Prism Launcher”
\nmultimc:
\n enabled: false
\n name: “MultiMC”
\natlauncher:
\n enabled: false
\n name: “ATLauncher”
\ncurseforge:
\n enabled: false
\n name: “CurseForge”
\nmodrinth:
\n enabled: false
\n name: “Modrinth App”
\ngdlauncher:
\n enabled: false
\n name: “GDLauncher”
\ntechnic:
\n enabled: false
\n name: “Technic Launcher”
\nftb:
\n enabled: false
\n name: “FTB App”
\nlunar:
\n enabled: false
\n name: “Lunar Client”
\nbadlion:
\n enabled: false
\n name: “Badlion Client”
\nfeather:
\n enabled: false
\n name: “Feather Client”
\nlabymod:
\n enabled: false
\n name: “LabyMod”
\ntlauncher:
\n enabled: false
\n name: “TLauncher”
\nsklauncher:
\n enabled: false
\n name: “SKLauncher”
\npojav:
\n enabled: false
\n name: “Pojav Launcher”
\n“`<\/p>\n To allow a launcher, set its `enabled` to `true`. Players using a blocked or unrecognized launcher are kicked with the message configured in `config.yml` under `launcherVerification.kickMessage`.<\/p>\n —<\/p>\n ## Discord Webhook<\/p>\n ModSeeker can send real-time notifications to a Discord channel via webhooks.<\/p>\n **Setup:**
\n1. In your Discord server, go to **Channel Settings \u2192 Integrations \u2192 Webhooks**
\n2. Create a new webhook and copy the URL
\n3. Paste the URL into `config.yml` under `discord.webhookUrl`
\n4. Set `discord.enabled` to `true`
\n5. Toggle individual event types under `discord.events`<\/p>\n **Supported Events:**<\/p>\n | Event | Trigger |
\n|——-|———|
\n| `playerJoin` | Player joins and begins verification |
\n| `modListReceived` | Player’s mod list is successfully received and logged |
\n| `blacklistViolation` | A banned mod is detected \u2014 includes the mod name(s) |
\n| `verificationFailed` | Verification times out or fails for any reason |<\/p>\n All webhook requests run asynchronously on a dedicated thread to avoid impacting server performance.<\/p>\n —<\/p>\n ## Commands<\/p>\n All commands require the `modseeker.use` permission.<\/p>\n | Command | Description |
\n|———|————-|
\n| `\/modseeker seek mod ` | Request and display a player’s mod list |
\n| `\/modseeker status` | Show plugin status, config summary, and verification statistics |
\n| `\/modseeker modblacklist add ` | Add a mod to the blacklist |
\n| `\/modseeker modblacklist remove ` | Remove a mod from the blacklist |
\n| `\/modseeker modblacklist show` | Display all blacklisted mods |
\n| `\/modseeker whitelist add ` | Add a player to the whitelist |
\n| `\/modseeker whitelist remove ` | Remove a player from the whitelist |
\n| `\/modseeker whitelist show` | Display all whitelisted players |
\n| `\/modseeker reload` | Reload all configuration files |<\/p>\n—<\/p>\n ## How It Works<\/p>\n When a player joins the server:<\/p>\n 1. **Whitelist check** \u2014 Whitelisted players are admitted immediately
\n2. **Floodgate check** \u2014 Bedrock players are optionally admitted
\n3. **Presence detection** \u2014 Server waits for the Hidder mod to announce itself (5s timeout)
\n4. **Layer 1** \u2014 Server sends a cryptographic challenge; client must respond with a valid signature
\n5. **Layer 2** \u2014 Server verifies the detected launcher against the launcher whitelist
\n6. **Player freeze** \u2014 Player is frozen in place while Layer 3 runs
\n7. **Layer 3** \u2014 Server requests the encrypted mod list; verifies integrity signature and session binding
\n8. **Blacklist check** \u2014 Mod list is compared against `modblacklist.json`
\n9. **Mod count check** \u2014 If enabled, verifies the mod count is within the threshold
\n10. **Approval** \u2014 Player is unfrozen and admitted with an optional welcome message<\/p>\n If any step fails, the player is kicked with the appropriate configurable message.
\n—
\n## License<\/p>\n This project is licensed under **AGPL-3.0**. See the LICENSE file for details.<\/p>\n","protected":false},"excerpt":{"rendered":" a Minecraft paper server plugin for mod detection<\/p>\n","protected":false},"featured_media":104661,"template":"","meta":{"_minecraft_slug":"modseeker","_minecraft_project_id":"p89Zkpnw","_minecraft_author":"RAFIN-G","_minecraft_license":"AGPL-3.0-or-later","_minecraft_downloads":349,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"modseeker.zip","_minecraft_size_bytes":204592,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T11:26:03.899477Z","_minecraft_date_created":"2025-12-14T00:49:31.904473Z","_minecraft_date_modified":"2026-04-05T06:58:42.776599Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/modseeker","_minecraft_icon_attachment_id":104661,"_minecraft_imported_at":"2026-06-06T00:45:15+00:00","_minecraft_import_hash":"3e76152ac503eec2f8ccf57b212912b9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167],"class_list":["post-104660","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","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"],"yoast_head":"\n ModSeeker - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ModSeeker - Minecraft\" \/>\n<meta property=\"og:description\" content=\"a Minecraft paper server plugin for mod detection\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/\",\"name\":\"ModSeeker - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/modseeker-icon-f52da27a4273d92000847d30e20a6eddf58bc943_96.webp\",\"datePublished\":\"2026-06-06T00:45:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/modseeker-icon-f52da27a4273d92000847d30e20a6eddf58bc943_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/modseeker-icon-f52da27a4273d92000847d30e20a6eddf58bc943_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/modseeker\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ModSeeker\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ModSeeker - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/","og_locale":"en_US","og_type":"article","og_title":"ModSeeker - Minecraft","og_description":"a Minecraft paper server plugin for mod detection","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/","name":"ModSeeker - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/modseeker-icon-f52da27a4273d92000847d30e20a6eddf58bc943_96.webp","datePublished":"2026-06-06T00:45:14+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/modseeker-icon-f52da27a4273d92000847d30e20a6eddf58bc943_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/modseeker-icon-f52da27a4273d92000847d30e20a6eddf58bc943_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/modseeker\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"ModSeeker"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/104660","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/104661"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=104660"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=104660"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=104660"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=104660"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}} |