Tu primer proyecto: Two-Room Relay
Bienvenido al tutorial del primer proyecto. Empezarás con un proyecto vacío de Polygon Engine y terminarás con un juego pequeño de PlayStation 1 que puede ejecutarse en Play Mode y en DuckStation.
El objetivo del juego es deliberadamente pequeño: recorrer la primera habitación, cruzar un trigger para abrir una puerta, entrar a la segunda habitación y conservar el estado de la puerta y del punto de control en una tarjeta de memoria. Un HUD compacto incluye botones para guardar y reiniciar, un mensaje de estado, una imagen importada y una respuesta de audio.
Este tutorial sirve como guía de aprendizaje y como lista de comprobación para una prueba básica del flujo de publicación. Cada capítulo termina con un punto de revisión que indica exactamente qué debe funcionar antes de continuar.
Qué vas a crear
First Person Player
|
v
Room A ---- Door Trigger ---- Door ---- Room B
|
+-- controlador de Lua
+-- Audio Source
+-- PlayerPrefs / Memory Card
+-- estado y botones del HUD
El proyecto terminado recorre el flujo principal de producción sin requerir un nivel grande ni recursos gráficos complejos.
| Característica | Qué valida el tutorial |
|---|---|
| Project Hub | Crear un proyecto fuera de la instalación del engine |
| Escenas y Hierarchy | Crear, nombrar, duplicar, posicionar y guardar GameObjects |
| Componentes nativos del jugador | Movimiento en primera persona, colisión, cámara y entrada del mando |
| Level Builder | Crear una malla reutilizable de PS1 y colocarla en una escena |
| Components | Mesh Renderer, Collider, Lua Behaviour, Audio Source y componentes del jugador |
| Lua | Callbacks de ciclo de vida en PascalCase, eventos de trigger, propiedades expuestas en el Inspector y API de ejecución |
| UI Canvas | Panel, Text, Image, Button, foco y callbacks de Lua |
| Procesamiento de recursos | Importar una textura de PS1 y un sonido WAV residente |
| Persistencia | Guardar, cargar, reiniciar y escribir un archivo de Memory Card de un bloque mediante PlayerPrefs |
| Flujo de trabajo de PS1 | Validar, revisar presupuestos, usar Build with Readiness Checks y probar el CUE |
| Pruebas en emulador | Ejecutar en DuckStation con un mando |
Los sistemas avanzados, como las cámaras en tercera persona, los grafos de animación, los personajes 3D importados, las partículas y la música CD-XA transmitida desde disco, quedan fuera del flujo principal. El último capítulo incluye referencias para explorar esas ampliaciones después de estabilizar el juego básico.
Tiempo y requisitos previos
Reserva entre 45 y 75 minutos para el primer recorrido.
Antes de comenzar:
- instala e inicia Polygon Engine;
- completa el Setup Wizard del primer inicio;
- conecta un mando si quieres validar la entrada durante Play Mode;
- configura DuckStation antes del último capítulo;
- mantén disponibles los paneles Project, Hierarchy, Inspector, Scene, Game, Problems y Console.
No necesitas experiencia previa con Lua. Se incluye el script completo y cada parte se explica en el momento en que se utiliza.
Recursos del tutorial
Se proporcionan dos recursos multimedia pequeños y el script Lua completo para que puedas reproducir el tutorial:
Usa el archivo Lua en el capítulo 3 e importa la imagen y el sonido en el capítulo 4. Las descargas y el proyecto de referencia terminado tienen una licencia de recursos del tutorial que permite usarlos y adaptarlos en juegos gratuitos o comerciales. Conserva su aviso con las copias de esos recursos; este permiso no reemplaza la EULA del engine.
Proyecto de referencia terminado
Descargar el proyecto Two-Room Relay terminado (suma de comprobación SHA-256).
Extrae todo el ZIP en una carpeta con permiso de escritura fuera de la instalación del engine. En Project Hub, elige Open Existing... y selecciona polygon.project.json dentro de la carpeta extraída Two Room Relay. Abre Scenes/scene_main.json. Usa la versión actual de Polygon Engine y vuelve a compilar el proyecto descargado. La descarga incluye la escena, el script, los materiales, los recursos fuente y los recursos importados. Configura tus herramientas y genera tu propia compilación siguiendo Prueba y compila.
Usa este proyecto para comparar los nombres de los objetos, las asignaciones de componentes y los valores del Inspector con tu trabajo. Para practicar todo el flujo de creación, continúa con un proyecto vacío y sigue los capítulos en orden.
Regla de trabajo
Guarda con Ctrl+S después de cada punto de revisión. Si un paso no produce el resultado esperado, detente y corrígelo antes de agregar otro sistema. Así podrás separar los problemas del nivel, los scripts, la interfaz y la compilación.
Comienza con Crea el proyecto y el jugador.