Skip to content

Discord Rich Presence

Thanks to Discord Rich Presence, you can customize your server appearance for players that have enabled ingame activity. To do that, you can use Discord and DiscordRichPresence classes.

  • Discord class can be used to update rich presence, or reinitialize the displayed discord application.
  • DiscordRichPresence class holds different rich presence features, that you can set.

If you want your server to be displayed as a separate discord application:

  • login to Discord Developer Portal
  • create a new application, name it as you wish
  • (optional) set the icon for your app
  • (optional) upload and name custom images that you can later use as large image and/or small image in Rich Presence tab
  • use Discord::recreate method to reinitialize rich presence with your custom app id.

Examples

Classic

Code

addEventHandler("onInit", function()
{
    DiscordRichPresence.state = "State"
    DiscordRichPresence.details = "Details"

    DiscordRichPresence.largeImageKey = "YOUR_LARGE_IMAGE_NAME_OR_URL"
    DiscordRichPresence.largeImageText = "YOUR_LARGE_IMAGE_HOVER_TEXT"

    DiscordRichPresence.smallImageKey = "YOUR_SMALL_IMAGE_NAME_OR_URL"
    DiscordRichPresence.smallImageText = "YOUR_SMALL_IMAGE_HOVER_TEXT"

    Discord.recreate("YOUR_APP_ID")
    Discord.updatePresence()
})

Image

Image explaining visually standard discord rich presence features

Party

Code

addEventHandler("onInit", function()
{
    DiscordRichPresence.state = "State"
    DiscordRichPresence.details = "Details"

    DiscordRichPresence.partyId = "YOUR_PARTY_ID"

    DiscordRichPresence.largeImageKey = "YOUR_LARGE_IMAGE_NAME_OR_URL"
    DiscordRichPresence.largeImageText = "YOUR_LARGE_IMAGE_HOVER_TEXT"

    DiscordRichPresence.smallImageKey = "YOUR_SMALL_IMAGE_NAME_OR_URL"
    DiscordRichPresence.smallImageText = "YOUR_SMALL_IMAGE_HOVER_TEXT"

    Discord.recreate("YOUR_APP_ID")
    Discord.updatePresence()
})

Image

Image explaining visually discord rich presence party

Party with players

Code

addEventHandler("onInit", function()
{
    DiscordRichPresence.state = "State"
    DiscordRichPresence.details = "Details"

    DiscordRichPresence.partyId = "YOUR_PARTY_ID"
    DiscordRichPresence.partySize = 2
    DiscordRichPresence.partyMax = 4

    DiscordRichPresence.largeImageKey = "YOUR_LARGE_IMAGE_NAME_OR_URL"
    DiscordRichPresence.largeImageText = "YOUR_LARGE_IMAGE_HOVER_TEXT"

    DiscordRichPresence.smallImageKey = "YOUR_SMALL_IMAGE_NAME_OR_URL"
    DiscordRichPresence.smallImageText = "YOUR_SMALL_IMAGE_HOVER_TEXT"

    Discord.recreate("YOUR_APP_ID")
    Discord.updatePresence()
})

Image

Image explaining visually discord rich presence party with players

One button

Code

addEventHandler("onInit", function()
{
    DiscordRichPresence.state = "State"
    DiscordRichPresence.details = "Details"

    DiscordRichPresence.largeImageKey = "YOUR_LARGE_IMAGE_NAME_OR_URL"
    DiscordRichPresence.largeImageText = "YOUR_LARGE_IMAGE_HOVER_TEXT"

    DiscordRichPresence.smallImageKey = "YOUR_SMALL_IMAGE_NAME_OR_URL"
    DiscordRichPresence.smallImageText = "YOUR_SMALL_IMAGE_HOVER_TEXT"

    DiscordRichPresence.button1.active = true
    DiscordRichPresence.button1.label = "Join"
    DiscordRichPresence.button1.url = "YOUR_JOIN_URL"

    Discord.recreate("YOUR_APP_ID")
    Discord.updatePresence()
})

Image

Image explaining visually discord rich presence with one button

Two buttons

Code

addEventHandler("onInit", function()
{
    DiscordRichPresence.state = "State"
    DiscordRichPresence.details = "Details"

    DiscordRichPresence.largeImageKey = "YOUR_LARGE_IMAGE_NAME_OR_URL"
    DiscordRichPresence.largeImageText = "YOUR_LARGE_IMAGE_HOVER_TEXT"

    DiscordRichPresence.smallImageKey = "YOUR_SMALL_IMAGE_NAME_OR_URL"
    DiscordRichPresence.smallImageText = "YOUR_SMALL_IMAGE_HOVER_TEXT"

    DiscordRichPresence.button1.active = true
    DiscordRichPresence.button1.label = "Download client"
    DiscordRichPresence.button1.url = "YOUR_DOWNLOAD_URL"

    DiscordRichPresence.button2.active = true
    DiscordRichPresence.button2.label = "Join"
    DiscordRichPresence.button2.url = "YOUR_JOIN_URL"

    Discord.recreate("YOUR_APP_ID")
    Discord.updatePresence()
})

Image

Image explaining visually discord rich presence with two buttons