Hand Shaker

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

🤝 HandShaker 7.0.0 (alpha) Wiki is there!

📋 What is HandShaker?

HandShaker is a cross-platform mod/plugin verification system for Minecraft servers and clients. It enables servers to detect which mods players are running and enforce mod restrictions with customizable policies.

🎯 Core Functionality

• Fabric/Neoforge Client → Sends your active mod list to the server upon join
• Paper/Fabric/NeoForge Server → Validates mod lists against configured rules and enforces restrictions
• Multi-platform Support → Works across Fabric, Paper, and NeoForge
• Cryptographic Integrity → Prevents tampered or self-compiled HandShaker mods
• Flexible Configuration → Per-mod rules: Required, Allowed, or Blacklisted

✨ Key Features

| Feature | Description | | ------------------------------- | ------------------------------------------------------------------- | | 🔐 Per-Mod Configuration | Individually set mod allowance to Required, Allowed, or Blacklisted | | 🚫 Customizable Enforcement | Configurable kick messages and auto-ban capabilities | | 📊 Player History Database | Store and query player mod histories | | 👀 Player Mod Viewing | Administrators can see other players' mod lists | | ✔️ Integrity Verification | Cryptographic signatures prevent spoofed mod reports | | 🔐 Custom Actions | Allows to setup custom events (commands) for triggered mods |

🏗️ Platform Comparison

✅ Supported/Working ⚠️ Issues/Unsupported ❌ Unsupported/Broken

| Features | Paper (1.x - 6.x) | Fabric (2.x - 6.x) | NeoForge (6.x+) | | -------------------------- |:----------------------------:|:-----------------------:|:---------------:| | Integrity Checking | ✅ 6.x+
⚠️ 3.x - 5.x
| ✅ 6.x+
⚠️ 3.x - 5.x | ✅ 6.0.0+ | | Configurable Rules | ✅ 6.0.0+ | ✅ 6.0.0+ | ✅ 6.0.0+ | | Database Storage | ✅ 5.0.0+ | ✅ 5.0.0+ | ✅ 6.0.0+ | | GeyserMC/Floodgate | ✅ 5.2.0+ | ✅ 5.2.0+ | ❌ | | Permissions | ✅ 5.0.0+ | ✅ 5.0.0+ | ❌ | | Folia Compatibility | ✅ 6.0.0+ | ❌ | ❌ | | Clickable text in chat | ✅ | ❌ | ❌ |

🚀 Quick Start

Commands

Installation

1. Download the appropriate mod/plugin for your platform:

• Fabric Client: Place JAR in mods/ folder
• Paper Server: Place JAR in plugins/ folder
• NeoForge Client: Place JAR in mods/ folder

1. Configure the mod/plugin

Basic Configuration

config: v4

# Behavior: "strict" - Force requires client-side mod or "vanilla" allow also non-mod clients
behavior: strict

# Integrity Mode: "signed" or "dev" - allow unsigned mods (if you are building own client/server fork)
integrity-mode: signed

# Whitelist mode: true = only allowed mods (inside whitelisted.yml), false = allowed by default.
# To work properly set "mods-whitelisted-enabled" must be true
whitelist: false

# Allow Bedrock players
allow-bedrock-players: false

# Player Database: Store and track player mod history (requires playerdb to be enabled)
playerdb-enabled: false

# Mod List Toggles: Enable/disable each mod list without losing configuration
mods-required-enabled: true
mods-blacklisted-enabled: true
mods-whitelisted-enabled: true

# Kick Messages - customize as needed (use {mod} for mod name)
messages:
  kick: "You are using a blacklisted mod: {mod}. Please remove it to join this server."
  no-handshake: "To connect to this server please download 'Hand-shaker' mod."
  missing-whitelist: "You are missing required mods: {mod}. Please install them to join this server."
  invalid-signature: "Invalid client signature. Please use the official HandShaker client mod."