Getting started
Ethereal Plane connects your Foundry world to your stream account. This setup has two parts: connect the Foundry installation, then log into your account from that installation.
Install and open Setup
Section titled “Install and open Setup”- Install Ethereal Plane through Foundry’s module installer. This release supports Foundry 13 through 14.
- Launch your world and enable Ethereal Plane in Manage Modules.
- In Settings → Configure Settings → Ethereal Plane, click Open Setup Menu.
Keep Enable Module enabled when you want the connection running. Enable Triggers separately controls whether stream events execute your assigned macros.
Connect this Foundry installation
Section titled “Connect this Foundry installation”In Setup, find Server Settings.
- If you don’t have an Ethereal Plane account, use Account Setup to create one.
- Click Connect in Foundry.
- Follow the website’s request to add this Foundry installation to your account.
- Return to Foundry. The connection controls should now offer Log in and Disconnect.
You connect an installation once. Other people logging into their accounts on the same Foundry server don’t need to register the installation again.
Log into your account
Section titled “Log into your account”- Click Log in.
- In the login window, click Open, use Copy to open the address in another browser, or scan the QR code.
- Check that the code shown on the website matches the code in Foundry’s window.
- Sign into your Ethereal Plane account and confirm the request.
- The Foundry login window closes automatically when login succeeds.
Use the code from your own login window, not the example screenshot. If it expires, close the window and click Log in again for a new one.
Check the connection indicators
Section titled “Check the connection indicators”These indicators describe separate connections:
| Indicator | When to expect it to be active |
|---|---|
| Polls | While a poll is running. It can be inactive between polls. |
| Chat | When a direct chat-reading connection is being used. Sending messages or using chat-command triggers alone doesn’t require this indicator to be active. |
| Triggers | When trigger processing is connected and enabled. |
An inactive indicator doesn’t mean every feature is disconnected. Check the feature you’re trying to use.
Choose a first feature
Section titled “Choose a first feature”- Send public rolls to chat and customise their message template.
- Run a poll and optionally attach a macro to its winning choice.
- Create a chat command or channel-point trigger and assign a Foundry macro.
If a feature doesn’t work, check Enable Module, the installation connection and your account login before configuring it again. The feature guides cover their separate settings.




