Oronder provides deep Discord integration for Foundry Virtual Tabletop. Access your character sheets, roll for downtime activities, schedule sessions and reward exp directly from Discord. No struggling with Foundry from your phone. No need for Foundry to be actively running.
Oronder is designed to meet the needs of running a complex Westmarches game with multiple DMs and players, but also shines for single party campaigns.
Supported Systems
- Dungeons & Dragons Fifth Edition (
dnd5e) - Pathfinder Second Edition (
pf2e) - Call of Cthulhu 7th Edition (
CoC7)
Installation Instructions
The following must be done by the owner of the Discord server you'd like to integrate with.
- Subscribe to the Oronder Discord to gain access to advanced features and support.
- Install and enable the Oronder Foundry Module.
- From your Foundry instance, select
Game Settings→Configure Settings→Oronder→Configure Oronder.- Click the button to invite Oronder's App to your Discord Server.
- A popup will ask you to select the server and verify permissions. Opera GX users or others with non-standard popup blockers may need to follow the instructions here.
- Associate Foundry Users to their associated Discord User.
- Oronder will automatically assign matching names, but the rest are up to you.
- Configure Channels. Leaving them all set to #general is ok.
- NOTE: If you configure Oronder to use private channels, you must invite Oronder to those channels!
- Click
Save Changes.
- Click the button to invite Oronder's App to your Discord Server.
Players should now be able to access characters they own in Foundry from Discord. If a PC is not showing up, ensure that player ownership has been assigned and that the character is complete enough to sync:
- dnd5e: a level, class, race and background.
- pf2e: an ancestry and class.
- Call of Cthulhu: characteristics.
Self-Hosting
By default the module talks to Oronder's own server at https://api.oronder.com and there is nothing to configure.
If you run your own Oronder server, point the module at it in Game Settings → Configure Settings → Oronder →
Oronder Server: your server's address, e.g. https://oronder.example.com. Blank means Oronder's server. It takes
effect after a reload.
Your server has its own Discord application, and that application has to allow the module to pair with it:
- In the Discord Developer Portal, open your application →
OAuth2→Redirects. - Add the redirect your server reports at
<your server>/config, usually<your server>/init, spelled exactly. Otherwise pairing fails at Discord's consent screen with Invalid OAuth2 redirect_uri. - Use a hostname with a domain suffix. Discord rejects bare hostnames such as
http://my-server:65435/initwith Not a well formed URL. - Under
Bot, enable Public Bot only if people other than you need to invite it to their own Discord servers. If you're running Oronder for your own server, leave it off.
Note that an Oronder token is only valid on the server that issued it, so changing the Oronder Server setting means pairing with Discord again.
