Chat Sync

Client-side Fabric mod for Minecraft 1.20.1 that links two accounts with explicit confirmation and lets selected chat/tell workflows be mirrored or executed from the paired account.

Built for personal use with two trusted accounts. Both clients must install the mod, configure each other as the paired account, and confirm the connection in-game.

Highlights

Feature	What it does
Confirmed account link	Both players must use each other's nick and accept the sync request.
Remote chat execution	Messages typed on one account can be executed by the selected executor account.
Tell replication	Private tells received on one account can appear on the selected viewer account.
Exact tell rendering	The mod tries to copy the original tell line exactly as it appeared in chat.
Assistant menu	Guided setup for the common two-account configurations.
Profiles	Save up to four complete configurations and switch quickly.
Send filters	Choose whether normal chat, private commands, group commands, or other commands may be relayed.
Anti-spam queue	Sends remote actions with a configurable delay to avoid message bursts.
Diagnostics and history	Shows connection state, last packet, last issue, and a persistent event history.
Transparent UI	In-game overlay menu with translucent panels so the world remains visible.

Requirements

• Minecraft 1.20.1
• Fabric Loader 0.15.0+
• Fabric API
• Java 17+
• The same Minecraft server/chat environment on both accounts

Install

1. Download the latest jar from the GitHub release or build it locally.
2. Put the jar in the mods folder of both Minecraft/Fabric instances.
3. Make sure Fabric API is installed in both instances.
4. Restart both games.
5. Press J in-game to open the Chat Sync menu.

Quick Start

1. Open the menu with J on both accounts.
2. In Conta pareada, type the nick of the other account.
3. Click Assistente and choose the role for each account.
4. Enable Sincronizacao.
5. On one account, click Solicitar sincronizacao.
6. On the other account, open the menu and click Aceitar solicitacao.
7. Use Enviar teste to confirm the link.

See docs/USAGE.md for examples with tells and remote replies.

Important Concepts

Term	Meaning
Conta pareada	The other account that is allowed to communicate with this client.
Conta executora	The account that will actually send remote messages/commands.
Origem do tell	The account where the private tell arrives originally.
Destino da copia	The account where the copied tell should appear.
Fluxo	Direction of synced chat between the paired accounts.

Safety Notes

• This is a client-side convenience mod. It does not grant server permissions.
• It does not use an external server or IP-based service.
• It relies on private messages/commands inside the Minecraft server chat.
• Only use it with accounts you control or with explicit permission from the other user.
• Some servers may have rules against automation, multi-accounting, or chat relays. Check the server rules before using it.

Documentation

• Usage guide
• Menu reference
• Architecture
• Troubleshooting
• Changelog

Build

.\gradlew.bat build

The compiled jar will be generated at:

build/libs/chat-sync-1.8.2.jar

Project

GitHub owner: eemppty

Project author: Sponter771

Minecraft mod id: chatsync

License: MIT