All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Trusted Clients

Trusted Clients

by NoahOnFyre • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

Trusted Clients

A lightweight anti-cheat/client-scanning mod which shows client installed mods on the server when a player joins.

How does it work?

When a client connects to the server, the client needs to respond to a certain packet sent by the server. If the client fails to respond, it is deemed as not running the mod and will get disconnected with a message stating that they should install the Trusted Clients mod.

When the client tries to join with the mod installed, it will then get prompted to send a list of mods installed on the client to the server and the server will consequently check whether the mods are compatible with the server configuration set in place by the server admins. If the client has disallowed mods, it will get disconnected with a message on what mods to remove, if the client has no flagged mods, they will be able to join just normally.

What do I have to do?

The mod is fully configurable via the config file located at SERVER_ROOT/config/trustedclients/main.json. From here it depends on what you want:

I want to only allow certain mods

Set the mode to "WHITELIST" and add all client-side mods that you want to allow to the modList. Mods that are already on the server are automatically allowed.

I want to allow all mods except for some

Set the mode to "BLACKLIST" and add all client-side mods that you want to disable. Mods that are already on the server can't be blacklisted.

I (as the server admin) need mods that other players shouldn't use

Use any of the methods described above and add your Username to the bypass list in the config. This will let you bypass the entire check system.

Legacy documentation

Old Version (Forge 1.20.1)

(formerly) EasyAntiCheat

A lightweight and simple, yet powerful AntiCheat tool for Forge, providing server admins with oversight of client-installed mods and resource packs.

⚠️ Disclaimer

This mod isn't intended to act as a defense against skilled hackers. Rather, it's a basic countermeasure aimed at script kiddies and similar low-level threats. It's designed to be simple and not to eliminate the risk of hackers on your server.

How does it work?

This mod works by the client sending the server a list of installed mods and resource packs upon connection. The server will then log all mods and resource packs, that are installed on the client but not on the server. If the functionality is enabled and properly configured via the config, it will also take automatic action when a mod isn't appreciated by the server owners.

What is its purpose?

Its primary purpose is the quick identification of unwanted mods by the server operators through the logging mechanism, but as this is only efficient on small servers, as it needs human oversight, there is also a whitelisting/blacklisting functionality to automate the identification of widespread/known mods or assist the operators.

Configuration

The config file can be found in ./config/ezac-common.toml. All options are described by comments, so you can modify them yourself easily to meet your needs.

Down below, you can find an example config, that uses the WHITELIST mode, which means that only mods in the mods array will be allowed on the server. As mods is left empty though, all client-only mods will be flagged, which means that every mod, that's not on the server, but on the client will be flagged. Allowed resource packs on the server are defined in the resourcePacks list. In this example, only resource packs named "TotallyLegitResourcePack.zip" are allowed on the server. The action is set to RESTRICT which means, that as long as flagged mods are installed on the client, the player won't be able to join, but can join again, after removing said mods.

["Server Configuration"]
    # A list of all mods that should be added to either the blacklist or whitelist.
    mods = []
    # A list of all resource packs that should be added to either the blacklist or whitelist.
    resourcePacks = ["TotallyLegitResourcePack.zip"]
    # How should the mods in the list be treated?
    # BLACKLIST will flag all mods of the client that are in the list.
    # WHITELIST will flag all mods of the client that aren't in the list.
    #Allowed Values: BLACKLIST, WHITELIST
    mode = "WHITELIST"
    # What should be done, when a player uses a flagged mod?
    # NOTIFY will log the flagged mods in the console (and send a message to the operators).
    # RESTRICT will do the same as NOTIFY, but will additionally deny the player everytime they join with a flagged mod.
    # BAN will also do the same as NOTIFY, but is a bit harsher than RESTRICT and will ban the player, so once they joined with a flagged mod, they will never be able to join again, until they are pardoned by an operator.
    # This will only work, when the mode selected is either BLACKLIST or WHITELIST.
    #Allowed Values: NOTIFY, RESTRICT, BAN
    action = "RESTRICT"

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3
Fabric
20d ago 1
26.2
Fabric
20d ago 1
26.2
Fabric
2mo ago 1
1.21.x
Fabric
2mo ago 1
1.21.x
Fabric
2mo ago 1
1.21.x
Fabric
2mo ago 1
1.20.x
Forge
last yr. 1
1.20.x
Forge
last yr. 1
1.20.x
Forge
last yr. 1
1.20.x
Forge
last yr. 1
1.20.x
Forge
last yr. 1
  • Port to 26.3
  • Custom list/collection network implementation as the one I used previously has been removed
  • Fixed a bug where the bypass functionality wouldn't work due to the username of the player not being extracted right
  • Fixed a bug where the bypass functionality wouldn't work due to the username of the player not being extracted right
  • Update to 26.2
  • Features**
  • The config can now be reloaded, meaning the server doesn't has to be offline anymore to apply changes in the config. This was hindered by the fact that the config in memory would override the one on disk.
  • A new /trustedclients command with suboptions to list all mods in the config, add new mods, remove mods and reload the config file to apply changes made on disk

  • Fixes**
  • Fixed a small bug where the mod would print an empty log line when the client joins without any significant mods installed.

  • Info**: When installed on the server, this version should be compatible with all clients that have version v0.4.0 or newer.
  • Lower Fabric Loader version requirement to above 0.18.4
  • This is the first version for Fabric for 1.21.10** and it is a complete rewrite of the Forge version.

  • _Only_ mod scanning capabilities; Resource Packs will probably be added later.
  • Added a bypass-list for server admins

This version is experimental, please report any bugs [here](https://github.com/noahonfyre/trustedclients/issues/new).
[0.3.2] EasyAntiCheat 0.3.2 by NoahOnFyre on Jun 03, 2025
Download
  • Added support for blacklisting/whitelisting resource packs in addition to mods
[0.3.1] EasyAntiCheat 0.3.1 by NoahOnFyre on Apr 19, 2025
Download
  • Some code refactoring
  • Better formatting
  • General information output optimization
[0.3.0] EasyAntiCheat 0.3.0 by NoahOnFyre on Apr 19, 2025
Download
  • Added blacklisting/whitelisting functionality
  • Added config functionality
  • Added reporting system for server operators
  • Added some formatting utils
[0.2.0] EasyAntiCheat 0.2.0 by NoahOnFyre on Apr 10, 2025
Download
  • Added resource pack checking capability
  • Remove player position checker
[0.1.0] EasyAntiCheat 0.1.0 by NoahOnFyre on Apr 10, 2025
Download
Added core functionality
Trusted Clients Icon
Download Trusted Clients
Select game version
Select platform