# MineChat Server<\/p>\n
MineChat lets players chat on a Minecraft server without needing to join the server from Minecraft.<\/p>\n
This plugin provides the server-side component of the MineChat platform, connecting in-game chat with external MineChat clients.<\/p>\n
> **Note**: This project is currently being updated to follow the official MineChat protocol specification, which improves safety and convenience.
\n>
\n> The current version still works with older clients but will receive breaking changes in the future.<\/p>\n
## Features<\/p>\n
* **Client authentication**: MineChat clients authenticate once using a temporary link code.
\n* **Chat bridging**: Messages sent in Minecraft chat are broadcast to connected MineChat clients and vice versa.
\n* **Persistent storage**: Link codes and client information are saved on disk, persisting across server restarts.
\n* **Automatic cleanup**: Expired link codes are removed automatically every minute.<\/p>\n
## How to Use<\/p>\n
### Linking your account<\/p>\n
1. **Generate a link code** in-game:
\n `\/link`
\n You will receive a temporary code valid for 5 minutes.<\/p>\n
2. **Authenticate from the CLI client** (a GUI client is in the works):<\/p>\n
“`bash This links your MineChat client to your Minecraft account without using Minecraft credentials.<\/p>\n ## Advanced: How it Works<\/p>\n * **Server socket**: Listens for connections from MineChat clients on port `25575` by default. ## Contributing<\/p>\n Contributions are welcome! Please submit issues or pull requests.<\/p>\n","protected":false},"excerpt":{"rendered":" Talk to people without having to log in to a Minecraft account, from other apps via the MineChat platform.<\/p>\n","protected":false},"featured_media":101528,"template":"","meta":{"_minecraft_slug":"minechat","_minecraft_project_id":"bb1NmsAr","_minecraft_author":"winlogon","_minecraft_license":"MPL-2.0","_minecraft_downloads":80,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"minechat.zip","_minecraft_size_bytes":1601098,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:12:34.540068Z","_minecraft_date_created":"2025-03-13T03:12:16.651711Z","_minecraft_date_modified":"2025-03-10T23:43:17.242740Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minechat","_minecraft_icon_attachment_id":101528,"_minecraft_imported_at":"2026-06-05T20:03:29+00:00","_minecraft_import_hash":"d83a80e6b223603c837167bb89978843","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128,867,123,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,73,74,38],"class_list":["post-101527","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-technology","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n minechat-client –server
\n ```<\/p>\n
\n* **Authentication**: Validates clients using link codes or stored UUIDs and broadcasts join\/leave messages.
\n* **Message broadcasting**: Sends in-game chat to connected clients and relays client messages to Minecraft chat.
\n* **Persistent storage**: Stores client data in JSON files under `plugins\/MineChat\/` (`link_codes.json` and `clients.json`).<\/p>\n