Esta página proporciona instrucciones detalladas para que los suscriptores descarguen el código fuente de Unreal Engine (UE) del repositorio de GitHub de Unreal Engine y empiecen a trabajar con el código.
Antes de acceder al repositorio en https://github.com/EpicGames/UnrealEngine, debes:
tener una cuenta de Epic Games,
tener una cuenta de GitHub y
haber asociado tu cuenta de GitHub a tu cuenta de Epic Games, tal y como se describe en esta página.
No es necesario que descargues el código fuente para trabajar con Unreal Engine. Si prefieres descargar e instalar la versión binaria de Unreal Engine, consulta nuestros manuales sobre la instalación de Unreal Engine para saber cómo conseguir Unreal Engine. Sin embargo, tener acceso al código fuente puede resultar muy útil para ti y para tu proyecto. Por ejemplo:
Tendrás acceso a las últimas funciones y correcciones de errores que los ingenieros de Epic realizan cada día, prácticamente al minuto.
Si encuentras un error que aún no hayamos corregido, pero que es crucial para tu proyecto, puedes desbloquearlo realizando la corrección en tu propia versión del código fuente y reconstruyendo tu propio archivo binario.
Puedes mejorar el motor y ayudar a toda la comunidad de Unreal Engine enviando tus correcciones y funciones a Epic.
Si tienes una licencia de Unreal Engine, puedes acceder al código fuente a través de nuestro servidor de Perforce en lugar del repositorio público de GitHub.
Cómo acceder al código fuente de Unreal Engine en GitHub
Unreal Engine incluye acceso total al código fuente completo en C++, para que puedas estudiar, personalizar, ampliar y depurar todo Unreal Engine, y completar tu proyecto sin obstáculos.
Nuestro repositorio de código fuente de GitHub se actualiza continuamente conforme desarrollamos funciones en nuestra línea principal, por lo que no tendrás que esperar a la próxima versión del producto para hacerte con el código más reciente.
Para acceder al código fuente de Unreal Engine, haz lo siguiente:
Dirígete a GitHub y regístrate para crear una cuenta.
Inicia sesión en UnrealEngine.com con tu cuenta verificada de Epic Games. Para abrir el panel de control de tu cuenta, coloca el cursor sobre tu nombre de usuario y selecciona Personal en el menú desplegable.
Con el panel de control de tu cuenta abierto, selecciona la pestaña Conexiones en la barra lateral. Selecciona la pestaña Cuentas y, a continuación, el botón Conectar debajo del icono de GitHub.
Si aún no has firmado el acuerdo de licencia de usuario final de Unreal Engine, tendrás que leer sus términos y marcar la casilla de verificación y, a continuación, seleccionar Vincular cuenta. Si has cerrado sesión en tu cuenta de GitHub, se te redirigirá a GitHub para que inicies sesión tras hacer clic en el botón Vincular cuenta.
Para completar el proceso de autorización de la aplicación OAuth, haz clic en el botón Autorizar EpicGames. Puedes obtener más información sobre este proceso en la introducción de GitHub sobre la autorización de aplicaciones OAuth.
GitHub te enviará un correo electrónico invitándote a unirte a la organización @EpicGames en GitHub. Debes hacer clic en el botón Unirse a @EpicGames de este correo electrónico en un plazo de siete días para completar el proceso de vinculación de las cuentas de GitHub y de Epic Games.
Una vez completado, recibirás un correo electrónico de Epic Games verificando que tus cuentas de GitHub y Epic Games se han vinculado correctamente. Si no recibes un correo electrónico de confirmación o si experimentas problemas con tu cuenta, contacta con el servicio de atención al cliente. Ahora ya puedes empezar. Para descargar el código fuente completo, ve a nuestra página de GitHub (es necesario iniciar sesión).
Ramificaciones del código fuente
Verás que hemos publicado el código fuente de UE en varias ramificaciones.
Las ramificaciones cuyos nombres contienen «dev», «staging» y «test» se emplean, por lo general, para procesos internos de Epic y rara vez son útiles para el usuario final. A medida que estabilizamos nuevas versiones o correcciones urgentes pueden aparecer de vez en cuando otras ramificaciones de corta duración.
Ramificación Release
La ramificación Release siempre refleja la versión oficial actual. Nuestro equipo de control de calidad la ha probado exhaustivamente, por lo que es un excelente punto de partida para aprender a usar Unreal Engine y crear tus propios proyectos. Trabajamos duro para que las versiones sean estables y fiables, y nuestro objetivo es publicar una nueva versión cada pocos meses.
Rama principal
La mayor parte del desarrollo activo de UE tiene lugar en la ramificación ue5-main. Esta ramificación refleja la última versión del motor y puede tener errores o no compilarse. La ponemos a disposición de los desarrolladores que estén ansiosos por probar nuevas funciones o por trabajar con nosotros en el desarrollo por etapas.
Si decides trabajar en esta ramificación, ten en cuenta que es probable que esté por delante de las ramificaciones de la versión oficial actual y de la próxima versión. Por lo tanto, es posible que el contenido y el código que crees para que funcione con la ramificación ue5-main no sean compatibles con las versiones públicas hasta que se cree una nueva ramificación directamente desde ue5-main para una futura versión oficial.
Consulta Setting Up Visual Studio (Configuración de Visual Studio) para asegurarte de que cuentas con una versión de Visual Studio compatible con la versión requerida de Unreal Engine.
Instala GitHub para Windows y luego bifurca y clona nuestro repositorio.
Para usar Git desde la línea de comandos, consulta los artículos Setting up Git (Configuración de Git) y Fork a Repo (Bifurcación de un repositorio).
Si no quieres usar Git, puedes descargar el código fuente haciendo clic en el botón Descargar ZIP de la derecha. El uso zip integrado de Windows marcará el contenido de los archivos zip descargados de internet como no seguros para su ejecución, así que haz clic con el botón derecho del ratón en el archivo zip y selecciona Propiedades… y Desbloquear antes de descomprimirlo. Los usos zip de terceros no suelen hacer esto.
Instala Visual Studio.
Todas las ediciones de escritorio de Visual Studio pueden compilar Unreal Engine, incluida Visual Studio Community, que es gratuita para pequeños equipos y desarrolladores individuales. Consulta la página Setting Up Visual Studio (Configuración de Visual Studio) para asegurarte de que has descargado todos los componentes de VS necesarios para trabajar con UE.
Abre tu carpeta de origen en el explorador y ejecuta
Setup.bat.Esto descargará el contenido binario del motor, además de instalar los requisitos previos y configurar las asociaciones de archivos de Unreal Engine. En Windows, puede aparecer una advertencia de SmartScreen. Haz clic en Más información y en Ejecutar de todos modos para continuar.
Una descarga limpia de los archivos binarios del motor puede tardar un poco en completarse, Las descargas posteriores solo requerirán descargas incrementales y serán mucho más rápidas.
Ejecuta
GenerateProjectFiles.batpara crear un proyecto de archivo para el motor. aunque no llega al minuto.Carga el proyecto en Visual Studio haciendo doble clic en el archivo
UE5.sln. Establece la configuración de tu solución en Editor de desarrollo y la plataforma de la solución en Win64. Luego, haz clic con el botón derecho del ratón en el destino UE y selecciona Compilar. La compilación puede tardar entre 10 y 40 minutos en compilarse, en función de las especificaciones de tu sistema.Una vez finalizada la compilación, puedes cargar el editor desde Visual Studio configurando tu proyecto de inicio como UE5 y pulsando F5 para depurar.
Este La página muestra a los titulares de licencias cómo descargar y compilar Unreal Engine desde nuestro repositorio de código fuente en GitHub. Si quieres descargar la versión binaria de Unreal Engine, consulta nuestro manual Installing Unreal Engine (Instalación de Unreal Engine) para saber cómo conseguir Unreal Engine.
Plataformas de destino adicionales
La compatibilidad con Android se descargará mediante la configuración de la secuencia de comandos si tienes instalado el NDK de Android. Consulta Android Quick Start (Guía de inicio rápido de Android).
El desarrollo en iOS requiere un Mac. Las instrucciones se encuentran en la iOS Quick Start (Guía de inicio rápido de iOS).
Desarrollo Para consolas y otras plataformas con acceso restringido, como Sony PlayStation, Microsoft Xbox y Nintendo Switch, solo es posible si tienes una cuenta de desarrollador registrada con esos proveedores externos.
En función de la plataforma, es posible que haya manuales u orientación adicional en el sitio de asistencia a profesionales de Epic, o como archivo descargable en la sección de los foros de Unreal Engine dedicada a tu plataforma.
Si Si no tienes acceso a estos recursos, date de alta primero como desarrollador en el proveedor externo. A continuación, ponte en contacto con tu gestor de cuentas de Epic Games si tienes uno, o rellena y envía el formulario de solicitud de desarrollo para consolas para Unreal Engine si no lo tienes. Epic se pondrá en contacto contigo con un acuerdo formal para que lo firmes digitalmente. Cuando se apruebe, recibirás instrucciones sobre cómo acceder al código fuente, los archivos binarios e instrucciones adicionales para tu plataforma.
Licencias y contribuciones
Tu acceso y uso de Unreal Engine en GitHub se rige por el acuerdo de licencia de usuario final de Unreal Engine. Si no estás de acuerdo con dichas condiciones ni con sus modificaciones periódicas, no podrás acceder ni usar Unreal Engine.
Agradecemos cualquier contribución al desarrollo de Unreal Engine a través de solicitudes de incorporación de cambios en GitHub. La mayor parte de nuestro desarrollo activo se encuentra en la ramificación maestra,
por lo que preferimos que este tipo de solicitudes se realicen allí (sobre todo en el caso de nuevas
funciones). Intentamos asegurarnos de que todo el código nuevo cumpla con las
Siguientes pasos
Ahora que has descargado y configurado Unreal Engine, ya está todo listo para compilar el motor desde la fuente.
Notas al pie
La primera vez que inicies el editor desde una compilación de código fuente nueva, es posible que experimentes tiempos de carga prolongados. El motor está optimizando el contenido para tu plataforma en la caché de datos derivados y esto solo debería ocurrir una vez.
Tus bifurcaciones privadas del código de Unreal Engine están asociadas a los permisos de tu cuenta de GitHub. Si cancelas tu suscripción o cambias de nombre de usuario de GitHub, tendrás que volver a bifurcar y subir los cambios desde una copia local.