Skip to content

Latest commit

 

History

History
110 lines (75 loc) · 2.65 KB

readme.md

File metadata and controls

110 lines (75 loc) · 2.65 KB
Raw

Discord RPC

A pure Java implementation of the now defunct discord-rpc sdk.

This library has the same features as the original DLL versions, but with notable changes:

  • Pure java implementation, without the need for JNA or JNI (except for older java versions, where junixsocket uses it)
  • Apple Silicon support

Features

  • Setting Rich Presence
  • Listen for Join, Spectate and Join-Requests
  • Specify the Activity type (Watching, Playing, Competing, etc)
  • Automatic reconnects when switching user accounts
  • 100% pure java
  • Supports Java 8-21
  • Specifically designed for use in Minecraft mods

Getting Started

badge

First, add our maven repository

maven {
    name "FDD Maven"
    url "https://maven.firstdark.dev/releases"
}

Next, add the required dependency:

// For Java 16+
implementation "dev.firstdark.discordrpc:discord-rpc:VERSION"

// For Java older than 16
// implementation "dev.firstdark.discordrpc:discord-rpc:VERSION:legacy"

Note:

legacy uses JUnixSockets to handle the discord communication. The Java 16+ jar uses java NIO to communicate with the sockets

Example

DiscordRpc rpc = new DiscordRpc();
rpc.setDebugMode(true);

DiscordEventHandler handler = new DiscordEventHandler() {
    @Override
    public void ready(User user) {
        System.out.println("Ready");
        DiscordRichPresence presence = DiscordRichPresence.builder()
                .details("Hello World")
                .largeImageKey("gear")
                .activityType(ActivityType.WATCHING)
                .button(DiscordRichPresence.RPCButton.of("Test", "https://google.com"))
                .build();

        rpc.updatePresence(presence);
        System.out.println(user.getUsername());
    }

    @Override
    public void disconnected(ErrorCode errorCode, String message) {
        System.out.println("Disconnected " + errorCode + " - " + message);
    }

    @Override
    public void errored(ErrorCode errorCode, String message) {
        System.out.println("Errored " + errorCode + " - " + message);
    }

    @Override
    public void joinGame(String joinSecret) {

    }

    @Override
    public void spectateGame(String spectateSecret) {

    }

    @Override
    public void joinRequest(DiscordJoinRequest joinRequest) {

    }
};

rpc.init("1000773209924317265", handler, false);

This library and code is licensed under the MIT license, same as the original discord SDK.

If you need more help, visit our discord