A Unity sample project demonstrating integration with the Discord Social SDK designed with best practices in mind.
Preview.mov
This sample showcases many Discord Social SDK features in a complete, interactive Unity scene:
- Account Linking & Authentication - Discord OAuth2 integration with secure token storage
- Friends List - Display and interact with Discord friends lists
- Rich Presence - Dynamic Discord activity cards with lobby and invite integration
- Game Lobbies - Create, join, and manage multiplayer lobbies
- Game Invitations - Send deep-link invites to friends for instant lobby joining
Planned features that haven't been implemented yet:
- Direct Messaging - In-game messaging
- Linked Channels - Connect game chat to Discord server channels
- User Profiles - Fetch and display Discord user information
How do I create friends list for my game and keep it updated and sorted?
Using the Discord Social SDK you can fetch a player's friends list and display it in your game. This sample demonstrates how to fetch the friends list, display each friend's username, status, and avatar, and keep it updated in real-time. It also shows how to sort friends by their online status and username.
How do I handle performance with a friends list in my game?
By sorting friends client-side and only updating the UI when there are changes, you can create a responsive friends list. This sample keeps the friends list updated in real-time by only updating the UI for an individual player when their info changes and then sorts them into the proper position in the UI. It doesn't create or destroy any UI elements once they've been initialized.
How can I make my game more discoverable? How can I help my game go viral?
Using Rich Presence makes it easy for friends to see what you're playing and join in directly from Discord. Allowing invites through your game's UI lets players invite their friends through the game or Discord. With Discord being the social platform for gamers, integrating the Discord Social SDK makes it easy for players to connect and play together, increasing your game's visibility and player base.
- Unity 6 or later
- Discord Developer Account
-
Clone the Repository
git clone https://github.com/discord/social-sdk-unity-sample.git
or download the ZIP file from the GitHub repository.
-
Open in Unity
- Launch Unity Hub
- Click "Add" and select "DiscordSocialSDKUnitySample" from the cloned repository or extracted ZIP
- Open the project
-
Configure Your Discord Application
- Visit the Discord Developer Portal
- Create a new application or use an existing one
- Navigate to the Discord Social SDK > Getting Started section
- Fill out the form
- Click Submit and the Social SDK will be enabled for your application
- Navigate to the OAuth2 tab:
- Under "Client information" enable Public Client
- Under "Redirects" add a redirect URL
http://127.0.0.1/callback
- Navigate to Discord Social SDK > Downloads
- Download the latest SDK (
DiscordSocialSdk-UnityPlugin-X.X.X.zip) - Either:
- Unzip the zip file in the Unity Packages folder, or
- Unzip the zip file and Install Package from Disk. Make sure the folder is in a directory that won't get moved or deleted as your Unity project will load it from that location.
-
Configure the Sample
- In Unity open the Example scene
- In your asset folder right click > Create > Config > Discord Social SDK
- Click on the Social SDK Config and paste your Application ID found under "General Information" from the application you created in the Discord Developer Portal
- Drag your Discord Social SDK Config into the DiscordManager object in the scene
-
Run
- Press the play button to test it in the Editor
- Click on the "Connect to Discord" button in the UI
- Discord or the browser should open to authorize the application
- After authorizing, you should see your Discord friends list show up in the sample and your Rich Presence should update to show you are playing the sample game
- You will also see all logging in the Unity Console
The type or namespace name 'Discord', 'Client', etc... could not be found (are you missing a using directive or an assembly reference?)
If you see errors related to missing types or namespaces, it likely means that the Discord Social SDK is not installed correctly. Make sure you followed all the setup instructions and that the SDK is properly imported into your Unity project.
On Mac you may get the error "libdiscord_partner_sdk.dylib" Not Opened because Apple couldn't verify it. If this happens press Done on the popup. You'll need to open your System Settings > Privacy & Security and scroll down to the Security section. It will tell you "libdiscord_partner_sdk.dylib" was blocked to protect your Mac. Press Open Anyway and try running again. Now when you get the pop up you'll have the option to select Open Anyway and it will be able to use it successfully.
If nothing happens when you click the "Connect to Discord" button, make sure you have a DiscordManager in your scene and that it has a valid DiscordSocialSdkConfig assigned. You can find the DiscordManager prefab already set up for you in the Prefabs folder. Also check the Unity Console for any errors.
You'll see this warning if you open the project in a different version of Unity than it was created with. It's safe to ignore as long as you're opening the sample in a compatible version (Unity 6+). You can press "Continue" and you might get another modal saying "URP Material upgrade" which you can safely press "Ok" on.
This sample creates easy to use prefabs that can be used to build out parts of the Discord Social SDK. The central piece is the DiscordManager which handles the connection to Discord and provides access to the SDK features. In order to use the DiscordManager, you need to create a DiscordSocialSdkConfig Scriptable Object with the Application ID from the Discord Developer Portal and assign it to the DiscordManager. The friend list is built using the FriendsList prefab, which contains the logic to fetch and display friends. Each friend is represented by a FriendUI prefab that shows their username, status, and profile picture. Rich Presence is handled by the RichPresence prefab, which updates the user's activity status in Discord. The Lobby prefab allows the player to create and leave a lobby which will update their Rich Presence and allow their friends to request to join their lobby through the Discord client. Each prefab is easy to drop into your scene and customize as needed.
- Friends List Designs - UI/UX reference used in this sample
- Discord Brand Design Guidelines - Official branding resources
We welcome contributions! Please see our Contributing Guide for details.
This project is licensed under the Discord Social SDK Terms. See the LICENSE file for details.
Built with ❤️ by the Discord Developer Relations team
Questions? Check out the #social-sdk-dev-help channel in the Discord Developers server!