> 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-es/scenes-sdk7/networking/third-party-servers.md).

# Servidores de terceros

Crea escenas multijugador de Decentraland con un servidor de terceros.

El enfoque recomendado para las interacciones multijugador en tu Scene es usar el [Servidor multijugador](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/networking/authoritative-servers.md). Este documento abarca otras opciones que también son compatibles.

* **API REST + DB**: ideal para datos que cambian con poca frecuencia (tablas de clasificación, libros de visitas). Los jugadores consultan la API periódicamente para obtener actualizaciones; el estado persiste entre sesiones. Consulta [Conexiones de red](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/networking/network-connections.md) para saber cómo hacer solicitudes `fetch` desde una Scene.
* **Servidor WebSocket**: permite la comunicación bidireccional en tiempo real. Consulta [Conexiones de red](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/networking/network-connections.md) para saber cómo usar WebSocket. Las bibliotecas como [Colyseus](https://colyseus.io/) funcionan bien con el SDK de Decentraland.

{% hint style="warning" %}
**📔 Nota**: los servidores de terceros no se integran con `syncEntity`, `validateBeforeChange`, ni con `Storage` ; tendrás que implementar tu propia gestión del estado y la lógica de sincronización.
{% endhint %}

También puedes optar por un enfoque híbrido en el que los cambios se notifican entre jugadores mediante [serverless-multiplayer](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/networking/serverless-multiplayer.md), pero el estado final también se almacena mediante una API REST para los visitantes futuros.

Estos son algunos ejemplos de Scenes que usan un servidor de terceros:

* [Tabla de clasificación](https://github.com/decentraland/sdk7-goerli-plaza/tree/main/leader-board)
* [Libro de visitas](https://github.com/decentraland/sdk7-goerli-plaza/tree/main/guest-book-api)
* [Validar autenticidad](https://github.com/decentraland/sdk7-goerli-plaza/tree/main/validate-player-authenticity)

## Pruebas locales

Para obtener una vista previa de una Scene que usa un servidor de terceros, debes ejecutar tanto la Scene como el servidor del que depende. Puedes ejecutar el servidor localmente en la misma máquina que la vista previa, lo que facilita las pruebas. Al ejecutarlo localmente, el servidor puede usar conexiones no seguras de `http` o `ws` , para facilitar la configuración.

Para iniciar el servidor, ve a la carpeta `/server` y ejecuta `npm run start`.

Abre la vista previa en dos ventanas distintas; cada ventana se considera un jugador independiente. Conecta cada ventana con una dirección diferente. Ambos clientes se conectarán a la misma instancia del servidor local.

En Creator Hub, activa **Vista previa de varias instancias** en el submenú **Cliente de escritorio** de **Opciones de reproducción**, y luego haz clic en el botón **Reproducir** por segunda vez para abrir una segunda ventana del Explorer de Decentraland. Debes conectarte en ambas ventanas con direcciones diferentes. Las mismas sesiones permanecerán abiertas mientras se vuelve a cargar la Scene.

Como alternativa, puedes abrir una segunda ventana del Explorer de Decentraland escribiendo lo siguiente en la URL del navegador:

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

## Realms separados

Los jugadores de Decentraland existen en muchos *realms*. Los jugadores de diferentes realms no pueden verse, interactuar ni chatear entre sí, aunque estén en las mismas parcels. Dividir a los jugadores de esta manera permite a Decentraland gestionar una cantidad ilimitada de jugadores sin toparse con ninguna limitación. También agrupa a los jugadores que se encuentran en regiones cercanas para garantizar que los tiempos de ping entre los jugadores que interactúan sean aceptables.

Si tu escena envía datos a un servidor de terceros para sincronizar cambios entre jugadores en tiempo real, es importante que los cambios solo se sincronicen entre los jugadores que están en el mismo realm. Debes gestionar todos los cambios que pertenecen a un realm por separado de los que pertenecen a otro. De lo contrario, los jugadores verán cambios misteriosos sin que nadie los haya realizado.

Consulta cómo obtener el realm de cada jugador en [obtener datos del jugador](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/user-data.md)

## Persistencia multijugador

A diferencia de las escenas locales, que se montan de nuevo cada vez que un jugador entra en ellas, las escenas que usan servidores de terceros tienen una vida útil que se extiende mucho más allá del momento en que el jugador entra y sale de la escena.

Por lo tanto, debes diseñar la experiencia teniendo en cuenta que el jugador no siempre encontrará la escena en el mismo estado inicial. Los cambios realizados en la escena permanecerán para que otros jugadores los encuentren; debes asegurarte de que no interfieran de forma indeseada en las experiencias de futuros jugadores.

### Restablecer el estado

Al cargar la escena, asegúrate de que se construya a partir de la información compartida almacenada en el servidor y no de un estado predeterminado.

En algunos casos, tiene sentido incluir algún tipo de botón de restablecimiento en la escena. Al pulsarlo, la escena se restablecería de forma ordenada.

A veces, esto solo implica devolver las variables del estado de la escena a sus valores predeterminados. Pero restablecer la escena también puede implicar cancelar la suscripción de los listeners y detener los loops del lado del servidor. Si quedan loops vacíos cada vez que se restablece la escena, se irán acumulando y afectarán negativamente al rendimiento de la escena.


---

# 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-es/scenes-sdk7/networking/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.
