discord-rpc/README.md

Discord RPC

This is a lib and a quick demo that implements the very minimal subset to show current status, and have callbacks for where a more complete game would do more things. You can use the lib directly if you like, or use it as a guide to writing your own if it doesn't suit your game as is.

PRs/feedback welcome if you have an improvement everyone might want, or can describe how this doesn't meet your needs.

Usage

Zeroith, you should be set up to build things because you are a game developer, right?

First, head on over to the Discord developers site and make yourself an app. Keep track of Client ID -- you'll need it here to pass to the init function.

From package

Download a release package, extract it, add /include to your compile includes, /lib to your linker paths, and link with discord-rpc.

From repo

There's a CMake file that should be able to generate the lib for you; I use it like this:

    cd <path to discord-rpc>
    mkdir build
    cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=<path to install discord-rpc to>
    cmake --build . --config Release --target install

Sometimes I use the generated project files. There are a couple of CMake options you might care about:

flag	default	does
ENABLE_IO_THREAD	ON	When enabled, we start up a thread to do io processing, if disabled you should call Discord_UpdateConnection yourself.
BUILD_DYNAMIC_LIB	OFF	Build library as a DLL

Sample: send-presence

This is a text adventure "game" that inits/deinits the connection to Discord, and sends a presence update on each command.