Hand Shaker

### **⚠️ This project requires to be set up on both sides, client and server side ⚠️** # 🤝 HandShaker 7.0.0 (alpha) (https://icevallishstudios.gitbook.io/docs/hand-shaker/hand-shaker-7.x) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/available/modrinth_vector.svg)](https://modrinth.com/plugin/hand-shaker) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/available/curseforge_vector.svg)](https://www.curseforge.com/minecraft/mc-mods/hand-shaker) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/supported/paper_vector.svg)](https://papermc.io/) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/supported/purpur_vector.svg)](https://purpurmc.org/) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/documentation/generic_vector.svg)](https://icevallishstudios.gitbook.io/docs/hand-shaker/hand-shaker-7.x) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/donate/kofi-plural-alt_vector.svg)](https://ko-fi.com/icevallish) (https://raw.githubusercontent.com/intergrav/devins-badges/c7fd18efdadd1c3f12ae56b49afd834640d2d797/assets/cozy/requires/fabric-api_vector.svg)](https://modrinth.com/mod/fabric-api) !(https://raw.githubusercontent.com/Hyperbole-Devs/vectors/8494ec1ac495cfb481dc7e458356325510933eb0/assets/cozy/supported/neoforge_vector.svg) --- ## 📋 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+<br/>⚠️ 3.x - 5.x<br/> | ✅ 6.x+<br/>⚠️ 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 ## (https://github.com/suskese/hand-shaker/wiki/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 ```yaml 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) integrit