# Configuring the Mod

If you really hate editing config files by hand, it's suggested that you use our Config Editor App. It includes Live preview and fetches the available images directly from discord!

Information

Simple RPC uses a TOML based config system with a very simple, well named and commented layout. When running the mod for the first time, a config file will be created using the default settings. You can use the mod as is, use your own data, or use a Custom App entirely.

Since Simple RPC Version 1.4, it's possible to create a config for different languages. To learn more, Check out Multi Language Config Files

You do not need to restart the game while editing the config. The config will AUTO RELOAD when the file is saved

# Default Config

It has recently been discovered that discord has a character limitation on the imageText. It CANNOT be longer than 1288 chars and shorter than 2 chars

You can also use Direct links to PNG images to use as "image keys". To do this, upload your image to a site like IMGUR, Dropbox or Github and right click the image, then copy URL. If you paste this URL into your browser and ONLY see the image, it will work. If you see a webpage, it will NOT work!

Sample Config

Below is the sample config file with an explanation of each section/item.

To have a value ignored, simple leave it empty! clientID is required though

#General Config Section
#To have a value ignored, simply leave it empty!
[general]
	#The Client ID of the Discord App to use. Replace this with your client id from the previous step to change the name of the app
	clientID = 762726289341677668
	#Enable/Disable the mod
	enabled = true
	#Enable/Disable debugging mode. WARNING: MAY CAUSE LOG SPAM!
	debugging = false
	#Enable/Disable the in game config screen
	configScreen = true
	#Display the Icon and Pack Name in place of LargeImage from compatible launchers. DOES NOT WORK WITH CUSTOM APPS! ONLY THE DEFAULT ONE!
	launcherIntegration = false
	#Enable/Disabled in-game notifications about new releases
	updater = false
	#Internal Version Number. NO TOUCHY!
	version = 9

#The Game Loading event
[init]
	#Enable/Disable the Game Loading Event
	enabled = true
	#The first line of text under the app name
	description = "Minecraft is loading"
	#The second line of text under the app name
	state = "Game Starting..."
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#The Main Menu event
[main_menu]
	#Enable/Disable the Main Menu Event
	enabled = true
	#The first line of text under the app name
	description = "%player% is currently lazy"
	#The seconds line of text under the app name
	state = "Chilling in the menu"
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#The Server List event
[server_list]
	#Enable/Disable the Server List Event
	enabled = true
	#The first line of text under the app name
	description = "%player% is looking for a server"
	#The second line of text under the app name
	state = "Searching for friends"
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#The Join Game Event
[join_game]
	#Enable/Disable the Join Game Event
	enabled = true
	#The first line of text under the app name
	description = "%player% is joining a game"
	#The second line of text under the app name
	state = "Joining Game"
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#The Single Player Event
[single_player]
	#Enable/Disable the Single Player Event
	enabled = true
	#The first line of text under the app name
	description = "Currently In %world%"
	#The second line of text under the app name
	state = "Playing lonely mode"
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#The Multi Player Event
[multi_player]
	#Enable/Disable the Multi Player Event
	enabled = true
	#The first line of text under the app name
	description = "Playing on %servername% with %players% players"
	#The second line of text under the app name
	state = "Playing online"
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#Fallback event for disabled events
[generic]
	#The first line of text under the app name
	description = "Playing Minecraft"
	#The second line of text under the app name
	state = ""
	#The Asset ID of the image to display as the large image
	largeImageKey = "mclogo"
	#The text that gets displayed when the large image is hovered
	largeImageText = "It's Minecraft %mcver%, but modded"
	#The Asset ID of the image to display as the small image
	smallImageKey = "mclogo"
	#The text that gets displayed when the small image is hovered
	smallImageText = "%mods% mods installed"
	#The buttons to display on Discord
	buttons = []

#World/Dimension Image Overrides
#Leave values empty that you don't want to override
[dimension_overrides]
    enabled = false

    [[dimension_overrides.dimensions]]
        name = "overworld"
        description = "%player% is in The Overworld"
        state = ""
        largeImageKey = "overworld"
        largeImageText = "In the Overworld"
        smallImageKey = "mclogo"
        smallImageText = "%mods% mods installed"
    
    [[dimension_overrides.dimensions]]
        name = "the_nether"
        description = "%player% is in The Nether"
        state = ""
        largeImageKey = "nether"
        largeImageText = "In the Nether"
        smallImageKey = "mclogo"
        smallImageText = "%mods% mods installed"
    
    [[dimension_overrides.dimensions]]
        name = "the_end"
        description = "%player% is in The End"
        state = ""
        largeImageKey = "end"
        largeImageText = "In the End"
        smallImageKey = "mclogo"
        smallImageText = "%mods% mods installed"

# Multi-Language Config Files Available since 1.4

Information

Simple RPC allows for language detection in Minecraft, so If you decide you wanna play Minecraft in a different language, your discord status can now be shown in that language. But it requires some setup, which is why this section exists.

When launching the game for the first time with 1.4 installed, you will find a new folder called simple-rpc inside your .minecraft folder. This is the folder in which you will place your translated config files.

To create a translated config file, copy simple-rpc.toml from your config folder to the simple-rpc folder. To make sure the mod loads the correct config file, you need to rename the file a bit. The new name of your file will now be simple-rpc_lang_code.toml.

To find a complete list of lang-codes, check out this site -> https://minecraft.fandom.com/wiki/Languages.

Once you have created this file, you can change all "state", "description", "largeimagetext" and "smallimagetext" fields. You cannot translate the imagekeys!

Some name examples of languages:

American English -> "simple-rpc-en_us.toml"
Dutch -> "simple-rpc-nl_nl.toml"

Warning: Leave the default config file in english, as the mod falls back to this file when a translated file cannot be found

# Configuration Variables

Information

Variables are pieces of text added to the config file that allows you to display data from the game on your status.

These variables can used inside any 'state', 'description', 'largeImageText', 'smallImageText' and inside buttons.

# Single/Multiplayer Variables (2.5+)

Variable	Description
`%player%`	Shows the Minecraft name of the player
`%world%`	Shows the current world (Dimension): For example overworld/nether/etc
`%mods%`	Shows the total amount of installed mods
`%difficulty%`	Shows the difficulty of the current game
`%position%`	Shows the position of the player
`%biome%`	Show the name of the biome you're in
`%mcver%`	Show the Minecraft Version: For example 1.16.5
`%instance%`	Shows the name of the instance on supported launchers
`%launcher%`	Shows the name of the Launcher on supported launchers
`%server%`	Returns the server IP with _ instead of `.` So 127.0.0.1 becomes 127_0_0_1
`%launchername%`	Get the name of the launcher (if supported) in lower-case
`%savename%`	Shows the name of your world Since 2.6

# Multiplayer Only (2.4+)

Variable	Description
`%serverip%`	Shows the IP/Address of the server the player is playing on (Deprecated. Will be removed soon)
`%servername%`	Shows the name of the server
`%players%`	Shows the amount of online players
`%maxplayers%`	Shows the max amount of players on the server
`%motd%`	Show the Message of the day of the server

These variables only work in multiplayer (lan or online) games