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.
| 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 |
✅ 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 | ✅ | ❌ | ❌ |
mods/ folderplugins/ foldermods/ folderconfig: 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"
| Permission | Description | Default |
|---|---|---|
handshaker.admin |
Access to admin commands | Operator |
handshaker.bypass |
Bypass mod restrictions | False |
| 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 |
Issues, pull requests, and suggestions are welcome! Check the GitHub repository for contribution guidelines.
Required
Required
Умови використання, зміни та поширення цього товару.
19.05.2026 · Modrinth
Скриншоти та зображення з оригінальної сторінки Modrinth.
Опубліковані версії та оригінальні файли Modrinth.
19.05.2026 · 612 завантаження
19.05.2026 · 3 702 завантаження
19.05.2026 · 840 завантаження
handshaker-enforcement: false/handshaker gui19.05.2026 · 1 311 завантаження
19.05.2026 · 167 завантаження
30.03.2026 · 205 завантаження
30.03.2026 · 89 завантаження
30.03.2026 · 1 046 завантаження
30.03.2026 · 194 завантаження
30.03.2026 · 28 завантаження
28.02.2026 · 103 завантаження
28.02.2026 · 1 475 завантаження
28.02.2026 · 1 079 завантаження
28.02.2026 · 1 414 завантаження
28.02.2026 · 145 завантаження
24.02.2026 · 29 завантаження
24.02.2026 · 30 завантаження
24.02.2026 · 111 завантаження
24.02.2026 · 96 завантаження
24.02.2026 · 30 завантаження
06.02.2026 · 75 завантаження
Starting from this version, Hand-Shaker will slowly start to become more modular and more customizable.
v6.0.0 ISN'T BACKWARDS COMPITIABLE WITH OLDER SERVER OR CLIENTS DUE BIG REWRITES AND SECURITY IMPROVEMENTS
Json file was big mistake but in 6.0.0 yml files are back (even for fabric). Instead of 1 config file, its splited into multiple yml files with comments. Added support for user created messages.
Actions is new way to custom actions for each mod, stored inside mods-actions.yml, and then adding then adding actions to the any mod to run if detected
New feature of converting v3 configs (v5.x+) to convert into new format of configs
New configs to disable database, enable/disable lists to disable them without deleting mods from lists
More info here
Reorganized commands under sub-commands manage, info, manage, mode.
More info here
06.02.2026 · 34 завантаження
06.02.2026 · 1 578 завантаження
06.02.2026 · 9 783 завантаження
06.02.2026 · 49 завантаження
14.01.2026 · 49 завантаження
Added config "allow_bedrock_players" for new generated configs (manually can be also added) to allow bedrock players to bypass "Hand Shaker" verification
NOTE:
It Should work on Both Paper/Fabric, But Fabric server must be Vanilla friendly (Only server-side mods, No big mods).
This mod wont with a magic allow bedrocks players to join heavy-moded server
Behavior to Vanilla players would been still checked for Integrity and blacklisted/required mods14.01.2026 · 727 завантаження
14.01.2026 · 167 завантаження
14.01.2026 · 48 завантаження
14.01.2026 · 190 завантаження
14.01.2026 · 59 завантаження
Works with v3.x+ Servers
Fixed crash on game start caused by misconfiguration of fabric-mod.json
Can be fixed by editing
"client": [
"me.mklv.HandShaker"
]
to
"client": [
"me.mklv.handshaker.HandShaker"
]
06.01.2026 · 109 завантаження
06.01.2026 · 135 завантаження
06.01.2026 · 39 завантаження
04.01.2026 · 103 завантаження
This is only a technical change related to fabric servers, but because of that, Fabric and paper got splitted away due fabric server-side and dependecy for fabric servers changing code over versions and implementing new features for mod fully broke 5.x version of mod (Fabric server only) meanwhile client-side and paper works perfect.
From this patch/announce instead of universal files would be fully seperated and wont include big range of versions due Fabric servers and sadly I cant split client and server because then it could lead to confusions for modpack creators who will copy paste from clients mods folder
31.12.2025 · 77 завантаження
Fabric Client and Server for 1.21.6 to 1.21.10
31.12.2025 · 282 завантаження
Fabric Client and Server for 1.21 to 1.21.5
31.12.2025 · 289 завантаження
Standalone plugin
21.12.2025 · 614 завантаження
21.12.2025 · 555 завантаження
12.12.2025 · 102 завантаження
11.12.2025 · 290 завантаження
5.0.0-1.21.xis partially working on 1.21.11, because Fabric server crashes on join. This will be fixed in5.0.0-1.21.11
"action" for every mod to choose to auto BAN or simply warn player by KICK (default)/handshaker info (mod) and /handshaker ignore add|list|remove <mod>player now shows date next to modhandshaker.bypass permission.json config to match config from Fabric serverplayer now shows date when hovered over mod04.12.2025 · 86 завантаження
Fixed critical issue
23.11.2025 · 118 завантаження
Fabric server generates both new and old config strings
20.11.2025 · 74 завантаження
(Paper) Added back /handshaker player <player> [mods] [status]
(Paper & Fabric) Added support for (Alpha) Velton
Client mod is still backwards compatible
16.11.2025 · 84 завантаження
16.11.2025 · 24 завантаження
16.11.2025 · 19 завантаження
blacklisted mods, whitelisted mods, operation mode settings, now replaced with mods, default mode, making possible to set allowance per mod/handshaker mode because its not needed anymore /handshaker whitelist_update because its not needed anymore /handshaker list lists all mods from config with their allowance statuses/handshaker change changes mod allowance status/handshaker player (Paper) prints player mods in the chat Mod [allowance status] [A] [R] [B], Fabric stays as command/handshaker add now supports * to list all mods and status to make mods as allowed/required/blacklisted23.10.2025 · 156 завантаження
23.10.2025 · 28 завантаження
Signed to work with "Integrity":"Signed"
Whitelist mode: to add whitelisted mods use configs or /handshaker whitelist_update <player> to update whitelist based on mod list and then /handshaker mode whitelist to turn on.
Integrity: Version 3.0.0 now has config "Integrity" with variables "Signed" or "Dev", if set to "Signed" only signed, unmodified handshaker clients, are allowed to join. Meanwhile "Dev" allows un-signed/modified handshaker. To allow 2.x clients to join on server with 3.x you must set "Dev"
23.10.2025 · 24 завантаження
Whitelist mode: to add whitelisted mods use configs or /handshaker whitelist_update <player> to update whitelist based on mod list and then /handshaker mode whitelist to turn on.
Integrity: Version 3.0.0 now has config "Integrity" with variables "Signed" or "Dev", if set to "Signed" only signed, unmodified handshaker clients, are allowed to join. Meanwhile "Dev" allows un-signed/modified handshaker.
23.10.2025 · 24 завантаження
Universal Jar for Fabric Client/Server and paper
23.10.2025 · 24 завантаження
Behavior with variables Strict - Allow only clients with mod and Vanilla - Allow Vanilla/Other clients tooShould work with 1.0.0 paper plgin version, but if anything happens update to server side plugin too. 1.0.0 fabric is no longer supported
22.10.2025 · 16 завантаження
/hskick mode to Behavior with variables Strict and Vanilla, (kick mode: Fabric -> Behavior: Vanilla and kick mode: All -> Behavior: Strict )Should work with 1.0.0 client mod version, but if anything happens update to client mod too. 1.0.0 paper is no longer supported
22.10.2025 · 31 завантаження
Hand Shaker for Fabric 1.21.x (1.21 - 1.21.10)
11.10.2025 · 27 завантаження
New version syntex
To make less confusions with version naming it has to be changes to {mod version} - {Minecraft version} {platform}
11.10.2025 · 26 завантаження
New version syntex and 1.21.10
To make less confusions with version naming it has to be changes to {mod version} - {Minecraft version} {platform}
01.10.2025 · 21 завантаження
01.10.2025 · 24 завантаження
07.09.2025 · 35 завантаження
07.09.2025 · 50 завантаження