> 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/tutoriales-y-ejemplos/published-games/astro-crew.md).

# Astro Crew

Combate cooperativo de naves espaciales con estado del juego propiedad del servidor, progresión persistente, cámaras de torreta y marcadores de objetivo en el borde de la pantalla.

![Vista previa de Astro Crew](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e5dd60929e0236b37ce0503a56bb7011797c7ce1%2FastroCrew-preview.webp?alt=media)

Una escena cooperativa en la que la tripulación comparte una nave. En cada parada, disparan a los asteroides y platillos volantes que se acercan, reparan las brechas del casco y suben los niveles de artillería e ingeniería. El combate se ejecuta en un servidor multijugador autoritativo.

* [Jugar en Decentraland](https://decentraland.org/play/?realm=astrocrew.dcl.eth)

## Información del proyecto

**Mantenido por:** Comunidad · DansStuff

[Ver código fuente original](https://github.com/DansStuff/AstroCrew)

**Licencia:** No se identifica en este catálogo. Consulta el repositorio original y al responsable de mantenimiento para conocer los términos aplicables antes de reutilizarlo.

{% hint style="warning" %}
**Código mantenido por la comunidad: revísalo antes de usarlo**

Este proyecto comunitario se mantiene fuera de las organizaciones de GitHub de Decentraland Foundation y DAO. Su código fuente y su implementación activa pueden cambiar de forma independiente.

La inclusión en este catálogo no implica que se haya realizado una auditoría de seguridad ni garantiza que sea seguro. Revisa el código, las dependencias y los scripts de instalación antes de ejecutarlo o reutilizarlo.

[Informar de un problema con el catálogo](https://github.com/decentraland/docs/issues/new). Si sospechas que hay vulnerabilidades, sigue la política de seguridad del proyecto original. No incluyas detalles sobre exploits ni credenciales en incidencias públicas.
{% endhint %}

## Características principales

* **Multijugador autoritativo** durante todo el combate. Los clientes envían solicitudes para apuntar, reparar y sobrecargar. El servidor controla el casco, las brechas y las apariciones, y las versiones sincronizadas de `GameState` y `PlayerStats` solo aceptan escrituras del servidor multijugador.
* **Almacenamiento** para los niveles de artillería e ingeniería de cada jugador, y una clasificación semanal de misiones.
* **Cámaras virtuales** en las tres torretas, con una transición temporizada y gradual. Los impactos hacen temblar esas cámaras. Al ocupar un arma, el avatar queda inmovilizado con **InputModifier** y se ocultan el joystick móvil y la mira con **TouchScreenControls**.
* **PrimaryPointerInfo** apunta cada disparo usando el rayo del puntero en el mundo. **PointerLock** permanece desactivado para que **PointerEvents** pueda seguir controlando las consolas, las brechas que se reparan manteniendo pulsado y la tabla de misiones.
* **GltfNodeModifiers** cambia el color de las Mesh emisivas de la nave: verde durante el viaje, rojo durante un encuentro y un segundo conjunto de colores cuando las armas están sobrecargadas.
* **ReactEcs** HUD para el casco, los niveles de habilidad y el marcador al final de la ronda. Los iconos de las brechas fuera de pantalla se sitúan en el borde, colocados con **UiCanvasInformation**.
* **Billboards**, **TextShape**, y **texturas del avatar** en cada objetivo: una mira orientada hacia la cámara, una etiqueta «Objetivo fijado» y retratos de quienes le están disparando.
* **Animator** reproduce en bucle el clip de giro del platillo volante. **AudioSource** reproduce efectos breves y pistas en bucle, con un conjunto de efectos láser de una sola reproducción que permite reiniciar un disparo mientras aún suena el clip anterior. Los clips se precargan con **AssetLoad**.
* En el mundo **TextShape** para las filas de la clasificación semanal. Al hacer clic en una fila, se muestran los resultados de esa misión.
* **AvatarModifierArea** desactiva el aviso del pasaporte en toda la escena.

## Explorar el código

Estos enlaces apuntan a una instantánea específica del código fuente para que las explicaciones sigan siendo útiles a medida que continúa el desarrollo del proyecto original. Son referencias de aprendizaje, no una evaluación de seguridad.

### Indicar a los jugadores los objetivos que están fuera de pantalla

edgePositionForBreach proyecta la dirección de una brecha sobre los ejes horizontales de la cámara, encuentra un borde de un rectángulo y limita el icono para mantenerlo dentro de la pantalla usando la relación de aspecto del lienzo. BreachIcon vincula esa posición con un marcador pulsante de ReactEcs.

**Contexto del proyecto:** Léelo junto con las posiciones de las brechas de la escena, el estado de las brechas activas y las constantes de la UI.

**Referencias al código fuente:**

* [edgePositionForBreach](https://github.com/DansStuff/AstroCrew/blob/dbe11b05be2a753b27b6d5dd866d0554ff73344f/src/ui/breachIcons.tsx#L27-L76)
* [BreachIcon](https://github.com/DansStuff/AstroCrew/blob/dbe11b05be2a753b27b6d5dd866d0554ff73344f/src/ui/breachIcons.tsx#L78-L107)

### Añadir una sacudida de cámara que vuelva a la pose original

shakeEntity registra un Transform base y combina los efectos de sacudida superpuestos usando la intensidad y la duración restante. CameraShakeSystem aplica desplazamientos de posición y rotación cada vez menores, luego restaura la pose base y elimina el componente.

**Contexto del proyecto:** El efecto usa las constantes de amplitud del proyecto y debe registrarse como un sistema ECS.

**Referencias al código fuente:**

* [shakeEntity](https://github.com/DansStuff/AstroCrew/blob/dbe11b05be2a753b27b6d5dd866d0554ff73344f/src/effects/cameraShake.ts#L13-L47)
* [CameraShakeSystem](https://github.com/DansStuff/AstroCrew/blob/dbe11b05be2a753b27b6d5dd866d0554ff73344f/src/effects/cameraShake.ts#L87-L121)


---

# 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/tutoriales-y-ejemplos/published-games/astro-crew.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.
