⚠️ This project requires to be set up on both sides, client and server side ⚠️

HandShaker 5.0.0

HandShaker is a cross-platform mod/plugin system for Minecraft servers and clients.
It lets Paper/Fabric servers see which Fabric mods players are using, and automatically enforce a blacklist with customizable kick messages. Wiki is there!

• Fabric mod: Sends your mod list to the server when you join.
• Fabric/Paper plugin: Checks mod lists against a blacklist and kicks players using forbidden mods.

Features

• Per mod configuration: Individualy set mod allowance to Required, Allowed or Blacklisted
• Fabric client <-> Paper/Fabric server
• Configurable kick & Missing mod messages
• Integrity: Prevents self-compiled hand-shaker mods from being used
• See other player mods: Allows to See/Blacklist/Allow other player mods
• Store player mods into db
• Insta-ban users for using any mod

Installation

Universal (Fabric Client, Fabric server, Paper)

1. Download Hand Shaker <version> (Universal).
2. Place it in your mods folder or plugin folder.
3. If server, start server once to generate config file and edit it.

Configuration

Example of default hand-shaker.json for servers:

{
  "config": "v3",
  "Integrity": "Signed",
  "Behavior": "Strict",
  "Invalid signature kick message": "Invalid client signature. Please use the official client.",
  "Kick Message": "You are using a blacklisted mod: {mod}. Please remove it to join this server.",
  "Missing mod message": "To connect to this server please download \u0027Hand-shaker\u0027 mod.",
  "Missing required mod message": "You are missing required mods: {mod}. Please install them to join this server.",
  "Default Mode": "allowed",
  "Ignored Mods": [
    "fabric-api"
  ],
  "Mods": {
    "hand-shaker": {
      "mode": "REQUIRED",
      "action": "kick"
    },
    "xraymod": {
      "mode": "BLACKLISTED",
      "action": "kick"
    },
    "testmod": {
      "mode": "BLACKLISTED",
      "action": "kick"
    },
    "forge": {
      "mode": "BLACKLISTED",
      "action": "kick"
    }
  }
}

• {mod} in Kick Message will be replaced with the actual mod(s) found.

Commands

Permissions

• handshaker.bypass — Bypasses restrictions
• handshaker.admin — Required for all /handshaker commands (ops have this by default).