Craft Presence Mod (26.1.2, 1.20.1) – Discord Status

Overview#

Unlike standard presence integrations, CraftPresence offers near-total control over the displayed text, icons, and timers.

The mod is purely client-side, meaning it does not need to be installed on a server for it to function, though it can detect server-specific information. It supports a wide array of placeholders, allowing for dynamic updates based on the player's current biome, dimension, held item, or even the number of mods installed.

Accessing the Configuration#

The heart of CraftPresence lies in its extensive in-game configuration menu. This menu allows users to modify every aspect of their Discord status without leaving the game or editing text files manually.

Default Keybind: Press v while in-game to open the CraftPresence customization GUI.
Command Access: Alternatively, players can use the /craftpresence config command to open the menu.

Within this menu, players can toggle the presence on or off, set global placeholders, and navigate to sub-menus for specific categories like Servers, Dimensions, and Advanced Settings.

Placeholders and Variables#

Placeholders are dynamic strings that the mod replaces with real-time game data.

Placeholder	Description
`{player.name}`	The username of the current player.
`{world.name}`	The name of the current world or dimension.
`{server.address}`	The IP or hostname of the server the player is on.
`{server.motd}`	The Message of the Day for the current server.
`{mods.count}`	The total number of mods currently loaded in the instance.
`{biome.name}`	The name of the biome the player is currently standing in.
`{item.name}`	The name of the item currently held in the player's main hand.
`{entity.target}`	The name of the entity the player is currently looking at.
`{pack.name}`	The name of the modpack (if detected via manifest).

These placeholders can be combined with custom text, such as: Exploring {biome.name} in {world.name}.

Dimension and Biome Customization#

CraftPresence allows for unique messages and icons based on the player's location. This is particularly useful for modded dimensions or specific biomes.

Dimension Settings

Players can define specific messages for the three vanilla dimensions and any modded dimensions (e.g., The Twilight Forest, The Aether). Each dimension can have its own:

Large Image Key: A specific icon associated with that dimension.

Biome Settings

Similar to dimensions, biomes can be customized. If a player enters a 'Desert', the status can change to reflect the heat, or if they enter a 'Deep Dark', the status can become more ominous. The mod prioritizes Biome settings over Dimension settings if both are configured.

Server and Multi-Instance Support#

When playing on multiplayer servers, CraftPresence can display the server's specific information. This includes the server's icon (if available in the mod's internal database) and the current player count.

Server Grouping: Users can group similar servers together to share a single status configuration.
Hidden IPs: For privacy, players can choose to obfuscate or hide the server address while still showing that they are in a multiplayer session.
LAN Support: The mod correctly identifies and displays status for players hosting or joining LAN worlds.

Advanced Mechanics#

For power users, CraftPresence includes advanced mechanics to fine-tune the experience.

Presence Timers

Reset on Change: The timer restarts whenever the player changes dimensions or servers.
Total Session: The timer shows the total time since the game was launched.
Hidden: The timer is removed entirely.

Asset Management

CraftPresence uses 'Asset Keys' to pull images from Discord's developer portal. While the mod comes with a default set of icons for vanilla Minecraft, users can create their own Discord Application and link it to the mod to use custom high-resolution icons for modded items and blocks.

Commands#

The mod provides several commands to manage the presence and troubleshoot issues.

Command	Function
`/craftpresence config`	Opens the main configuration GUI.
`/craftpresence reload`	Forces the mod to reload all configuration files and assets.
`/craftpresence help`	Displays a list of all available sub-commands and their usage.
`/craftpresence view assets`	Lists all currently loaded asset keys available for use.

Integrations#

CraftPresence features built-in compatibility with other mods to provide even more detail:

Curios/Trinkets: Can display equipped accessories in the status.
Modpack Metadata: Automatically detects the name and version of many popular modpacks.
Placeholder API: On supported platforms, it can pull variables from other mods that use the Placeholder API system.