=========================================================
This document explains how the Movement Security Client Mod enhances the security of your Minecraft server when paired with the corresponding server-side plugin.
The mod acts as a trusted agent running on the player's computer, providing information that the server cannot normally access.
----------------------------------------------
Upon joining the server, this mod scans the player's Fabric Loader environment and creates a complete list of all installed mods (names and IDs).
- Detect Cheat Clients: The server can cross-reference this list against a database of known cheat mods (e.g., "Wurst", "Meteor", "X-Ray").
- Whitelist Enforcement: You can configure the server to only allow players who have a specific set of approved mods installed.
- Bypass Prevention: Standard server anti-cheats can only guess what mods a player has based on their behavior (packets). This mod reports exactly what files are loaded in memory.
----------------------------------------
The mod hooks directly into the Minecraft game engine (specifically the `ClientPlayNetworkHandler.sendChatMessage` method). Whenever a player attempts to send a chat message, this mod sends a parallel "ChatReport" packet to the server.
- Unfiltered Chat Logs: Some cheat clients or "auto-text" macros might try to bypass server-side chat filters or logging. This mod reports the raw text the player typed, ensuring the server sees the original intent.
- Command Verification: It helps verify that chat commands executed by the player were actually typed by them and not injected by a malicious script or external program.
-------------------------------------------
The mod communicates using a custom network channel (`movement:security`).
- Enforced Installation: The server plugin can check if a player is sending these security payloads. If a player joins but does NOT send the mod list or chat reports, the server knows they are not using the official security client.
- Kick/Ban Automation: You can configure the server to automatically kick any player who refuses to install this mod, creating a "walled garden" where all participants are verified to be running your security software.
-----------------
- Channel: `movement:security`
- Payload Types:
1. `ModList`: Sent once on join. Contains list of all Fabric mods.
2. `ChatReport`: Sent every time the player chats. Contains raw message content.
--------------------------------
LabyMod 4 uses a custom folder structure and chat system which can cause compatibility issues.
1. Installation Location:
- Do NOT place this mod in the standard `%appdata%\.minecraft\mods` folder if using LabyMod.
- You MUST place it in LabyMod's specific Fabric mods folder.
- To find this: Open LabyMod Settings -> "Fabric Loader" addon settings -> Click "Open Mods Folder".
2. Potential Conflicts:
- LabyMod uses a custom chat handling system. While this mod is designed to be compatible, aggressive updates to LabyMod's internal code might bypass the chat security check.
- If you are kicked from the server despite having the mod installed, verify that the mod is actually loaded by checking the LabyMod mod list menu.
By enforcing the use of this client-side mod, you bridge the "trust gap" between the server and the player, significantly raising the difficulty for cheaters to operate undetected.