Hello! Please choose your
desired language:
Dismiss

Outbound links

You can add links from your scene out to other content, either to other scenes or to external websites.

Teleports

To teleport a player to another scene, call the following function, indicating the coordinates that you want players to teleport to.

teleportTo(-51,1)

Players are presented a confirmation screen before they are teleported, this screen displays information from the destination scene’s scene.json file, including the scene name, description and navmapThumbnail. See scene metadata for details on how to set this data.

You can also teleport players to the most crowded place in Genesis City by doing teleportTo(‘crowd’), which is equivalent to typing /goto crowd in the chat. Similarly you can teleport players to a random location from the curated list that you reach with /goto magic by doing ``teleportTo(‘magic’)`.

Bare in mind that teleports take you to a scene in the indicated coordinates, but not necessarily to that same coordinates. This means that when travelling to a scene that has multiple parcels, players may not be landing on the same coordinates as specified, but rather into one of the spawn points designated by the creator of the scene.

To add a link to an external website, use the openExternalURL() command.

const entity = new Entity()
entity.addComponent(new BoxShape())
const transform = new Transform({ position: new Vector3(4, 0, 4) })
entity.addComponent(transform)
entity.addComponent(
  new OnPointerDown(() => {
    openExternalURL("https://docs.decentraland.org")
  })
)
engine.addEntity(entity)

To prevent any abusive usage of this feature to spam players, it’s only possible to call the openExternalURL from an explicit click or button event on an entity. It’s not possible to call this function as a result of a timer, or a collision area, or a global click event.

When openExternalURL is called, players are prompted with a confirmation screen, where they are informed of where the link will take them, and where can accept of decline to visit the link.

The link is opened in a new tab, keeping the original tab in Decentraland.

If players tick the trust this domain checkbox, they won’t be prompted again during their session, as long as the link comes from the same scene and is to the same domain.