ModBlocker 1.0

Name: ModBlocker
SKU: /p/9423
Availability: InStock

Restrict which mods are allowed on your server.

Overview Reviews Updates Materials

ModBlocker
Restrict which mods are allowed on your server.

📌 Overview
ModBlocker is a lightweight yet powerful Paper plugin that gives server administrators full control over which client-side mods players are allowed to use. Whether you're running a competitive PvP server, an RPG experience, or a vanilla-faithful community, ModBlocker ensures a fair and consistent environment for all players.

⚙️ Features

Mod Detection — Detects client modifications via channel-based handshake inspection (e.g. wurst:init → identifies the wurst client)
Blacklist & Whitelist Modes — Choose between blocking specific mods outright or only allowing an approved list via use-whitelist-mode
Per-Permission Bypass — Grant trusted players or staff the ability to bypass restrictions using the modblocker.bypass permission node
Custom Kick Messages — Define fully customizable kick messages using MiniMessage format with {player} and {mods} placeholders
Configurable Check Delay — Adjustable tick delay before channel inspection on join, since mod channels aren't registered instantly
Debug Mode — Enable debug logging to see all registered player channels in the console
Reload Support — Reload configuration at runtime without restarting the server via /modblocker reload

🔧 Commands

/modblocker list	Displays all currently blocked or whitelisted mods depending on the active mode	modblocker.admin
/modblocker check	Checks what mods a connected player has registered	modblocker.admin
/modblocker add	Adds a mod to the active blacklist or whitelist at runtime	modblocker.admin
/modblocker remove	Removes a mod from the active blacklist or whitelist at runtime	modblocker.admin
/modblocker reload	Reloads the plugin configuration from disk	modblocker.admin

🔑 Permissions

modblocker.admin	Grants access to all ModBlocker commands (list, check, add, remove, reload)	OP
modblocker.bypass	Bypasses all mod restrictions — useful for trusted players or staff	false

📄 Configuration


# ============================================================
#  ModBlocker — Configuration
#  Block players from joining with certain client mods
# ============================================================
settings:
  # Delay (in ticks) before checking a player's channels after join.
  # 40 ticks (2 seconds) is recommended — channels aren't registered instantly.
  check-delay-ticks: 40
  # Whitelist mode: if true, only mods in 'whitelisted-mods' are allowed.
  # If false, only mods in 'blocked-mods' are blocked (blacklist mode).
  use-whitelist-mode: false
  # Enable debug logging to see all registered channels in console
  debug: false

# Blacklist mode — common hack client IDs:
blocked-mods:
  - wurst
  - meteor-client
  - inertia
  - aristois
  - kami
  - lambda
  - xray
  - killaura

# Whitelist mode — only these mods are allowed (minecraft/paper/bukkit always allowed)
whitelisted-mods:
  - fabric
  - optifine
  - sodium
  - lithium
  - iris

# Messages — MiniMessage format | Placeholders: {player}, {mods}
messages:
  kick-message: |
    ModBlocker
    
    Unauthorized mods detected:
    {mods}
    
    Please remove them before joining.
  no-permission: "You don't have permission to use this command."