CraftHub
Hand Shaker

Hand Shaker

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

33 367 downloads 54 followers

⚠️ 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.

No gallery available for this project.

Version Minecraft Loader Download

[NeoForge] 7.0.1 1.21

7.0.1-1.21+NeoForge

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
neoforge
Download

[Fabric] 7.0.1 1.21

7.0.1-1.21+Fabric

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
fabric
Download

[Paper] 7.0.1 1.21

7.0.1-1.21+Paper

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
folia, paper, purpur
Download

[Fabric] 7.0.1 26.1

7.0.1-26.1+Fabric

26.1, 26.1.1, 26.1.2, 26.2, 26.3
fabric
Download

[NeoForge] 7.0.1 26.1

7.0.1-26.1+NeoForge

26.1, 26.1.1, 26.1.2, 26.2, 26.3
neoforge
Download

[Paper] 7.0.0 1.21

7.0.0-1.21+Paper

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2
folia, paper, purpur
Download

[NeoForge] 7.0.0 1.21

7.0.0-1.21+NeoForge

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
neoforge
Download

[Fabric] 7.0.0 1.21

7.0.0-1.21+Fabric

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
fabric
Download

7.0.0+Fabric

26.1, 26.1.1, 26.1.2
fabric
Download

7.0.0+Neoforge

26.1, 26.1.1, 26.1.2
neoforge
Download

[Neo Forge] 6.0.2-1.21.11

6.0.2-1.21.11

1.21.11
neoforge
Download

[Neo Forge] 6.0.2-1.21.x

6.0.2-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
neoforge
Download

[Fabric] 6.0.2-1.21.11

6.0.2-1.21.11

1.21.11
fabric
Download

[Fabric] 6.0.2-1.21.x

6.0.2-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

[Paper] 6.0.2-1.21+

6.0.2-1.21+

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
folia, paper, purpur
Download

[Neo Forge] 6.0.1-1.21.11

6.0.1-1.21.11

1.21.11
neoforge
Download

[Neo Forge] 6.0.1-1.21.x

6.0.1-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
neoforge
Download

[Fabric] 6.0.1-1.21.11

6.0.1-1.21.11

1.21.11
fabric
Download

[Fabric] 6.0.1-1.21.x

6.0.1-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

[Paper] 6.0.1-1.21+

6.0.1-1.21+

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
folia, paper, purpur
Download

[Neo Forge] 6.0.0-1.21.11

6.0.0-1.21.11

1.21.11
neoforge
Download

[Neo Forge] 6.0.0-1.21.x

6.0.0-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
neoforge
Download

[Fabric] 6.0.0-1.21.11

6.0.0-1.21.11

1.21.11
fabric
Download

[Fabric] 6.0.0-1.21.x

6.0.0-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

[Paper] 6.0.0-1.21+

6.0.0-1.21+

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
folia, paper, purpur
Download

[Paper] 5.2.0 - 1.21+

5.2.0-paper

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
paper, purpur
Download

[Client/Server] 5.2.0 - 1.21.1+

5.2.0-1.21.11

1.21.11
fabric
Download

[Client/Server] 5.2.0 - 1.21.6/1.21.10

5.2.0-1.21.10

1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

[Client/Server] 5.2.0 - 1.21.2/1.21.5

5.2.0-1.21.5

1.21.2, 1.21.3, 1.21.4, 1.21.5
fabric
Download

[Client/Server] 5.2.0 - 1.21/1.21.1

5.2.0-1.21.1

1.21, 1.21.1
fabric
Download

[Client Only] 1.21/1.21.11

Client-5.1.1

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
fabric
Download

[Client & Server] 5.1.0 - 1.21.11

5.1.0-1.21.11

1.21.11
fabric
Download

[Client & Server] 5.1.0 - 1.21.6/1.21.10

5.1.0-1.21.10

1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

[Client & Server] 5.1.0-1.21.2/1.21.5

5.1.0-1.21.5

1.21.2, 1.21.3, 1.21.4, 1.21.5
fabric
Download

[Client & Server] 5.1.0 - 1.21/1.21.1

5.1.0-1.21.1

1.21, 1.21.1
fabric
Download

[Fabric Client and Server] Hand Shaker 5.1.0 1.21.6-1.21.10

fabric-5.1.0-1.21.6-1.21.10

1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

[Fabric Client and Server] Hand Shaker 5.1.0 1.21-1.21.5

fabric-5.1.0-1.21-1.21.5

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
fabric
Download

[Paper] Hand Shaker 5.1.0-1.21+

Paper-5.1.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
paper, purpur
Download

[Paper, Fabric Client and Server] 5.1.0-1.21.11

5.1.0-1.21.11

1.21.11
fabric, paper, purpur
Download

5.1.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper, purpur
Download

Hand Shaker 5.0.0-1.21.11 (Fabric server)

5.0.0-1.21.11

1.21.11
fabric, paper
Download

Hand Shaker 5.0.0-1.21

5.0.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 4.1.2-1.21

4.1.2-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 4.1.1-1.21

4.1.1-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 4.1.0-1.21

4.1.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 4.0.0-1.21.x (Universal)

4.0.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 4.0.0-1.21.x (Fabric)

4.0.0-1.21-fabric

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

Hand Shaker 4.0.0-1.21.x (Paper)

4.0.0-1.21-paper

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
paper
Download

Hand Shaker 3.0.0-1.21.x (Universal)

3.0.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 3.0.0-1.21.x (Fabric)

3.0.0-1.21-fabric

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

Hand Shaker 3.0.0-1.21.x (Paper)

3.0.0-1.21-paper

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
paper
Download

Hand Shaker 2.0.0-1.21 (Universal)

2.0.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric, paper
Download

Hand Shaker 2.0.0-1.21 (Fabric)

2.0.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

Hand Shaker 2.0.0-1.21.x (Paper)

2.0.0-1.21

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
paper
Download

Hand Shaker 1.0.0 - 1.21.x (Fabric)

1.0.0-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
fabric
Download

Hand Shaker 1.0.0 - 1.21.x (Paper)

1.0.0-1.21.x

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
paper
Download

Hand Shaker 1.0.0 - 1.21.10 (Fabric)

1.0.0-1.21.10

1.21.10
fabric
Download

Hand Shaker 1.0.0 - 1.21.9 paper

1.0.0

1.21.9
paper
Download

Hand Shaker 1.0.0 - 1.21.9

1.0.0

1.21.9
fabric
Download

Hand Shaker 1.0.0 plugin

1.0.0

1.21.8
paper
Download

Hand Shaker 1.0.0 for 1.21.8

1.0.0

1.21.8
fabric
Download