> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/third-party-servers.md).

# Servidores de Terceiros

Crie scenes multiplayer do Decentraland com um servidor de terceiros.

A abordagem recomendada para interações multijogador na sua scene é usar o [Multiplayer Server](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/authoritative-servers.md). Este documento aborda outras opções que também são compatíveis.

* **REST API + DB**: ideal para dados que mudam com pouca frequência (tabelas de classificação, livros de visitas). Os jogadores consultam a API periodicamente para obter atualizações; o estado persiste entre sessões. Consulte [Network Connections](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/network-connections.md) para saber como fazer `fetch` requests a partir de uma scene.
* **WebSocket server**: permite comunicação bidirecional em tempo real. Consulte [Network Connections](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/network-connections.md) para saber como usar WebSocket. Bibliotecas como [Colyseus](https://colyseus.io/) funcionam bem com o Decentraland SDK.

{% hint style="warning" %}
**📔 Nota**: servidores de terceiros não se integram com `syncEntity`, `validateBeforeChange`, nem com `Storage` — terá de implementar a sua própria gestão de estado e lógica de sincronização.
{% endhint %}

Também é possível optar por uma abordagem híbrida, em que as alterações são notificadas entre jogadores através de [serverless-multiplayer](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/serverless-multiplayer.md), mas o estado final também é armazenado através de uma REST API para futuros visitantes.

Veja alguns exemplos de scenes que usam um servidor de terceiros:

* [Tabela de classificação](https://github.com/decentraland/sdk7-goerli-plaza/tree/main/leader-board)
* [Livro de visitas](https://github.com/decentraland/sdk7-goerli-plaza/tree/main/guest-book-api)
* [Validar a autenticidade](https://github.com/decentraland/sdk7-goerli-plaza/tree/main/validate-player-authenticity)

## Testar localmente

Para pré-visualizar uma scene que usa um servidor de terceiros, tem de executar tanto a scene como o servidor de que ela depende. Para facilitar os testes, pode executar o servidor localmente, na mesma máquina que a pré-visualização. Quando executado localmente, o servidor pode usar ligações não seguras `http` ou `ws` , para facilitar a configuração.

Para iniciar o servidor, aceda à pasta `/server` e execute `npm run start`.

Abra a pré-visualização em duas janelas separadas; cada janela é tratada como um jogador diferente. Ligue cada janela usando um endereço diferente. Ambos os clientes vão ligar-se à mesma instância do servidor local.

No Creator Hub, ative **Multi-Instance Preview** no submenu **Desktop Client** de **Play Options**, depois clique novamente no botão **Play** para abrir uma segunda janela do Explorer do Decentraland. Tem de iniciar sessão nas duas janelas com endereços diferentes. As mesmas sessões permanecerão abertas quando a cena for recarregada.

Em alternativa, pode abrir uma segunda janela do Explorer da Decentraland escrevendo o seguinte num URL do browser:

> `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true`

## Realms separados

Os jogadores em Decentraland estão distribuídos por vários *realms*. Os jogadores em realms diferentes não se conseguem ver, interagir nem conversar entre si, mesmo que estejam nas mesmas parcels. Esta divisão permite que Decentraland suporte um número ilimitado de jogadores sem enfrentar limitações. Também agrupa jogadores que estão em regiões próximas, para garantir que os tempos de ping entre jogadores que interagem são aceitáveis.

Se a sua scene enviar dados para um servidor de terceiros para sincronizar alterações entre jogadores em tempo real, é importante que as alterações sejam sincronizadas apenas entre jogadores que estejam no mesmo realm. Deve gerir todas as alterações de um realm separadamente das alterações de outros realms. Caso contrário, os jogadores vão ver coisas a mudar de forma assustadora, sem que ninguém tenha feito essa alteração.

Veja como obter o realm de cada jogador em [obter dados do jogador](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/user-data.md)

## Persistência multijogador

Ao contrário das scenes locais, que são montadas de novo sempre que um jogador entra nelas, as scenes que usam servidores de terceiros têm um ciclo de vida que se prolonga muito para além da entrada e saída do jogador.

Por isso, deve conceber a experiência tendo em conta que o jogador nem sempre vai encontrar a scene no mesmo estado inicial. Quaisquer alterações feitas à scene vão permanecer para outros jogadores; certifique-se de que não afetam negativamente a experiência de futuros jogadores.

### Repor o estado

Ao carregar a Scene, certifique-se de que ela é construída com base nas informações partilhadas armazenadas no Server, e não num estado predefinido.

Em alguns casos, faz sentido incluir algum tipo de botão de reposição na Scene. Ao premir o botão de reposição, a Scene seria reposta de forma controlada.

Por vezes, isto implica apenas repor as variáveis no estado da Scene para os valores predefinidos. Mas a reposição da Scene também pode envolver cancelar a subscrição de listeners e parar loops no lado do Server. Se ficarem loops vazios após cada reposição da Scene, estes vão-se acumulando e terão um impacto negativo no desempenho da Scene.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/third-party-servers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
