Simple Discord RPC Mod Wiki

Simple Discord RPC (Rich Presence) is a utility mod designed to enhance the social experience of Minecraft by displaying real-time game information on a player's Discord profile. Unlike standard Discord integration, this mod offers deep customization, allowing users to change the text, icons, and buttons displayed based on their current activity in the game.

It is particularly popular among modpack creators who wish to brand their packs or provide players with a way to showcase their progress. The mod works immediately upon installation but provides an extensive configuration system for those who want to tailor the experience. It supports custom application IDs, allowing for unique icons and titles that go beyond the default 'Minecraft' status.

It gathers data from the Minecraft client—such as the current world, player stats, and loaded mods—and formats it into a Rich Presence update.

Key Features

• Dynamic Placeholders: Use variables to show live data like coordinates, health, or server IP.

• Dimension Awareness: Change the display icon or text automatically when entering the Nether, the End, or custom modded dimensions.

• Custom Buttons: Add clickable links to your Discord profile, such as a link to a wiki, a website, or a server store.

• Config Editor Support: Compatible with a dedicated external application for visual configuration editing.

The primary configuration file is simple-rpc.toml. This file controls every aspect of the Rich Presence display. The mod uses a placeholder system to pull live data from the game.

Available Placeholders

General Settings

To use custom images and a custom application name, users must set up a Discord Application. This process allows the mod to display high-quality assets instead of generic icons.

1. The name of this application will be the 'Playing...
2. Client ID: The 'Application ID' found in the General Information tab must be pasted into the appID field in the mod's config file.
3. Rich Presence Assets: Under the 'Rich Presence' tab, users can upload 'Art Assets'. These images are given names (keys) which are then referenced in the simple-rpc.toml file under the [images] section.

Simple Discord RPC allows for specific configurations based on the dimension the player is currently exploring. This is handled in the [dimension_overrides] section of the configuration file.

Each dimension (e.g., minecraft:the_nether, minecraft:the_end) can have its own:

• Large Image: A specific icon for that dimension.
• Large Image Text: Hover text for the icon.
• Details: The top line of text in the RPC.
• State: The bottom line of text in the RPC.

This allows a player's profile to change from 'Exploring the Overworld' with a grass block icon to 'Surviving the Nether' with a fire icon automatically upon teleportation.

The mod supports up to two custom buttons that appear on the player's Discord profile. These are configured in the [buttons] section.

Button Configuration Fields

• Label: The text displayed on the button (e.g., 'Join our Website').
• URL: The destination link when the button is clicked.

Note: Due to Discord's security policies, buttons may not be clickable for the player themselves, but they will be fully functional for other users viewing the player's profile.

For users who prefer a graphical user interface over editing .toml files, a dedicated Config Editor App is available.

• Step-by-Step Editing: Guides the user through setting up the Application ID, text lines, and images.

• Error Checking: Ensures that placeholders are formatted correctly and that image keys match those uploaded to the developer portal.