Skip to content
@LeafClientMC

LeafClientMC

🌿 A lightweight free & open-source Minecraft Client available for versions 1.8 and above.

LeafClient

A Minecraft: Java Edition client and launcher — no cheats, no bypasses, no shady business. Built from scratch with a modern UI, first-class Microsoft authentication, built-in cosmetics, and a full mod manager.

Bedrock Edition support is on the roadmap.


⚠️ Before You Do Anything

Read the LICENSE before using, modifying, or redistributing any part of LeafClient. Unauthorized redistribution or reuse of this code will result in a DMCA takedown.


🚀 Beta Status

The beta is going to be live soon! Expect rough edges — please report every bug you find through the in-launcher Feedback system.

What's in the client (20+ features)

Category Features
HUDs ArmorHUD · CoordinatesHUD · CPSHUD · FPSHUD · ItemCounterHUD · KeystrokesHUD · MinimapHUD (in progress) · PingHUD · Performance Stats
Gameplay Freelook · FullBright · ToggleSprint · ToggleCrouch · Zoom · Waypoints
Quality of Life ChatMacros · Custom Crosshair · ServerInfo · HUDThemes (in progress)
Branding Leaf Client logo badge next to your name in the tab list (client-side only for now)

What's been cut (for now)

  • 🔁 Replay — Removed. Building a full replay system (menu playback, packet simulation for replay worlds, editing/exporting) is weeks of work on its own and isn't worth blocking the first releases over. It'll come back once the core client is stable or the project has more contributors. The editor will be the easy part; faithful packet-replay simulation is the hard part.

🤔 Is it open source?

Partially. The backend logic (services, view-models, models, controls, utilities, and code-behind) is public. The UI design layer (AXAML views, themes, fonts, bundled assets, project files) and anything sensitive — cosmetics pipelines, backend secrets, in-game feature code — is kept private so the repo can't be cloned and rebranded as-is.

Anyone poking around the source can read how things work. They just can't clone-and-compile a drop-in clone.

Contributions are welcome on the public parts.


🛠️ Contributor

Solo project. Everything you see — launcher UI, in-game client, the whole auth + cosmetics + mod-manager stack — is built by one person, with LLMs used to accelerate implementation (not replace design).

To make cross-platform Microsoft auth work inside an AOT-compiled launcher, I had to fork and patch CmlLib: CmlLib-XboxAuthNet.AOTCompatible

The in-game feature code is 100% original. Third-party mods only enter the picture if you drop them into the mods folder yourself or install them through the launcher's Modrinth-powered mod page (which credits the original author by default).


💎 APIs Powering LeafClient

Service What it does
StarlightSkins Primary in-launcher skin rendering with emotes
Visage Fallback skin rendering
Modrinth API In-launcher mod browse + install
CmlLib Cross-platform Microsoft auth + Minecraft launching
mcstatus.io Live Minecraft server status

🎯 Project Goal

Not-for-profit. The vast majority of features will always be free.

The plan is to match what people expect from established clients like Lunar and Badlion — and then add the creative stuff those clients don't bother with — without locking the useful parts behind a paywall.

Monetization (minimal and non-intrusive):

  • Static banner ads on the launcher screen — no pop-ups, no video pre-rolls, nothing in-game
  • Optional cosmetics
  • Possibly an optional subscription down the road

No in-game paid features beyond a handful of cosmetics. Everything that affects gameplay stays free.

Feedback shapes the roadmap. If you want something, suggest it.


🗨️ Want to contribute or just follow along?

Join the Discord.

Pinned Loading

  1. LeafClient LeafClient Public

    🌿 LeafClient: A featureful Minecraft: Java Edition client (no cheats).

    C# 13 6

Repositories

Showing 3 of 3 repositories

Top languages

Loading…

Most used topics

Loading…