Scene Admin

Grant certain players the special role of admin on your scene. When a scene admin visits your scene, they see a special UI on the top-right corner that only they are able to see. Through this UI they can play videos, send announcements, or activate any smart item in the scene. These actions are seen by all other players in the scene that are connected to the same island as the admin.

During a live event, an admin can spontaneously control what happens in the scene from inside Decentraland, without needing to pre-schedule actions or relying on a 3rd party service. Start playing the music when enough of a crowd gathered, drop confetti or make a spaceship appear when the time feels right.

## Setting up admins

To assign admins, you need to add the Scene Admin smart item to your scene.

Open the Scene Admin configuration to determine who can be an admin in this scene. The following options are available:

Public: Any player can be an admin. This is useful for debugging, but not recommended for live events.
Private: Only the allowed players can be an admins.
- Me: While you’re developing the scene and trying it locally, you are always an admin.
- Scene owners: Players that own the LAND or NAME token of the scene can be a admins. This is the default option.
- Allowlist: Players in the allowlist are also admins. Paste their wallet address and click Add.

📔 Note: When publishing to a World, scene owners must be explicitly added to the allowlist to be admins.

Whenever an admin player is in the scene, they will see a special UI on the top-right corner. Non-admin players don’t see this UI.

Video playing #

One of the most common actions for admins to do is to play videos. The admin panel includes a video player section where they can control anything related to videos.

To enable this, you need to add a Video Player smart item to your scene and link it to the Scene Admin smart item.

Add a Video Player smart item to your scene
On the Scene Admin Smart Item, make sure the Video Control section is enabled. Then select the screen from a dropdown list and give it a name.

📔 Note: An admin can only control video screens that are added as Smart Items in the Creator Hub, not screens added via SDK code.

You can include as many video screens as you want. In general, avoid having more than one different video playing at the same time, as that hurts performance a lot.

Once the above is configured, admin users in your scene can open the admin panel and select the video section to control these video screens.

Paste a video URL into the main field and click Share. The video will start playing on the selected screen for all players. You can also stop, pause, mute or change the volume of the video.

📔 Note: Not any video URL will work. Videos from sites like Youtube for example have strict policies about their content and will block access to them from Decentraland. See Streaming Videos for more information on what you can and can’t play in Decentraland.

Announcements #

In the Announcements tab of the admin panel, admins can write messages that get seen by all players in the scene. Messages like this can only be sent by admins, so other players will perceive them as more legitimate than a message on the chat by someone claiming to be an admin.

Select the Message section of the admin UI. Write a message and click Share. The message can be up to 90 characters long.

Trigger smart items #

To Trigger an action from any smart item in the scene:

Add a smart item to your scene
Open the settings for the Scene Admin Smart Item in the Creator Hub
In the Smart item actions section, add the smart item from the dropdown, give it a custom name and select a default action

Once the above is configured, admins can trigger the action by opening the Smart Item Actions section of the admin UI and then selecting an item from the dropdown list. They can then either click the Default button to trigger the default action of that item, or select any other of the item’s actions from the list.

You can also show or hide any smart item in this list, even if it doesn’t include an action to do that.