Mods / FairPlayGuardian

Category: #Utility
Author: Th3Dilli
Side: Both
Created: May 8th 2023 at 9:17 PM
Last modified: Feb 2nd at 4:18 PM
Downloads: 15945
Follow Unfollow 22

Latest file for v1.19.3: 1-click install


What is this mod about?

This mod adds the ability for server admins to restrict the usage of client side mods.
Be aware this can't and wont stop every cheat possible but "most".



If you want to enable other version of the game to join the server you need to add them to the allowlist.


Vintagestory modblacklist

Fairplayguardian not required

If you just need to block certain mods only you can make use of the games feature to do so. That will prevent clients from loading mods listed in the blacklist. You can blacklist mods without this mod by adding the mods you want to block to the serverconfig.json.

"ModIdBlackList": [ "modid" ],
// multiple
"ModIdBlackList": [ "modid1", "modid2" ],

If you need more control then FairPlayGuardian is for you.


  • Block/Allow specific client mods
  • check integrity of mods using SHA256 hash sum
  • look for Harmony patches


Commands: (admin)

  • .fpg list
  • .fpg addall allow
  • .fpg add allow fairplayguardian
  • .fpg add block somemodid
If you use the commands `add` or `addall` make sure to todo `/autosavenow` so it saves the changes to the config file so you can see it.

For help, discussion or suggestions join the Discord Server


For further info see Gitlab Readme

Version For Game version Downloads Release date Changelog Download 1-click mod install*
v1.1.7 6469 Feb 2nd at 4:18 PM Show Install now
v1.1.6 242 Feb 2nd at 12:11 PM Show Install now
v1.1.5 1492 Dec 18th 2023 at 10:01 PM Show Install now
v1.1.4 953 Oct 28th 2023 at 7:37 PM Show Install now
v1.1.3 3627 Aug 9th 2023 at 8:46 PM Show Install now
v1.1.2 2558 May 15th 2023 at 10:34 AM Show Install now
v1.1.1 235 May 12th 2023 at 5:02 PM Show Install now
v1.1.0 216 May 10th 2023 at 10:16 AM Show Install now
v1.0.0 153 May 9th 2023 at 9:35 PM Show Install now

12 Comments (oldest first | newest first)

💬 Bazim, Apr 4th at 7:35 PM

For a public server, this is a must have. Thank you for it!

💬 Th3DilliAuthor, Dec 27th 2023 at 8:23 PM


This mod only check and verify's mods (so the client does not use unwanted mods) it does not do anything with downloading mods from moddb and will never


💬 Mohandar, Dec 24th 2023 at 1:48 AM

does it as well  force-downloads for those mods? (it would be so nice, where for example some mod have some trouble being downloaded by the vanilla game)

💬 Nicodemus, Nov 30th 2023 at 4:09 PM


Well, if you join a server and your "client side business" has an impact on other players (on their potential resources, for example...), then yes, it's logic that admins should have the right not to allow it. Maybe try to think of others next time plz.

💬 Th3DilliAuthor, Sep 2nd 2023 at 10:52 AM


that is what the mod is for to restrict mods from the server side, you should be able to customize the configuration and then it should be able to detect mods that are unwanted and kick players for it if set to do so

💬 IKira, Sep 1st 2023 at 11:18 PM

Can you update to like, stop Xel Xray Mod?

💬 ValidUser, Aug 10th 2023 at 1:27 AM

Oh yay another nanny-net addition. What we do on the client-side is our buisness and NOONE EVER has the right to try and control that REGARDLESS of your intent. Major -respect for this one.

💬 Rythillian, May 13th 2023 at 5:38 AM

Ah I see, thanks for explanation. Sounds very handy then as an extra layer of server protection!

💬 Th3DilliAuthor, May 10th 2023 at 7:20 PM

it can do integrity checks using hashes and it has more options to configure it
you can configure if you wanna accept additional mods or not in vanilla it always accepts additional you can just block specific ones

but if all you need is to block only a few specific mods then sure i would recommend you to use the inbuild feature

💬 Rythillian, May 10th 2023 at 7:16 PM

How is this different from the "Tweak: Added ability for server owners to blacklist client side mods. Add "ModIdBlackList": ["modid1","modid2"], to server config." added in rc-3/4?

💬 Nicodemus, May 10th 2023 at 2:50 AM

\o/ Yep, thanks a lot!

💬 Teknik, May 10th 2023 at 1:31 AM

Awesome dude ! Thanks

(edit comment delete)