🍵 Matcha Client

A custom Minecraft 1.8.9 client, made for players who want more.

---

📥 Download & Install

Grab the installer for your OS from the latest release and run it:

🪟 Windows	🍎 macOS	🐧 Linux
matcha-installer-windows.exe	matcha-installer-macos	matcha-installer-linux

The installer walks you through everything — pick a version, optionally grab OptiFine, hit Install, then Launch Minecraft. 🎉

It installs straight into your existing Minecraft Launcher, so your worlds, skins, and other profiles are never touched.

⚠️ Seeing a "unknown publisher" warning? That's normal — this is a free, volunteer-run project, so we can't afford the paid certificates that make that warning go away. It doesn't mean anything is wrong.

• Windows: click More info → Run anyway
• macOS: right-click the file → Open
• Linux: just chmod +x it and run

🛠️ Prefer to install manually (no installer)?

1. Download client.jar and manifest.json from a client-vX.Y.Z release.
2. Put manifest.json at .minecraft/versions/<id>/<id>.json.
3. Put client.jar at .minecraft/libraries/matchaclient/client/<version>/client-<version>.jar.
4. (Optional) Grab OptiFine 1.8.9 HD U M5 from optifine.net and put it at .minecraft/libraries/optifine/OptiFine/1.8.9_HD_U_M5/OptiFine-1.8.9_HD_U_M5.jar.
5. Point a launcher profile at that version.

Where's .minecraft?

OS	Path
Windows	%APPDATA%\.minecraft
macOS	~/Library/Application Support/minecraft
Linux	~/.minecraft

---

🧩 What's in this repo

🎮 matcha-client	The client itself
🖥️ matcha-server	A matching server build
📡 matcha-realtime-server	Presence & identity service (Go)
⚙️ matcha-gradle-plugin	Build tooling
💾 matcha-installer	The desktop installer

👩‍💻 Building from source

Requires JDK 21.

./gradlew :matcha-client:build

See matcha-installer/README.md for building the installer.

---

Made with 🍵 by the Matcha Client community