Hand Shaker

Modrinth

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

33.7K downloads55 followersUpdated 5mo ago

7.0.1-1.21+NeoForge · MC 1.21.11 · Neoforge

Files

7.0.1-1.21+NeoForge
release
[NeoForge] 7.0.1 1.21
1.21.111.21.101.21.91.21.8+8neoforge
2026-05-19 · 1.1K downloads
hand_shaker-neo-7.0.1-1.21.jar · 3.3 MB
7.0.1-1.21+Fabric
release
[Fabric] 7.0.1 1.21
1.21.111.21.101.21.91.21.8+8fabric
2026-05-19 · 5.4K downloads
hand-shaker-fabric-7.0.1-1.21-s.jar · 3.4 MB
7.0.1-1.21+Paper
release
[Paper] 7.0.1 1.21
26.326.226.1.226.1.1+13foliapaperpurpur
2026-05-19 · 1.3K downloads
hand-shaker-paper-7.0.1-1.21+.jar · 549 KB
7.0.1-26.1+Fabric
release
[Fabric] 7.0.1 26.1
26.326.226.1.226.1.1+1fabric
2026-05-19 · 2.4K downloads
hand-shaker-fabric-7.0.1-26.1-s.jar · 3.4 MB
7.0.1-26.1+NeoForge
release
[NeoForge] 7.0.1 26.1
26.326.226.1.226.1.1+1neoforge
2026-05-19 · 266 downloads
hand_shaker-neo-7.0.1-26.1.jar · 3.3 MB
7.0.0-1.21+Paper
alpha
[Paper] 7.0.0 1.21
26.1.226.1.126.11.21.11+11foliapaperpurpur
2026-03-30 · 283 downloads
hand-shaker-paper-7.0.0-1.21+.jar · 511 KB
7.0.0-1.21+NeoForge
alpha
[NeoForge] 7.0.0 1.21
1.21.111.21.101.21.91.21.8+8neoforge
2026-03-30 · 117 downloads
hand_shaker-neo-7.0.0-1.21.jar · 3.3 MB
7.0.0-1.21+Fabric
alpha
[Fabric] 7.0.0 1.21
1.21.111.21.101.21.91.21.8+8fabric
2026-03-30 · 1.1K downloads
hand-shaker-fabric-7.0.0-1.21-s.jar · 3.4 MB
7.0.0+Fabric
alpha
7.0.0+Fabric
26.1.226.1.126.1fabric
2026-03-30 · 210 downloads
hand-shaker-fabric-7.0.0-26.1-s.jar · 3.4 MB
7.0.0+Neoforge
alpha
7.0.0+Neoforge
26.1.226.1.126.1neoforge
2026-03-30 · 61 downloads
hand_shaker-neo-7.0.0-26.1.jar · 3.3 MB
6.0.2-1.21.11
beta
[Neo Forge] 6.0.2-1.21.11
1.21.11neoforge
2026-02-28 · 125 downloads
hand-shaker-neo-6.0.2-21.11.jar · 3.1 MB
6.0.2-1.21.x
beta
[Neo Forge] 6.0.2-1.21.x
1.21.101.21.91.21.81.21.7+7neoforge
2026-02-28 · 1.5K downloads
hand-shaker-neo-6.0.2.jar · 3.1 MB
6.0.2-1.21.11
beta
[Fabric] 6.0.2-1.21.11
1.21.11fabric
2026-02-28 · 1.1K downloads
hand-shaker-fabric-6.0.2-21.11-s.jar · 3.1 MB
6.0.2-1.21.x
beta
[Fabric] 6.0.2-1.21.x
1.21.101.21.91.21.81.21.7+7fabric
2026-02-28 · 1.5K downloads
hand-shaker-fabric-6.0.2-universal-s.jar · 3.1 MB
6.0.2-1.21+
beta
[Paper] 6.0.2-1.21+
1.21.111.21.101.21.91.21.8+8foliapaperpurpur
2026-02-28 · 178 downloads
hand-shaker-paper-6.0.2-1.21+.jar · 245 KB
6.0.1-1.21.11
beta
[Neo Forge] 6.0.1-1.21.11
1.21.11neoforge
2026-02-24 · 63 downloads
hand-shaker-neo-6.0.1-21.11.jar · 3.1 MB
6.0.1-1.21.x
beta
[Neo Forge] 6.0.1-1.21.x
1.21.101.21.91.21.81.21.7+7neoforge
2026-02-24 · 90 downloads
hand-shaker-neo-6.0.1.jar · 3.1 MB
6.0.1-1.21.11
beta
[Fabric] 6.0.1-1.21.11
1.21.11fabric
2026-02-24 · 135 downloads
hand-shaker-fabric-6.0.1-21.11-s.jar · 3.1 MB
6.0.1-1.21.x
beta
[Fabric] 6.0.1-1.21.x
1.21.101.21.91.21.81.21.7+7fabric
2026-02-24 · 118 downloads
hand-shaker-fabric-6.0.1-universal-s.jar · 3.1 MB
6.0.1-1.21+
beta
[Paper] 6.0.1-1.21+
1.21.111.21.101.21.91.21.8+8foliapaperpurpur
2026-02-24 · 62 downloads
hand-shaker-paper-6.0.1-1.21+.jar · 245 KB
6.0.0-1.21.11
alpha
[Neo Forge] 6.0.0-1.21.11
1.21.11neoforge
2026-02-06 · 79 downloads
hand-shaker-neo-6.0.0-21.11.jar · 3.1 MB
6.0.0-1.21.x
alpha
[Neo Forge] 6.0.0-1.21.x
1.21.101.21.91.21.81.21.7+7neoforge
2026-02-06 · 43 downloads
hand-shaker-neo-6.0.0.jar · 3.1 MB
6.0.0-1.21.11
alpha
[Fabric] 6.0.0-1.21.11
1.21.11fabric
2026-02-06 · 1.6K downloads
hand-shaker-fabric-6.0.0-21.11-s.jar · 3.1 MB
6.0.0-1.21.x
alpha
[Fabric] 6.0.0-1.21.x
1.21.101.21.91.21.81.21.7+7fabric
2026-02-06 · 9.9K downloads
hand-shaker-fabric-6.0.0-s.jar · 3.1 MB
6.0.0-1.21+
alpha
[Paper] 6.0.0-1.21+
1.21.111.21.101.21.91.21.8+8foliapaperpurpur
2026-02-06 · 51 downloads
hand-shaker-paper-6.0.0-1.21+.jar · 245 KB
5.2.0-paper
beta
[Paper] 5.2.0 - 1.21+
1.21.111.21.101.21.91.21.8+8paperpurpur
2026-01-14 · 58 downloads
hand-shaker-paper-5.2.0-1.21+.jar · 207 KB
5.2.0-1.21.11
beta
[Client/Server] 5.2.0 - 1.21.1+
1.21.11fabric
2026-01-14 · 753 downloads
hand-shaker-fabric-1.21.11-5.2.0-signed.jar · 14 MB
5.2.0-1.21.10
beta
[Client/Server] 5.2.0 - 1.21.6/1.21.10
1.21.101.21.91.21.81.21.7+1fabric
2026-01-14 · 168 downloads
hand-shaker-fabric-1.21.10-5.2.0-signed.jar · 14 MB
5.2.0-1.21.5
beta
[Client/Server] 5.2.0 - 1.21.2/1.21.5
1.21.51.21.41.21.31.21.2fabric
2026-01-14 · 50 downloads
hand-shaker-fabric-1.21.5-5.2.0-signed.jar · 14 MB
5.2.0-1.21.1
beta
[Client/Server] 5.2.0 - 1.21/1.21.1
1.21.11.21fabric
2026-01-14 · 191 downloads
hand-shaker-fabric-1.21.1-5.2.0-signed.jar · 14 MB
Client-5.1.1
alpha
[Client Only] 1.21/1.21.11
1.21.111.21.101.21.91.21.8+8fabric
2026-01-14 · 63 downloads
hand-shaker-fabric-client-5.1.1-signed.jar · 185 KB
5.1.0-1.21.11
alpha
[Client & Server] 5.1.0 - 1.21.11
1.21.11fabric
2026-01-06 · 110 downloads
hand-shaker-fabric-1.21.11-5.1.0-signed.jar · 14 MB
5.1.0-1.21.10
release
[Client & Server] 5.1.0 - 1.21.6/1.21.10
1.21.101.21.91.21.81.21.7+1fabric
2026-01-06 · 136 downloads
hand-shaker-fabric-1.21.10-5.1.0-signed.jar · 14 MB
5.1.0-1.21.5
release
[Client & Server] 5.1.0-1.21.2/1.21.5
1.21.51.21.41.21.31.21.2fabric
2026-01-06 · 42 downloads
hand-shaker-fabric-1.21.5-5.1.0-signed.jar · 14 MB
5.1.0-1.21.1
release
[Client & Server] 5.1.0 - 1.21/1.21.1
1.21.11.21fabric
2026-01-04 · 106 downloads
hand-shaker-fabric-5.1.0-1.21-signed.jar · 14 MB
fabric-5.1.0-1.21.6-1.21.10
alpha
[Fabric Client and Server] Hand Shaker 5.1.0 1.21.6-1.21.10
1.21.101.21.91.21.81.21.7+1fabric
2025-12-31 · 79 downloads
hand-shaker-fabric-5.1.0-1.21.10-signed.jar · 14 MB
fabric-5.1.0-1.21-1.21.5
alpha
[Fabric Client and Server] Hand Shaker 5.1.0 1.21-1.21.5
1.21.51.21.41.21.31.21.2+2fabric
2025-12-31 · 291 downloads
hand-shaker-fabric-5.1.0-1.21.5-signed.jar · 14 MB
Paper-5.1.0-1.21
release
[Paper] Hand Shaker 5.1.0-1.21+
1.21.111.21.101.21.91.21.8+8paperpurpur
2025-12-31 · 296 downloads
hand-shaker-paper-5.1.0-1.21+.jar · 205 KB
5.1.0-1.21.11
release
[Paper, Fabric Client and Server] 5.1.0-1.21.11
1.21.11fabricpaperpurpur
2025-12-21 · 626 downloads
hand-shaker-5.1.0-1.21.11-fixed.jar · 14 MB
5.1.0-1.21
beta
5.1.0-1.21
1.21.101.21.91.21.81.21.7+7fabricpaperpurpur
2025-12-21 · 558 downloads
hand-shaker-5.1.0-1.21-fixed.jar · 14 MB
5.0.0-1.21.11
release
Hand Shaker 5.0.0-1.21.11 (Fabric server)
1.21.11fabricpaper
2025-12-12 · 108 downloads
hand-shaker-merged-5.0.0-1.21.11.jar · 14 MB
5.0.0-1.21
beta
Hand Shaker 5.0.0-1.21
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-12-11 · 297 downloads
hand-shaker-merged-5.0.1-1.21.jar · 14 MB
4.1.2-1.21
release
Hand Shaker 4.1.2-1.21
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-12-04 · 90 downloads
hand-shaker-merged-4.1.2-1.21.jar · 260 KB
4.1.1-1.21
release
Hand Shaker 4.1.1-1.21
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-11-23 · 120 downloads
hand-shaker-merged-4.1.1-1.21.jar · 260 KB
4.1.0-1.21
release
Hand Shaker 4.1.0-1.21
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-11-20 · 79 downloads
hand-shaker-merged-4.1.0-1.21.jar · 260 KB
4.0.0-1.21
release
Hand Shaker 4.0.0-1.21.x (Universal)
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-11-16 · 86 downloads
hand-shaker-merged-4.0.0-1.21.jar · 257 KB
4.0.0-1.21-fabric
release
Hand Shaker 4.0.0-1.21.x (Fabric)
1.21.101.21.91.21.81.21.7+7fabric
2025-11-16 · 27 downloads
hand-shaker-4.0.0-1.21-signed.jar · 229 KB
4.0.0-1.21-paper
release
Hand Shaker 4.0.0-1.21.x (Paper)
1.21.101.21.91.21.81.21.7+7paper
2025-11-16 · 22 downloads
hand-shaker-paper-4.0.0-1.21.jar · 30 KB
3.0.0-1.21
release
Hand Shaker 3.0.0-1.21.x (Universal)
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-10-23 · 162 downloads
hand-shaker-merged-3.0.0-1.21.jar · 61 KB
3.0.0-1.21-fabric
release
Hand Shaker 3.0.0-1.21.x (Fabric)
1.21.101.21.91.21.81.21.7+7fabric
2025-10-23 · 33 downloads
hand-shaker-3.0.0-1.21-signed.jar · 43 KB
3.0.0-1.21-paper
release
Hand Shaker 3.0.0-1.21.x (Paper)
1.21.101.21.91.21.81.21.7+7paper
2025-10-23 · 28 downloads
hand-shaker-paper-3.0.0-1.21.jar · 19 KB
2.0.0-1.21
release
Hand Shaker 2.0.0-1.21 (Universal)
1.21.101.21.91.21.81.21.7+7fabricpaper
2025-10-23 · 28 downloads
hand-shaker-merged-2.0.0-1.21.jar · 39 KB
2.0.0-1.21
release
Hand Shaker 2.0.0-1.21 (Fabric)
1.21.101.21.91.21.81.21.7+7fabric
2025-10-23 · 27 downloads
hand-shaker-2.0.0-1.21.jar · 27 KB
2.0.0-1.21
release
Hand Shaker 2.0.0-1.21.x (Paper)
1.21.101.21.91.21.81.21.7+7paper
2025-10-22 · 19 downloads
hand-shaker-paper-2.0.0-1.21.jar · 13 KB
1.0.0-1.21.x
release
Hand Shaker 1.0.0 - 1.21.x (Fabric)
1.21.101.21.91.21.81.21.7+7fabric
2025-10-22 · 34 downloads
hand-shaker-1.0.0 - 1.21.jar · 13 KB
1.0.0-1.21.x
release
Hand Shaker 1.0.0 - 1.21.x (Paper)
1.21.101.21.91.21.81.21.7+7paper
2025-10-11 · 29 downloads
paper-1.0.0 - 1.21.10.jar · 11 KB
1.0.0-1.21.10
release
Hand Shaker 1.0.0 - 1.21.10 (Fabric)
1.21.10fabric
2025-10-11 · 28 downloads
hand-shaker-1.0.0 - 1.21.10.jar · 13 KB
1.0.0
release
Hand Shaker 1.0.0 - 1.21.9 paper
1.21.9paper
2025-10-01 · 25 downloads
paper-1.0.0 - 1.21.9.jar · 11 KB
1.0.0
release
Hand Shaker 1.0.0 - 1.21.9
1.21.9fabric
2025-10-01 · 27 downloads
hand-shaker-1.0.0 - 1.21.9.jar · 15 KB
1.0.0
release
Hand Shaker 1.0.0 plugin
1.21.8paper
2025-09-07 · 40 downloads
paper-hand-shaker-1.21.8.jar · 11 KB
1.0.0
release
Hand Shaker 1.0.0 for 1.21.8
1.21.8fabric
2025-09-07 · 55 downloads
fabric-hand-shaker-1.0.0.jar · 15 KB

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

About

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

🤝 HandShaker 7.0.0 (alpha) Wiki is there!

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

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
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

📖 Full Wiki
⬇️ Installation Guide
⚙️ Configuration Guide
💬 Commands Reference
🔨 Building from Source
📋 Changelog

Roadmap

More QoL features

🤝 Contributing

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

Hand Shaker

Files

7.0.1-1.21+NeoForge

7.0.1-1.21+Fabric

7.0.1-1.21+Paper

7.0.1-26.1+Fabric

7.0.1-26.1+NeoForge

7.0.0-1.21+Paper

7.0.0-1.21+NeoForge

7.0.0-1.21+Fabric

7.0.0+Fabric

7.0.0+Neoforge

6.0.2-1.21.11

6.0.2-1.21.x

6.0.2-1.21.11

6.0.2-1.21.x

6.0.2-1.21+

6.0.1-1.21.11

6.0.1-1.21.x

6.0.1-1.21.11

6.0.1-1.21.x

6.0.1-1.21+

6.0.0-1.21.11

6.0.0-1.21.x

6.0.0-1.21.11

6.0.0-1.21.x

6.0.0-1.21+

5.2.0-paper

5.2.0-1.21.11

5.2.0-1.21.10

5.2.0-1.21.5

5.2.0-1.21.1

Client-5.1.1

5.1.0-1.21.11

5.1.0-1.21.10

5.1.0-1.21.5

5.1.0-1.21.1

fabric-5.1.0-1.21.6-1.21.10

fabric-5.1.0-1.21-1.21.5

Paper-5.1.0-1.21

5.1.0-1.21.11

5.1.0-1.21

5.0.0-1.21.11

5.0.0-1.21

4.1.2-1.21

4.1.1-1.21

4.1.0-1.21

4.0.0-1.21

4.0.0-1.21-fabric

4.0.0-1.21-paper

3.0.0-1.21

3.0.0-1.21-fabric

3.0.0-1.21-paper

2.0.0-1.21

2.0.0-1.21

2.0.0-1.21

1.0.0-1.21.x

1.0.0-1.21.x

1.0.0-1.21.10

1.0.0

1.0.0

1.0.0

1.0.0

About

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

🎯 Core Functionality

✨ Key Features

🏗️ Platform Comparison

🚀 Quick Start

Commands

Installation

Basic Configuration

📝 Permissions

🎮 Supported Versions

📚 Documentation

Roadmap

🤝 Contributing