Mod Whitelist

Quick rating

Community listing page, reviews here may not be monitored by the author.

Mod Whitelist

No reviews yet

A security mod that prevents players entering the server if modlist not matches

No Theme
No Genre
QoL & Tweaks
Server Utility
Mod Loaders
Forge
Fabric
Minecraft

Community voices

Reviews

List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Show per page
10
25
50
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Where It Runs
Either Side, Better on Both

Works on the client or the server alone, but does more when on both.

About

Project Details

Type
Mod
License
MIT License
Latest Version
ModWhitelist v1.2.0 Fabric

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

Abstract

Thank you for choosing our Mod Whitelist mod to protect your server from client hacking mods. Let me introduce how it works and what you can do.

This mod works on client and server separately:

  • On the client side, it gathers all identifier of mods ("mod_id"s), encrypted them and send to the server.
  • On the server side, it checks players who try to connect the server if they install hacking mods, or if they do not install any necessary mods to avoid problems.

But both sides are required. If not:

  • Installed on the client side but not installed on the server side. The client player can still enter the server and play, but this mod can not protect your server from hacking.
  • Installed on the server side but not installed on the client side. The client player is not allowed to enter the server and sent message "multiplayer.disconnect.mod_whitelist.packet_corruption".

Adding a mod to whitelist and blacklist

The config file is in "<server directory>/config/mod_whitelist-config.json". If you want to add mods to the whitelist or blacklist, please read the following guides.

First, you should find the identifier of the mod (modid), a simple way is open the jar file with an archiver software (eg. WinZip, HaoZip, 7-Zip), open "fabric.mod.json" and see what the value of key "id" is. For example, the modid of Mod Whitelist mod is "mod_whitelist".

Then, add it to CLIENT_MOD_NECESSARY field if you want client players install it. By default, it is blacklist mode, so you can add it to CLIENT_MOD_BLACKLIST field if you do not want client players install it. If you want to use whitelist mode instead, set USE_WHITELIST_ONLY to true and add all whitelist modids to CLIENT_MOD_WHITELIST field.

In addition, if USE_WHITELIST_ONLY is true, CLIENT_MOD_BLACKLIST field is just ignored while running the server. And if USE_WHITELIST_ONLY is true, CLIENT_MOD_WHITELIST field is ignored instead.

As you might see, if fabric-api is installed, the modlist will contains quite a lot of modids. You can run a client with this mod installed, and open ".minecraft/logs/latest.log", and you will see the following format line to simplify gathering the modlist manually:

Mod Whitelist vx.x.x from the client! Modlist: ["fabric-api", "fabric-api-base", ...]

Issue tracker

Visit https://github.com/Viola-Siemens/Mod-Whitelist/issues and post your issue and logs if you find any problems with this mod.

Abstract

Thank you for choosing our Mod Whitelist mod to protect your server from client hacking mods. Let me introduce how it works and what you can do.

This mod works on client and server separately:

  • On the client side, it gathers all identifier of mods ("mod_id"s), encrypted them and send to the server.
  • On the server side, it checks players who try to connect the server if they install hacking mods, or if they do not install any necessary mods to avoid problems.

But both sides are required. If not:

  • Installed on the client side but not installed on the server side. The client player can still enter the server and play, but this mod can not protect your server from hacking.
  • Installed on the server side but not installed on the client side. The client player is not allowed to enter the server and sent message "multiplayer.disconnect.mod_whitelist.packet_corruption".

Adding a mod to whitelist and blacklist

The config file is in "<server directory>/config/mod_whitelist-config.json". If you want to add mods to the whitelist or blacklist, please read the following guides.

First, you should find the identifier of the mod (modid), a simple way is open the jar file with an archiver software (eg. WinZip, HaoZip, 7-Zip), open "fabric.mod.json" and see what the value of key "id" is. For example, the modid of Mod Whitelist mod is "mod_whitelist".

Then, add it to CLIENT_MOD_NECESSARY field if you want client players install it. By default, it is blacklist mode, so you can add it to CLIENT_MOD_BLACKLIST field if you do not want client players install it. If you want to use whitelist mode instead, set USE_WHITELIST_ONLY to true and add all whitelist modids to CLIENT_MOD_WHITELIST field.

In addition, if USE_WHITELIST_ONLY is true, CLIENT_MOD_BLACKLIST field is just ignored while running the server. And if USE_WHITELIST_ONLY is true, CLIENT_MOD_WHITELIST field is ignored instead.

As you might see, if fabric-api is installed, the modlist will contains quite a lot of modids. You can run a client with this mod installed, and open ".minecraft/logs/latest.log", and you will see the following format line to simplify gathering the modlist manually:

Mod Whitelist vx.x.x from the client! Modlist: ["fabric-api", "fabric-api-base", ...]

Issue tracker

Visit https://github.com/Viola-Siemens/Mod-Whitelist/issues and post your issue and logs if you find any problems with this mod.

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
1
In stacks

By the numbers

Statistics

~260,000
Total Downloads
CurseForge
~200,000
Modrinth
~58,000
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works