Back to mods
Hand Shaker project artwork

Modrinth · Minecraft mod

Hand Shaker

Solution for server owners or modpack developers to disconnect users with unwanted mods, allow or require mods

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Hand Shaker release matches Fabric?

Updated 2 days ago
Best match for your filters 7.0.1-1.21+Fabric
Game version 1.21, 1.21.1, 1.21.10
Loader Fabric

Hand Shaker 7.0.1-1.21+Fabric targets 1.21, 1.21.1, 1.21.10 with Fabric. Installation on the client is optional. Installation on the dedicated server is optional. All 1 required mods have matching files.

Where it goes

Is Hand Shaker required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does Hand Shaker 7.0.1-1.21+Fabric need?

7.0.1-1.21+Fabric on Fabric. Every mod below is checked against that same setup.

All 1 required mods have matching files

Install HandLib first. We found matching files for this game-version and loader setup.

HandLib Needed by Hand Shaker 7.0.1-1.21+Fabric
required
Matching file found Matched file: 0.0.3+mc1.21.11

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Hand Shaker without breaking your instance.

Built for Hand Shaker 7.0.1-1.21+Fabric on Fabric. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 7.0.1-1.21+Fabric. It targets 1.21, 1.21.1, 1.21.10 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install HandLib first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 7.0.1-1.21+Fabric. It opens that exact file at the source.

About this project

What does Hand Shaker add?

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

🤝 HandShaker 7.0.0 (alpha) Wiki is there!

Modrinth
CurseForge
Paper
Purpur
Wiki
Ko-fi
Fabric API
Neo Forge


📋 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
  2. 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."

  ban: "You have been banned for using a blacklisted mod: {mod}."
  bedrock: "Bedrock players are not allowed on this server."
  # custom messages for actions can be added here
  # placeholders are {mod} - mod which triggered, {player}
  test_action: "Hi, {player}! You are using {mod}! Thanks for using it!"

actions:
# System actions (Uses hardcoded functions, not recomended to copy these)
  kick:
    commands:
      - "kick {player} {messages.kick}"

  ban:
    commands:
      - "ban {player} {messages.ban}"
    log: true
    
  log:
    missing: "{player} tried to join but missing required mod/mods: {mod}"
    blacklisted: "{player} tried to join with blacklisted mod/mods: {mod}"

# Examples of custom actions
# placeholders are {mod} - mod which triggered, {player}, {messages.name_from_config.yml}

  test_action:
    commands:
      - "msg {player} {messages.test_action}"
      - "give {player} minecraft:diamond 1"
      - "say Say Hello to {player}, who is using {mod}!"

  watchdog:
    commands:
      - "ac increase_alert_level {player} 1000"


📝 Permissions

Permission Description Default
handshaker.admin Access to admin commands Operator
handshaker.bypass Bypass mod restrictions False

🎮 Supported Versions

Loader Versions Status Versions Status
Fabric 1.21 - 1.21.10, 1.21.11 ✅ Supported N/A N/A
Paper 1.21+ ✅ Supported N/A N/A
NeoForge 1.21 - 1.21.10, 1.21.11 ✅ Supported 1.20.1 Planned

📚 Documentation


Roadmap

  • More QoL features

🤝 Contributing

Issues, pull requests, and suggestions are welcome! Check the GitHub repository for contribution guidelines.

Project description from Modrinth.

Pick your setup

Hand Shaker by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

51 available setups

Showing the newest 12 of 17 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Hand Shaker versions and loaders

38 of 62 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.