Discord RPC - API Documentation

Comprehensive API documentation for Nexos Creation projects and tools.

Published: October 01, 2024 | Updated: December 02, 2024

🎮 Discord RPC Status

✅ Connect to the Server

Establishes a connection between the client and the Discord RPC service.

Request:

curl -X GET https://api.nexoscrafting.live/discord-rcp/connect

Response:

{
  "status": "connected",
  "message": "Successfully connected to Discord RPC"
}

🏷️ Set Discord Presence

Updates the user's Discord Rich Presence with custom status details.

Request:

curl -X POST https://api.nexoscrafting.live/discord-rcp/set-presence \
  -H "Content-Type: application/json" \
  -d '{
        "state": "Playing on NexosCraft",
        "details": "Mining Diamonds ⛏️",
        "largeImageKey": "minecraft_logo",
        "smallImageKey": "diamond_pickaxe"
      }'

Request Parameters:

Parameter	Type	Description
`state`	string	Short status (e.g., "Exploring the Nether")
`details`	string	Detailed activity description
`largeImageKey`	string	Key for large Discord asset image
`smallImageKey`	string	Key for small Discord asset image

Response:

{
  "status": "success",
  "message": "Presence updated successfully"
}

❌ Clear Discord Presence

Removes the current Rich Presence from Discord.

Request:

curl -X POST https://api.nexoscrafting.live/discord-rcp/clear-presence

Response:

{
  "status": "success",
  "message": "Presence cleared"
}

🔌 Disconnect from Server

Terminates the connection with Discord RPC.

Request:

curl -X POST https://api.nexoscrafting.live/discord-rcp/disconnect

Response:

{
  "status": "disconnected",
  "message": "Successfully disconnected from Discord RPC"
}