ForgeModBlocker

What is it?

ForgeModBlocker is a configurable plugin allowing you to allow or disallow the use of certain Forge mods on your Spigot server. This is the first fully customisable and completely free plugin of its kind.

Dependencies

ForgeModBlocker no longer requires any plugin dependencies in order to run!

ForgeModBlocker does however require at least Java 8 to run. If you are still on Java 7, now is the time to update (or ask your host to)!

Config

Here is the current config file for the plugin:


If there is an update which makes additions to the config, you will need to delete your config file upon installing the update. It will be regenerated with the new options.

Blocking Mods

To add a mod to the mods list in the config, you must find its mod ID. You can do this by opening Forge with the mod installed, clicking "Mods" on the title screen, finding the mod and looking at the "Mod ID" field:
Mod IDs are case sensitive


There are also some hacked clients which work through acting as Forge mods. If you add any these mods to the config, you can reliably ban for them.

Features

- Configurable:
Choose as many mods as you like to whitelist or blacklist and deicde what happens when a player uses disallowed mods.

- Lightweight:
ForgeModBlocker won't have any impact on your server performance.

- Cross-Version Compatible:
ForgeModBlocker will work on all Spigot versions 1.8.8 and above, and will most likely automatically support any future versions.

Versions lower than 1.8.8 are not supported and there are no plans to ever support them.

- Free:
Unlike any other Forge mod detector out there (at the time of release), this is the only fully configurable and customisable Forge mod blocker where all functions are available for free!

Commands and Permissions

/fmb
Main command, shows the mod version and lists subcommands.
Permission: fmb.main_command

/fmb reload
Reloads the plugin
Permission: fmb.reload_command

/mods <player>
Lists a player's loaded mods
Permission: fmb.mods_command

Other Permissions

fmb.*
Gives all plugin permissions
This permission is not given to opped players by default

fmb.update_notification
Players with this permission will receive notifications for available plugin updates

fmb.bypass
Users with this permission will be exempt from the mod whitelist/blacklist
This permission is not given to opped players by default

Additional Notes

ForgeModBlocker uses an auto-update system to keep you up-to-date on the latest plugin version without having to do anything! Players with the "fmb.update_notification" permission will be alerted when a new update is available and the plugin will attempt to download it.

If a plugin update cannot be downloaded, the plugin will re-attempt the download twice before giving up. Players with permission will be given an alert informing them that a new version is available.

The plugin also uses bStats to record metrics about servers the plugin is run on. Information such as your server IP is not recorded.
If you really don't want to contribute metrics from your server, you can disable them by opening the /plugins/bStats/config.yml file and setting "enabled" to false.

After a player joins, there will be a small delay before their mods are detected and the commands are executed upon them (if needed). Unfortunately, it just isn't possible to completely remove this delay and still detect the player's mods.

Finally, although ForgeModBlocker will detect a user's mods with 100% accuracy in the common scenario - it is possible to bypass the system in multiple ways which cannot be prevented.

PlaceholderAPI

As well as all the above, ForgeModBlocker can hook into PlaceholderAPI if it is installed on your server.
Placeholders are registered under the "forgemodblocker" id.
Usable placeholders:
- forge: Whether a player is using forge - Returns "true" or "false"
- mods: All the mods a player is using - Eg: FML, mcp, Forge

Future Features

• Developer API
  
  If you have any ideas for any new features for ForgeModBlocker, please suggest them either in the "Discussion" tab or in a review.

Source Code & License

The source code for this project can be found on my GitHub:
https://github.com/Mas281/ForgeModBlocker

Any code issues/suggestions should be made with Issues or Pull Requests.