Skip to main content

Atlas Help

Set up the Twitch extension

The Atlas Twitch extension shows a selection of your campaign over your stream's video. Here are the steps, from the subscription to your first publish: you install the extension on Twitch, then, in the streamer space, you connect your channel, prepare your campaign's roster and publish it.

What you need

Before you start, check that you have:

  • a JDR Ninja account and an Atlas subscription;
  • the Twitch channel you stream on;
  • a world and a campaign in the Atlas workshop.

For Atlas subscribers: the extension from the Gobelin tier, character sheets from the Mimique tier. See the plans.

Install the extension on Twitch

You install the extension once on your channel.

  1. Sign in to Twitch with your channel's account, then open the extension's page.

    Open the extension's page on Twitch

  2. Click "Install".
  3. In the Creator Dashboard, open the "Extensions" menu, then the "My Extensions" tab.
  4. Click the extension's "Activate" button, then "Set as Overlay 1". Twitch then shows "Extension is now Active!".

A channel has a single Overlay 1 slot. If another extension already holds it, Twitch shows "You are replacing an active extension": click "Replace" to put the JDR Ninja extension in its place.

The extension only shows while you are live, over your channel's video.

Connect your channel

In the streamer space (the "My tools" menu of your account, "Streamer space" entry), choose "Campaign on Twitch" in the left-hand menu, then click "Connect my Twitch channel".

Open the "Campaign on Twitch" page

Twitch shows its authorization page for the account currently in use on twitch.tv: check that it is the account of the channel you stream on (if not, switch accounts on Twitch), then authorize access. Back on the "Campaign on Twitch" page, the "Twitch channel" box under "Extension settings" shows "Channel connected" and your channel's name.

You can only connect one channel to your JDR Ninja account, and a channel can only be connected to one account. As long as no channel is connected, the same button also appears at the top of the page once a campaign is chosen.

Signing in to JDR Ninja with Twitch does not connect your channel to the extension: they are two separate connections.

Overview of your Twitch connections

The Campaign on Twitch page of the streamer space, with its menu on the left and the Extension settings expanded: first the Presentation settings (extension language, character sheet language, on-screen tabs), then the Twitch channel box, which shows Channel connected and the channel's name.
In "Extension settings", the "Twitch channel" box shows the name of the connected channel, below the "Presentation settings".

Set up the display

On the "Campaign on Twitch" page, expand "Extension settings". The "Presentation settings" apply to all your campaigns:

  • "Extension language": the language of the text your viewers see (French, English, Spanish, German or Italian);
  • "Character sheet language": "Same as the extension" by default, to change if your sheets are in a different language from your stream's;
  • "On-screen tabs": the tabs shown in the extension (Campaign info, Arcs, Characters, Plot hooks).

Click "Save settings". If a campaign is already live, then click "Publish changes" at the top of that campaign's page to apply the new settings.

Prepare the campaign

Open the "Campaign on Twitch" page and choose your campaign; if a campaign is live, or if you only have one, the page opens it directly. To switch to another campaign, use "Change campaign". From the workshop, the "Twitch extension" entry in each campaign's menu, just above "Settings", opens the same page.

The roster is split into three tabs, under "What your viewers see": "Characters", "Arcs" and "Plot hooks". In each tab, to add an item, search for it in the field under the list and click its name; click "Remove" to take it off. Drag the rows to change their order on screen. Each list can hold up to 25 items.

The Campaign on Twitch page open on a campaign: at the top, the publishing box with the Session field, then the What your viewers see card, with the Characters, Arcs and Plot hooks tabs. The Characters tab is open: each row has a handle to move it and a Remove link, and a search field lets you add a character.
The "Session" field and the roster lists, here the "Characters" tab. Drag a row by its handle to move it.

Showing characters and their sheets is included from the Mimique tier. If a character has no portrait, its row shows an "Add a portrait" link.

With the "Session" field, you choose the session you are presenting. Picking a session updates the roster: the characters who took part in that session replace the "Characters" list, and the plot hooks linked to the session replace the "Plot hooks" list. If the session has no participant or no plot hook, the matching list stays as it is. Arcs do not change, and you can then adjust the lists by hand. The default choice, "(none, whole broadcast)", leaves the roster alone and shows every character on the list. With a session picked, a character who did not take part in it is marked "Not in session" and does not appear on air; the "Edit the characters present" link opens the session.

Private arcs and plot hooks in Atlas still show on air if you add them to these lists. Check the lists before you publish.

Publish your campaign

When the lists are ready, click "Publish live" at the top of the page, next to the "Session" field. The badge next to the campaign's title changes from "Offline" to "Live", and in the workshop a green dot appears next to the "Twitch extension" entry in the campaign's menu.

The Campaign on Twitch page open on a live campaign: the Live badge next to the campaign's title, the On air since label followed by the date, and the Publish changes and Stop publishing buttons.
A live campaign: the "Live" badge next to the title, the date the publication started and the two buttons.

The extension does not update by itself. After a change (a list, the session, a setting, a character sheet), click "Publish changes": your viewers see the change within a minute.

At the end of the stream, click "Stop publishing", next to "Publish changes".

Only one campaign can be live on your channel. If another campaign already is, the page says so at the top: stop that campaign's publication first. You can prepare the lists in the meantime.

What your viewers see

While you are live, the extension shows over the video in a collapsible card, with the tabs picked in "On-screen tabs". Your viewers can open each character's sheet from it.

The extension over a stream: the card open on the Campaign tab, with the current arc and the campaign's summary.
The card opens on the "Campaign" tab: the current arc and your campaign's summary.
The extension on a stream: the campaign card open on the Characters tab, with the party's row of characters and one character's sheet (classes, armor class, hit points, abilities, skills).
The "Characters" tab: the party's row, then the chosen character's sheet.
The collapsed extension over a stream: only a small round button marked JDR remains, at the top left of the video.
A viewer can collapse the card: only a button remains, which opens it again.

As long as no campaign is live on your channel, the extension shows a demo campaign, labelled "Demo". Your campaign replaces it within a minute of clicking "Publish live".

The extension of a channel with no campaign live: the demo campaign Les Cendres de Valmorne, with the Demo badge and a sentence explaining that the channel's GM can show their own campaign.
The demo campaign in French, "Les Cendres de Valmorne": each viewer sees it in their own Twitch language.

Your campaign shows in the "Extension language" you picked. The demo follows each viewer's Twitch language.

Troubleshooting

Your viewers still see the demo campaign
Check that publishing has started (the "Campaign on Twitch" page shows "Live" next to the campaign's title), that your Atlas subscription is active, and that the channel shown in "Extension settings" is the one you stream on. In the Creator Dashboard, the extension's "Configure" button opens a page that tells you whether a campaign is being broadcast on your channel.
A change does not show on air
Changes are not sent automatically: click "Publish changes" at the top of the campaign's page, then wait a minute. If the page shows "The last publish attempt failed", try again in a moment.
A character does not show
Check that the character is in the "Characters" tab of the roster and not marked "Not in session", that the Characters box is ticked in "On-screen tabs", and that your tier includes character sheets (Mimique and above). Then publish the changes.
The extension does not show over the video
The extension only shows during a live stream. If you are live, open the "Extensions" menu of the Creator Dashboard, "My Extensions" tab: the extension must be activated as Overlay 1, not just installed. If you later activated another extension as Overlay 1, it replaced the JDR Ninja extension: reactivate the JDR Ninja one with "Set as Overlay 1".
The extension shows "Connection problem"
On a slow connection, the card can show this message while it loads, sometimes with the sentence "This channel has no active extension access." Your subscription is not the cause: click "Retry" in the card, or reload the channel page.

Continue

My worlds See the plans