Docs
  • 🍎Stream Avatars
    • Introduction
    • ⏩Quick Setup
    • 📸How to Overlay
      • OBS
      • Streamlabs Desktop
      • XSplit
      • Twitch Studio
      • Unlisted / Other
    • ⚛️Extension
    • ⏩Quick Guide
    • 📬Commands
      • ❗!commands
      • ↕️Selection Commands
        • !random
          • !mass random
          • !change {user} {command} random
        • !avatars
          • !avatar {avatar}
          • !change {user} !avatar {avatar}
          • !change {user} !avatar {avatar} {timer}
          • !mass avatar {avatar}
          • !mass avatar {avatar} {timer}
        • !color
        • !gear
        • !nametags
        • !actions
        • !show
      • ↕️Minigames and Fun Commands
        • !basketball
        • !battleroyale
        • !boss
        • !duel {user} {amount}
        • !slots {amount}
        • !bomb {user}
        • !sling {power} {angle}
        • !fart
        • !quote {#}
        • !roll {#d#}
        • !8ball {question}
        • !freeze {user} {seconds}
        • !pin {user} {x%} {y%} {seconds}
        • !attack {user}
        • !dance
        • !hug {user}
        • !throw
        • !explode {target}
        • !bet {amount} {calltype}
        • !scale {target} {size}
        • !spawn game
        • !screensaver {seconds}
        • ↕️!mass {command}
      • ↕️Shop Commands
        • !shop
        • !buy avatars
        • !buy colors
        • !buy gear
        • !buy nametags
        • !buy actions
      • ↕️Currency Commands
        • !currency
        • !currency add {user} {amount}
        • !currency remove {user} {amount}
        • !currency give {user} {amount}
      • ↕️Gifting Commands
        • !gift {user} lootbox {name}
        • !gift {user} avatar {avatar}
        • !gift {user} gear {gear_set} {gear_piece}
        • !gift {user} color {avatar} {color}
        • !gift {user} nametag {nametag}
        • !gift {user} all true
        • !currency add {user} {amount}
      • ↕️Remove Ownership Commands
        • !remove {user} avatar {avatar}
        • !remove {user} gear {gear_set} {gear_piece}
        • !remove {user} color {avatar} {color}
        • !remove {user} nametag {nametag}
        • !currency remove {user} {amount}
      • !extension
      • !hideavatar
      • !mass {command}
      • !change {user} {command}
      • !spawn {title}
      • !whitelist add {user}
      • !blacklist add {user}
      • !mod add {user}
      • !leaderboard
      • !leaderboard exclude {user}
      • !game exclude {user}
      • !sounds
      • !shoutout {user}
    • 📃Application Settings
      • General
      • Login Details
      • Minigames
      • Avatars And Gear
      • Sounds
      • Nametag Settings
      • Import & Export
      • Shop Editing
      • User Editing
      • ❗Unfinished Docs!
      • ❗Bot Commands
        • ❗Custom Commands
      • ❗Edit Lootboxes
      • ❗Backgrounds
      • ❗Bot Commands
    • 🎨Content Creating
      • Creating Avatars
      • Extension Sorting Order
      • Deleting Avatars, Palettes/Colors, and Gear
      • Creating Gear
      • Creating Colors
      • Creating Backgrounds
      • Creating Bosses
      • Creating Player Classes (boss)
      • Creating Nametags
      • Creating Lootboxes
      • Importing Scripts
      • Importing Private Content
      • Creating Custom Redemptions
      • Creating Extension Thumbnails
      • Creating Custom Language Localization
    • 💫Integrations
      • Stream Deck
    • ❓Support
      • New Platform Additions
      • Various Troubleshooting
      • Data Folder
      • Beta Branch
      • F.A.Q
      • Crash Log - Event Viewer
    • 🤝Stream Avatars Partner
  • ⚙️LUA Scripting API
    • Introduction
    • Quick Start
    • API Reference & Tips
      • 🌎Global Functions
        • log
        • wait
        • yield
        • yieldBreak
        • async functions
        • waitForAsync function
        • stopAsync function
        • get
        • set
        • applyImage
        • waitForAnimation
        • webrequest get/post
        • getUser
        • getUsers
        • getUserById
        • getCurrency
        • addCurrency
        • removeCurrency
        • adjustCurrency
        • getBackground
        • getScriptableBlocks
        • getAvatar
        • getAllAvatars
        • runCommand
        • writeChat
        • setProperty
        • getApp
        • save
        • load
        • addEvent
        • removeEvent
        • keepAlive
      • 🔫Events
        • BankController
        • ServiceController
        • Read Chat
        • Websockets
        • Scriptable Block Trigger
        • Platform Donation
        • App State Change
        • Custom Command
        • Basketball Outcome
        • BattleRoyale Outcome
        • Boss Battle Outcome
        • Boss Battle Player Joined
        • Duel Outcome
        • On JumpCatch Star
        • On Background Switch
        • On Avatar Change
        • On New Viewer
        • On InitializeNewViewer
        • On Follower
        • On Raid
        • On Subscriber
        • On Avatar Spawn
        • On Trigger Object
        • On Hotkey
        • On Purchase
      • 📦Classes
        • App
          • globalAvatarScale {get;set}
          • globalNametagScale {get;set}
          • globalChatBubbleScale {get;set}
          • globalNametagStack {get;set}
          • getResolution
          • platformServiceSettings
          • setResolution
          • setFullscreen
          • getStreamer
          • convertPositionToPercent
          • convertPercentToPosition
          • playSound
          • createBomb
          • pitchSound
          • stopSound
          • soundIsPlaying
          • createGameObject
          • getGameObject
          • createChatBubble
          • createWebsocket
          • removeWebsocket
          • sendWebsocketMessage
          • getAppState
          • sha256_base64
          • getUserFromData
          • getIdsFromData
          • deleteUser
          • exportAvatarImage
          • translateCommand
        • User
          • id {get}
          • isActive {get}
          • isFake {get}
          • lastActiveDate {get}
          • secondsSinceLastActive {get}
          • displayName {get}
          • channelName {get}
          • follower {get}
          • vip {get}
          • subscriber {get}
          • moderator {get}
          • platformModerator {get}
          • platform {get}
          • streamer {get}
          • avatar {get;set}
          • scale {get;set}
          • override_scale {get;set}
          • color {get;set}
          • nametag {get;set}
          • getState
          • getGear
          • setGear
          • setPosition
          • getPosition
          • getWearableAvatars
          • getWearableAvatarColors
          • getWearableGearSetPieces
          • getWearableNametags
          • setTemporaryAvatar
          • setTemporaryColor
          • setTemporaryNametag
          • setTemporaryGear
          • setTemporaryNone
          • clearAllTemporarySelections
          • chatBubble
          • runCommand
          • physics
          • saveUserData
          • loadUserData
        • Physics
          • grounded {get;set}
          • setVelocity
        • ObjectPhysics
          • hasTrigger {get}
          • hasRigidBody {get}
          • layer {get;set}
          • kinemetic {get;set}
          • setVelocity
          • addBoxCollider
          • addCircleCollider
          • addBoxTrigger
          • addCircleTrigger
        • Avatar
          • name {get}
          • getGear
          • getGearPieces
          • getColors
          • getActions
        • GameObject
          • image {get}
          • destroy
          • setAngle
          • setPosition
          • getPosition
          • adjustPosition
          • getScale
          • setScale
          • adjustScale
          • physics
        • Image
          • playAnimation
          • stopAnimation
          • flipX
          • flipY
          • sorting
          • anchor
        • ScriptableBlock
          • id {get}
          • position
      • 📤Helper Class
        • createCooldown
        • checkCooldown
        • setCooldown
        • cooldownTimeLeft
        • startsWith
        • replace
        • split
        • randomElement
        • hasValue
        • matchRegex
Powered by GitBook
On this page
  • About
  • How to Install
  • How to manage extension settings
  • Announce Extension Link
  • Extension upload limit
  • How to buy more upload
  • Disable Avatars Many Avatars Quickly
  • Organizing Extension Selection Items
  • Trouble-shooting problems
  1. Stream Avatars

Extension

PreviousUnlisted / OtherNextQuick Guide

Last updated 2 years ago

About

The extension panel for SA is a graphics interface for viewers to customize their avatar and run commands or animations with their avatar silently by clicking buttons rather than typing in chat.

This is an accessibility addon that is highly recommended but completely optional, it's good for exploring options related to avatars and keeping your chatroom quiet from command spam.

How to Install

By default, SA will have your extension enabled.

Twitch has a which allows you to embed the extension directly onto the page.

For other platforms (Trovo, Facebook, Dlive, Youtube, Glimesh), you may need to use the in your chatroom (while the app is connected) to receive a link to your channels pop-out extension page. There's also settings below to periodically paste this link into your chat found further down on this page.

If you are streaming to multiple platforms, your extension page will have a unique url per platform. To get the correct extension page for a specific platform, use the chatroom to run the .

You can also in your chat for your viewers.

How to manage extension settings

Navigate to: General > Viewer Extension Panel

To disable the extension, toggle the "Interactable viewer extension" off.

Announce Extension Link

How to periodically paste the extension link into your chat for your viewers to use:

Extension upload limit

Q: Why do I have a limited amount?

A: The extension server costs money to maintain. To keep the cost minimal there is a maximum amount of upload space for each user.

How to buy more upload

Disable Avatars Many Avatars Quickly

Q: How to disable avatars between each stream:

A: Create an avatar profile. This allows you to keep your avatars but temporarily disable them.

Organizing Extension Selection Items

You can set the order that your avatars, gear, colors, and nametags appear in the extension by doing the following.

  1. Visit the editing area for the item you wish to sort.

  2. Example: to edit avatar order, visit Avatar and Gear > Click the option button beside the avatar selection > Click Sorting.

Re-order the avatars by entering a number on each one individually. (It will shift other avatars index-order to accommodate for the newly inserted avatar's index)

Trouble-shooting problems

If a viewer is saying their extension page never loads, check the following:

  • The extension server might be having problems and will be back online shortly.

  • The Stream Avatars application must be open and connected on the streamer's computer!

  • Is their avatar currently spawned in the application? It needs to be. Check your spawn settings in General > Viewer Spawning.

  • Make sure the viewer's computer clock is automatically synced, sometimes the out of sync causes issues with the authorization process. (image below)

If you have too many avatars, gear, palettes, or nametags, you may need to , , , or to have unlimited space.

Disabling the extension means your viewers will need to rely exclusively on commands for and .

There's a in the application where you can pay a low amount for a massive increase of upload space. Make sure to link your account with Stream Avatars in the application to gain the benefits.

Alternatively, you can buy the for a permanent increase, however it is not as much upload space.

Make sure the extension is enabled! You can find the setting for that here: .

If their Avatar is still not spawning, the viewer might have accidentally entered . Type it again to toggle lurk mode.

🍎
⚛️
selecting avatars
doing actions
patreon link
DLC for extra upload on steam
lurk mode with a chat command
delete some
disable some
buy more upload space
disable the extension entirely
Extension Settings
channel add-on
!extension command
!extension command
periodically paste the extension link
#3 is how you would disable the extension communications.
toggle the announce extension link on.
Found under: General > Viewer Extension Panel
extension example image
Twitch install page. Creator Dashboard > Extensions > My Extensions
Extension