From df8b9e5f6506a6a9e5a5ddbde015252e0ad88702 Mon Sep 17 00:00:00 2001 From: Yannik <80621863+vaporvee@users.noreply.github.com> Date: Sun, 23 Apr 2023 13:01:36 +0200 Subject: [PATCH] Updated Readme.md for release --- README.md | 37 ++++++++++++++++++++++++++++++++++++- 1 file changed, 36 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 437bb72..3cce573 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,45 @@ # discord-rpc-godot -dont forget to run the following command if you clone this project or the godot-cpp folder will be empty +### This is version 1.0! In future versions there will be lobbies, invites, linux builds etc. very soon! +Don't forget to run the following command **if you clone this project** or the godot-cpp folder will be empty ```sh git submodule update --init ``` +# Addon Usage :rocket: +1. Put the `discord-sdk-gd/` folder in a `addons/` folder in your Godot project +2. Enable the addon in your Project Settings under "Plugins" and "DiscordSDK". (if it doesn't show up reopen the project) +3. Create an Application under https://discord.com/developers/applications and get the Application ID +4. (optional) Set images under "Rich Presence" and "Art Assets" and remember the keys +5. Exporting: You need to copy the `discord_game_sdk.dll` or on linux `discord_game_sdk.so` from `res://addons/discord-rpc-gd/bin/PLATFORM/discord_game_sdk.[dll/.so]` to your exported project in the same directory as `discord_game_sdk_binding_debug.[dll/.so]` +```gdscript +extends Node + +func _ready(): + Discord_Activity.app_id = 1099618430065324082 # Application ID + Discord_Activity.details = "A demo activity by vaporvee#1231" + Discord_Activity.state = "Checkpoint 23/23" + + Discord_Activity.large_image = "game" # Image key from "Art Assets" + Discord_Activity.large_image_text = "Try it now!" + Discord_Activity.small_image = "boss" # Image key from "Art Assets" + Discord_Activity.small_image_text = "Fighting the end boss! D:" + + Discord_Activity.start_timestamp = int(Time.get_unix_time_from_system()) # "02:41 elapsed" + #Discord_Activity.end_timestamp = 2492978400 # "15:41 left" (but currently 31. 12. 2048 in unix time) + + Discord_Activity.refresh() # Always refresh after changing the values! + +``` +#### Then it should look like this: + + +## Extra Info +- "Step 2" (enabling the addon) is needed to add `Discord_Activity.coreupdate()` to a `_process()` function with a singleton. This function is needed by pretty everything but you can it also just add it yourself. +- The Discord SDK itself doesn't build under Linux for some reason (I don't have a Mac so i don't even know if it's builds under OSX) its not well documented but I try as hard as i can to get it working crossplatform but at the time its only working under Windows... (But feel free to make pull requests btw) +- Its an early release some features aren't implemented only because i need a small amount of time not because it's not possible + +

### Credit