EncrypterMod v1.0.0

Description: Client-side AES chat encryption for Minecraft. Encrypt messages for friends, send them with a unique ID, and decrypt them with the same key. Fully works on player [NotSecure]Chat; channel and system chat [SYSTEM]Chat; channel, which most servers have nowdays. This mod is depending on fabricAPI.

---

Features

• Secure AES-GCM encrypted chat messages for Minecraft anarchy servers.
• works on almost any server. (still need testing) working servers: Constantiam.net, Oldfag.org, anarchy.ac, crystalpvp.cc, 9b9t, DonutSMP, Qndres.net, V+
• Unique message IDs for each sent message
• Chat listener works for both player and system chat
• Local storage of encrypted messages for decryption
• Commands to send, decrypt, and view mod info
• Fully client-side: no server modification required
• Optional offline decryption using a Python/HTML tool
• Provided encryption/decryption tools, they can be used everywhere not just for Minecraft chat.

---

Offline Encryption/Decryption tools fully HTML NO DOWNLOAD OF JAR NEEDED

Offline Decryption Tool (HTML – No install needed)

If for some reason you do not want to download the mod to decrypt messages, you can use the Offline html tool privided inside Offline_Decryption_Folder. This also works for any other chat not only Minecraft chat. (whatsapp / steam/ literally anywhere where you can copy paste the encrypted message) What to do? On github:

1. Open Offline_Decryption_Folder.
2. open decrypter_encrypter file inside the folder.
3. then; you have 2 options now. Option A: Download the full html file (click 3 dots on the top right, download). Option B: Select full code, scan with any maliciousintentscanner, copypasta the code in a empty txt file on your desktop,save the file as .html NOT AS .txt You need to select the option "save as '.*' instead of .txt
4. doubleclick encrypter_decrypter.html it should open the html tool inside your browser.
5. open minecraft logs and copypaste the full encryted message (ID:Playername_MessageUUID_EncryptedTEXT) inside the decrypter. DO not take a screenshot from minecraft ingame chat and use a tool like ImageToText Ai to retrieve the encrypted text + message uuid it will format it weirdly and not work correctly.
6. enter the key from /minecraft/config/encrypter/key.json
7. Done -> You can see the encrypted message from your friend without downloading the jar.

---

**Offline Encryption Tool (HTML - No install needed)

This also works for any other chat not only Minecraft chat. (whatsapp / steam/ literally anywhere where you can copy paste the encrypted message)

1. Open Offline_Encrypter_Folder.
2. open encrypter_encrypter file inside the folder.
3. then; you have 2 options now. Option A: Download the full html file (click 3 dots on the top right, download). Option B: Select full code, scan with any maliciousintentscanner, copypasta the code in a empty txt file on your desktop,save the file as .html NOT AS .txt You need to select the option "save as '.*' instead of .txt
4. doubleclick encrypter_encrypter.html it should open the html tool inside your browser.
5. Enter; username, shared aes-key >Raw text key (UTF-8) — paste exactly what's in config/key.json< (same as your friends), and your message.
6. Click on "Encrypt and generate chatline"
7. Done -> You can copy pasta the ID_username_UUID + Encrypted message in your Minecraft chat now for your friend to decode without downloading the jar.

---

**Important note for AES-key (For mod only, does not affect offline encryption tool)

As for now every new user will get the same default key when fist launching the mod.

 { JsonObject json = new JsonObject();
            json.addProperty("aes_key", "1234567890abcdef1234567890abcdef");
            }

This will be improved in the future.

CHANGE KEY IMMEDIATELY!

The Key HAS to be 32 bits (32 ASCII Character 1 char = 1 bit) make sure your key has 32 letters/numbers/symbols!!!

Installation for the actual Mod

1. Place the mod .jar in your mods folder for your Minecraft Fabric client.
2. Start Minecraft with Fabric.
3. The mod will automatically create a default AES key in config/encrypter/key.json.
4. Commands and chat listener are registered on client initialization.

---

Commands

• /encrypter info Prints mod info in chat (version, authors, description).

• /encrypter encrypt <message> Encrypts a message and sends it with a unique ID. Example:

  [ID: Player_abc123-uuid] EncryptedMessageHere
  

• /encrypter decrypt <id> Decrypts a previously received encrypted message stored locally.

• /encrypter toggleAutoDecrypt Auto-Decrypts messages if you you have the same aes key like your friend(group)

---

How It Works

Key Management

• ConfigHandler handles loading and saving the AES key.
• KeyConfigHandler reads/writes the key from config/encrypter/key.json.
• Default key created if no config exists. CHANGE KEY IMMEDIATELY AFTER LAUNCH, THEN RELAUNCH GAME WITH NEW KEY FOR BEST PRIVACY , currently ALL new users will get the same base key.

Message Flow

1. Sending Messages:

   • ChatHandler.sendEncryptedMessage encrypts the message with AES-GCM using the client’s key.
   • Generates a unique ID for tracking.
   • Sends formatted message: [ID: <id>] <encryptedMessage>.

2. Receiving Messages:

   • ChatListener scans chat messages using a regex for [ID: <id>] <encryptedMessage>.
   • Messages detected are stored in ChatHandler and notification is shown.

3. Decryption:

   • Messages can be decrypted locally with the same AES key.
   • If keys mismatch, decryption fails.

Encryption Details

• AES in GCM mode with 128-bit authentication tag
• 12-byte random IV for every message
• Ciphertext is Base64-encoded (URL-safe) for safe Minecraft chat transmission
• Messages include IV prepended to ciphertext for proper decryption

---

Offline Decryption

Users who do not want to run the mod can decrypt messages offline using:

• Python CLI script: Paste encrypted message and key (not provided yet)

• HTML/JS tool: Fully offline in browser -> Inside OfflineDecryption folder

Offline Decryption Tool (HTML – No Install Needed) For users who prefer not to install the mod, EncrypterMod provides a fully offline, browser-based decrypter. You can use it to decrypt any message as long as you have correct AES key. The tool uses the browser’s built-in WebCrypto AES-GCM engine — the same algorithm used in the mod — ensuring full compatibility. Cross-platform (Windows, macOS, Linux) For players who want to decrypt messages without installing the mod

File Location in Repository /tools/offline_decrypter.html

---

Classes Overview

• EncrypterMod – Initializes the mod, loads key, registers commands & chat listener.
• ConfigHandler – Loads/saves AES key via KeyConfigHandler.
• KeyConfigHandler – Handles JSON read/write of AES key.
• EncryptionUtils – AES encryption/decryption logic.
• ChatHandler – Stores messages, handles sending and local decryption.
• ChatListener – Listens for messages in chat and system channels, detects message IDs.
• CommandHandler – Registers /encrypter commands.

---

Notes & Tips

• Always change default key! Key generation will give every new user the same key. INSTANT CHANGE IT
• Share the AES key with friends only.
• Changing your key will prevent others from decrypting previous messages.
• System chat detection works for servers that send [System] messages.
• ASCII art or long messages you send may require careful formatting to display properly.

---

Future Improvements

• Secure key generation / Unique Per-user keys 32 bit (SOOONtm)
• Offline message persistence
• Error reporting for key mismatches (maybe)

---

Development

• Build System: Gradle
• IDE Support: IntelliJ IDEA, Eclipse, VSCode
• Java Version: Compatible with Java 21+

Credits & Shoutouts

• Main Testserver: Constantiam.net, anarchy.ac (BANNED;TheBanhammerHasSpoken), Vanilla+(BANNED #inappropriateusername), Qndres.net(#BANid2016|BANNED;permanent,reason;bot)
• Tools & Assistance: OpenAI ChatGPT for bugfixes/codeblock generation

---

Privacy & Safety

• No IPs or sensitive data is tracked.
• All configuration data (AES-Key) is stored locally. You must always change your key after first time launching the mod.
• If you do not want to download this jar. you can make your own Encryption/Decryption HTML tool (Fully Offline btw zero chance of getting hacked) by first checking the code with any bad-intent scanner on the web, copy code then make your OWN html file on PC -> Copy paste the code from github HTML Encrypter/Decrypter each in a empty .txt file -> save as '.* ' not as .txt -> unplug your internet if you re paranoid (no connection to web means anything you run on your pc cannot be hijacked / no hacker can connect to your pc) -> open your own freshly saved html -> encrypt / decrypt / copy encrypted text -> delete both local html tools and close web -> reconnect to the internet and copy pasta your encrypted message.

License

basic aah github license opensorce