Question 1

How do I open the CraftPresence config menu?

Accepted Answer

Open the mod list, select CraftPresence, and click the config button to reach its settings screen. You can also bind a key in the controls menu to open the config directly in-game.

Question 2

Why does my Discord status still say 'Playing Minecraft' instead of my custom text?

Accepted Answer

Discord's own game detection is overriding the mod, so turn off 'Display current activity as a status message' in Discord's Activity Privacy settings. CraftPresence's rich presence then takes over.

Question 3

Do I need the Discord desktop app open for CraftPresence to work?

Accepted Answer

Yes, the Discord desktop client must be running and logged in on the same machine. The browser version of Discord and the mobile app cannot receive rich presence from the mod.

Question 4

How do I use placeholders like server IP or dimension in my status?

Accepted Answer

Enable the relevant placeholder toggles in the config, then insert the matching placeholder variable into your presence line text. The mod replaces it at runtime with the live value.

Question 5

Can I have different status text for singleplayer and multiplayer?

Accepted Answer

Yes, CraftPresence lets you configure separate presence lines for each state, including singleplayer, multiplayer, and the main menu. Set the text per state in the config so each shows its own message.

Question 6

How do I add a custom image or button to my Discord presence?

Accepted Answer

In the config, set the large/small image keys to the names of images you've uploaded to your Discord application's art assets, and add button labels with their URLs. Buttons only appear when the presence is active.

Question 7

Does CraftPresence work on servers or with other mods?

Accepted Answer

It runs client-side only, so it works on any server and doesn't need to be installed server-side. It's generally compatible with other mods, though mods that also control Discord presence can conflict.

Question 8

Will CraftPresence hurt my FPS or performance?

Accepted Answer

No, it only updates your Discord status periodically and has negligible impact on game performance. If you notice lag, increase the update interval in the config to reduce how often it refreshes.

Question 9

Why is my status stuck on the main menu text after joining a world?

Accepted Answer

The presence updates on a timer, so it can lag behind by a few seconds after you join. If it never changes, make sure the per-state text is actually filled in and that the mod is enabled for that state.

Question 10

How do I reset CraftPresence back to default settings?

Accepted Answer

Use the reset option in the config screen, or delete the mod's config file and let it regenerate on next launch. This clears any custom text, images, and placeholder toggles you've set.

Question 11

What is the CraftPresence mod?

Accepted Answer

CraftPresence adds advanced Discord Rich Presence support to Minecraft, showing your in-game activity on your Discord profile. It lets you customize the Discord status line instead of the default "Playing Minecraft".

Question 12

Is CraftPresence client-side only?

Accepted Answer

Yes, CraftPresence is a client-side only mod and will not run on the server side. Fabric and Quilt servers simply ignore it, while other mod loaders may crash, so it must not be installed server side.

Question 13

How do I use CraftPresence?

Accepted Answer

Put the mod jar in your .minecraft/mods folder and start the game with the Discord desktop client already running. Then open the mod's settings screen and edit the presence text using the placeholders you want.

Question 14

What placeholders does CraftPresence support?

Accepted Answer

Placeholders cover the menu you are in, single player worlds, server addresses, current dimension, current biome, in-game time, the item in each hand, your armour state, and entities such as what is attacking you, what you are riding and what you are looking at. The number of loaded mods can also be printed.

Question 15

Why is CraftPresence not working?

Accepted Answer

From version 2.5.0, UniLib is a required dependency and the game will crash without it or with an incompatible version. Also make sure the Discord desktop client is running before you start the game.

Question 16

Does CraftPresence need Fabric API?

Accepted Answer

Some versions of the mod for Minecraft 1.14.x and above require the Fabric API and the Fabric mod loader. Some versions for Minecraft 1.13.x require the Rift API and Rift mod loader.

Question 17

Does CraftPresence detect modpacks?

Accepted Answer

Yes, modpack instances from ATLauncher, CurseForge, GDLauncher, MCUpdater, Modrinth, MultiMC and Technic are detected from their instance files. Each state can also carry its own image, so the icon changes with the dimension or the pack.

CraftPresence FAQ