Fire-V-Player

1. Pick how you build your world

Fire-V-Player is a snippet: a ready-made piece you drop into your world. Its name (the "slug") is always:

fire-v-player Copy

Type it exactly like that: all lowercase, with the two dashes. Then pick the way you build your world and follow only that part of this page.

2a. Add it in Unity

You need a Unity project with the Altspace / Banter Creator SDK already set up, and your world's scene open.

1. Make an empty object. In the top menu choose GameObject › Create Empty. Rename it to Fire-V-Player so you can find it later (the name of the object doesn't matter, only the slug does).
2. Put it at the middle of the world. With the new object selected, look at Transform in the Inspector and set Position to 0 0 0 and Rotation to 0 0 0. Why: you don't move the player by moving this object. You move it with the snippet's own settings (step 6). If the object isn't at 0 0 0, the outlines in the Scene view won't line up with where the screen really appears.
3. Add the Snippet component. Click Add Component, type Snippet in the search box, and pick BS › Snippet.
4. Type the slug and press Enter. In the Snippet's Slug box type fire-v-player Copy and press Enter (the box only takes it after Enter or clicking somewhere else). It downloads the player and adds it to your world's Assets/WebRoot/index.html for you. After a moment the Inspector shows the title Fire-V-Player and a list of settings. If nothing happens, click Refresh from server.
5. Save the scene. Press Ctrl + S (Windows / Linux) or Cmd + S (Mac). Do this every time you add or remove a snippet. Closing Unity without saving is the main way extra copies of the snippet end up in index.html.
6. Place the screen. Change the settings in the Inspector, or drag the handles in the Scene view to move the screen, the buttons and the playlist panel. See Settings for what each one does.
7. (Strongly recommended) Install the preview script so you can see the real size and angle of everything while you place it. It takes one minute: Preview script steps.
8. Upload your world the same way you always do, then join it and press Playlist under the screen.

2b. Add it on the website

1. Open your world for editing on altvr.app and go to the Snippets section.
2. Find Fire-V-Player. Set the list to show All snippets, then search for Fire-V-Player (or scroll to it) and open it.
3. Copy it. Click Copy & open index.html. This copies the snippet's code and opens your world's HTML.
4. Paste it in the right place. If your HTML has these two lines, paste between them:

   <!-- snippet section -->
      paste here
   <!-- end snippet section -->

   If it doesn't have them, paste it just before </body>. Paste it once: check there isn't already a <bs-snippet name="fire-v-player" in there.
5. Change the settings by editing the values in quotes in the pasted code, for example volume="10" to volume="30". See Settings.
6. Save, then join your world and press Playlist under the screen.

3. The Unity preview script (optional, Unity only)

A small helper file for the Unity editor. While the Fire-V-Player object is selected, it draws exactly where the player will put things, at their real size and angle, and updates the moment you change a setting:

• Orange: the screen, the row of buttons and the playlist panel.
• Pink: the Singers button (karaoke mode only).

It only runs inside the Unity editor. It never goes into your uploaded world and does nothing for visitors.

Install it

1. Download the file with the button above. It's called FireVPlayerSnippetPreview.cs. Windows: make sure it didn't get saved as FireVPlayerSnippetPreview.cs.txt. Windows hides the end of file names by default; in File Explorer turn on View › Show › File name extensions to check. If it ends in .txt, rename it to end in .cs.
2. Make a folder called Editor. In Unity's Project window, right-click the Assets folder and choose Create › Folder. Name it exactly Editor: capital E, no spaces, nothing else. If you already have an Assets/Editor folder, just use that one.
3. Drag the file into that Editor folder from your Downloads folder (File Explorer on Windows, Finder on Mac). It must end up at Assets/Editor/FireVPlayerSnippetPreview.cs. In any other folder Unity can't build it and shows red errors.
4. Wait for Unity to finish loading (the spinner in the bottom-right corner stops).
5. Click your Fire-V-Player object in the Hierarchy. The orange outlines appear in the Scene view.

4. The settings you'll actually use

In Unity these are in the Snippet's Inspector. On the website they're the values in quotes in the pasted code. You can leave everything else as it is.

Every other setting is explained in the full settings list on GitHub.

5. Using it in your world

The buttons under the screen

From left to right:

The playlist panel

• Press Playlist to open the panel next to the screen.
• Use Search to find a YouTube video, then add it to the playlist or play it. You can also paste a YouTube, Twitch or Vimeo link into the search box.
• In VR, grab the bar under the panel to carry it somewhere else. Pressing Playlist by the screen puts it back.
• More... has the host controls and your own player settings (captions, picture sharpness, auto sync).

Who's in charge (the host)

• The host controls what plays for everyone. If you can't skip or change the video, someone else is the host.
• To become the host, open More... and press Take Over. The host can Lock the player so nobody else can take over, and can turn on Voting so people vote on what plays next.

Karaoke mode

• Whoever runs the karaoke should press Take Over first.
• Singers press Singers, search for a song and press Sing It to join the queue.
• The host starts each singer with Play & Sing, and can move people up or down or remove them.

Help, it's not working

Click a problem to see the fix.