MineChat

# MineChat Server MineChat lets players chat on a Minecraft server without needing to join the server from Minecraft. This plugin provides the server-side component of the MineChat platform, connecting in-game chat with external MineChat clients. > **Note**: This project is currently being updated to follow the official MineChat protocol specification, which improves safety and convenience. > > The current version still works with older clients but will receive breaking changes in the future. ## Features * **Client authentication**: MineChat clients authenticate once using a temporary link code. * **Chat bridging**: Messages sent in Minecraft chat are broadcast to connected MineChat clients and vice versa. * **Persistent storage**: Link codes and client information are saved on disk, persisting across server restarts. * **Automatic cleanup**: Expired link codes are removed automatically every minute. ## How to Use ### Linking your account 1. **Generate a link code** in-game: `/link` You will receive a temporary code valid for 5 minutes. 2. **Authenticate from the CLI (https://github.com/MineChatPowered/client)** (a GUI client is in the works): ```bash minechat-client --server <host:port> --link <code> ``` This links your MineChat client to your Minecraft account without using Minecraft credentials. ## Advanced: How it Works * **Server socket**: Listens for connections from MineChat clients on port `25575` by default. * **Authentication**: Validates clients using link codes or stored UUIDs and broadcasts join/leave messages. * **Message broadcasting**: Sends in-game chat to connected clients and relays client messages to Minecraft chat. * **Persistent storage**: Stores client data in JSON files under `plugins/MineChat/` (`link_codes.json` and `clients.json`). ## Contributing Contributions are welcome! Please submit (https://github.com/MineChatPowered/server/issues) or pull requests.