promotional bannermobile promotional banner

Mod Whitelist Forge NeoForge

Checks the client's mod list on login and kicks if disallowed mods are present or required mods are missing.

File Details

modwhitelist-1.20.1-3.0.0.jar

  • R
  • Apr 18, 2026
  • 46.67 KB
  • 215
  • 1.20.1
  • Forge

File Name

modwhitelist-1.20.1-3.0.0.jar

Supported Versions

  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:mod-whitelist-forgeneoforge-1337933:7943119")
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

Modwhitelist v3.0.0

✨ Feature

  • Split the config into multiple files for better structure and easier maintenance:
  • settings.json
  • both_side_required.json
  • client_required.json
  • client_optional.json
  • server_only.json
  • deny.json

🔧 Improvement

  • Added a new collect mode workflow to automatically classify:
  • both-side required mods
  • client-optional mods
  • server-only mods
  • Improved overall config clarity for server admins
  • client_required.json is now intentionally kept manual, so admins can decide which client-only mods are truly required
  • Added support for denied files in addition to denied mod IDs

🐛 Fix

  • Improved kick messages with colored formatting for better readability
  • Kick messages are now much clearer when mods or files are missing, denied, or not allowed
  • Fixed command structure by simplifying collect mode usage

📁 File/Project structure

  • Moved from a single modwhitelist.json to a structured multi-file config folder:
    • config/modwhitelist/

⚙️ Compatibility

  • Added automatic legacy migration from the old single-file config to the new multi-file structure

Commands

  • /modwhitelist reload
  • /modwhitelist init
  • /modwhitelist collect on
  • /modwhitelist collect off
  • /modwhitelist collect clear

Notes

  • Old configs are migrated automatically on first start
  • Auto-collect writes to:
    • both_side_required.json
    • client_optional.json
    • server_only.json
  • client_required.json must be adjusted manually if you want certain client-only mods to be mandatory