Using the client

In-game features

The LeiCraftClient options screen, the /leicraftclient commands, the tab-list badge, Discord Rich Presence, update notices and the config file.

Everything the mod adds to the game is on one options screen and in one chat command. This page explains every button and setting.

Open the options screen

  • Title screen: click LeiCraftClient below the Realms button. If you use Mod Menu, the button sits below Mods.
  • Pause menu: press Esc in a world. LeiCraftClient sits directly above Mods (with Mod Menu) or above Minecraft's options button.

The options screen

From top to bottom:

Button or lineWhat it does
Version …The version of the mod you are running.
Update available: …Only shows when there is a newer release. Opens its release page. See Update notice.
Custom capes (ON/OFF)Shows LeiCraft capes on players. When OFF, you only see normal Minecraft capes.
Custom cosmetics (ON/OFF)Shows 3D cosmetics on players.
Discord Rich Presence (ON/OFF)Shows on Discord what you are playing. See Discord Rich Presence.
Reload capes & cosmeticsLoads everyone's capes and cosmetics again now, instead of waiting. Use it after you changed your look on the website.
LeiCraftClient accountThe account section: a status line and the buttons below.
Link account / New linkStarts linking. While the game waits for you on the website, it reads New link and makes a fresh link.
WardrobeOpens the in-game wardrobe. Greyed out until your account is linked.
UnlinkUnlinks this Minecraft account (after you confirm). Only shows when it is linked.
RetryOnly shows after an error. Tries to sign in again.
Account (ON/OFF)Signs in to LeiCraftClient with your Minecraft session. Linking and the wardrobe need it. When OFF, the mod only shows other players' capes and cosmetics.
Open websiteOpens the LeiCraftClient website in your browser.
DoneCloses the screen.

The switches only change what you see. Turning off Custom capes doesn't hide your cape from other players. Every change is saved at once in the config file.

The account status line

Below LeiCraftClient account you see one of these lines:

StatusMeaning
Linked as …Signed in and linked. The name is your LeiCraftClient (Discord) name.
Not linkedSigned in, but not linked yet. Click Link account.
Waiting for confirmation on the website…A link is open. Confirm it in your browser.
Connecting…The mod is signing in. This happens on its own after the game starts.
Offline account — linking unavailableOffline (cracked) accounts can't sign in or link.
Account services are offThe Account switch is OFF.
Error: …Signing in failed. Click Retry, or see Troubleshooting.

Commands

The /leicraftclient commands run on your own computer. They are never sent to the server, so they work on every server and in singleplayer.

CommandWhat it does
/leicraftclient or /leicraftclient statusShows your account status, and your Minecraft name and UUID when you are signed in.
/leicraftclient linkStarts linking and posts the link in the chat. If you are already linked, it shows Linked as ….
/leicraftclient wardrobeOpens the wardrobe. Needs a linked account.

Messages the mod writes to the chat on its own, like the link, start with [LeiCraft].

Tab-list badge

Players who used LeiCraftClient in the last 30 days get the LeiCraft mark in front of their name in the tab list. You only see the badge if you have the mod.

The badge doesn't depend on capes or cosmetics. It comes from the mod signing in, so you get it with a real Microsoft account and the Account switch ON. You don't have to link for it.

Discord Rich Presence

With the Discord desktop app running, your Discord profile shows what you are doing:

Where you areWhat Discord shows
Menus"In the Main Menu"
Singleplayer"Playing Singleplayer" and the world name
A server"Playing" and the server's name from your server list (or "Playing Multiplayer"), plus the player count

It also shows how long you've been there, the LeiCraft logo, and two buttons: View Profile (your player page on the website) and Download Client.

  • The server's address is never sent to Discord, only the name from your server list.
  • Discord hides presence buttons from yourself. Your friends see them.
  • Discord in the browser can't show it. If you start the desktop app later, the presence appears on its own.

Turn it off: set Discord Rich Presence to OFF in the options screen. The presence disappears right away, and the mod stops connecting to Discord.

Update notice

Once per game start, the mod checks for a newer release. If there is one, the options screen shows a green Update available: … button below the version line. It opens the release page on the website, where you can download the new version.

The mod doesn't update itself. Download the new file and put it in your mods folder instead of the old one, so that only one LeiCraftClient file is in there. A stable version is only offered stable releases.

Window title

The game window's title starts with LeiCraftClient and the mod version, followed by Minecraft's normal title, for example LeiCraftClient <version> | Minecraft* 26.3. If another mod changes the title, LeiCraftClient leaves it alone.

Config file

The settings are saved in config/leicraftclient.json inside your game folder (in launchers like Prism Launcher or the Modrinth App, that's the instance's game folder). The mod creates it on the first start. The options screen covers the usual settings, so you rarely need to edit this file. If you do, close the game first.

{
  "apiBaseUrl": "https://api.client.leicraftmc.de",
  "websiteUrl": "https://client.leicraftmc.de",
  "capesEnabled": true,
  "cosmeticsEnabled": true,
  "accountServicesEnabled": true,
  "cacheSeconds": 600,
  "discordRichPresenceEnabled": true,
  "discordAppId": "1006198534581796945"
}
KeyDefaultMeaning
capesEnabledtrueCustom capes
cosmeticsEnabledtrueCustom cosmetics
discordRichPresenceEnabledtrueDiscord Rich Presence
accountServicesEnabledtrueAccount
cacheSeconds600How many seconds the mod keeps a player's capes and cosmetics before it asks again. At least 30.
websiteUrlhttps://client.leicraftmc.deThe website the mod's buttons open.
apiBaseUrlhttps://api.client.leicraftmc.deThe LeiCraftClient server. Don't change it.
discordAppId1006198534581796945The Discord app for Rich Presence. Don't change it.

If a value is broken, the mod uses the default. Missing keys are written back on the next start.

The mod writes two more things:

  • config/leicraftclient-session.json holds your sign-in token. Keep it private and don't share it.
  • leicraftclient/cache/assets/ holds downloaded capes and models. You can delete it safely. The mod downloads them again.