Craft Presence Mod — Guide
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}.
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.
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.
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.