Guía de Supervivencia: UE5 + SVN (TortoiseSVN)
Guía de Supervivencia: UE5 + SVN 🛠️
Bienvenidos a la biblia de Hypenosys. Para que no nos matemos entre nosotros y el proyecto no explote, seguid estos pasos al pie de la letra.
Primeros pasos: Configuración inicial
0. Añádete a la VPN de Tailscale
Tienes el enlace en md en Discord. Avisa a Axel para que te acepte.
1. Instala TortoiseSVN
Descárgalo de tortoisesvn.net e instálalo. Durante la instalación marca también "command line client tools".
2. Haz checkout del repo
Crea una carpeta donde quieras tener el proyecto, por ejemplo C:\Proyectos\Hypenosys. Clic derecho dentro → SVN Checkout y pon:
Checkout directory: C:\Proyectos\Hypenosys\trunk
Usuario: tuusuarioquetepasoaxelpormdendiscord y la contraseña que le hayas dado.
3. Abre el proyecto en Unreal
Abre UE y navega hasta C:\Proyectos\Hypenosys\trunk\Hypenosys\ y abre el .uproject.
4. Conecta Source Control en Unreal
En la barra inferior del editor → Revision Control → Connect to Revision Control:
- Provider: Subversion
- Repository: svn://preguntar.ip.a.axel/hypenosys/trunk/Hypenosys
- Username: tuusuarioquetepasoaxelpormdendiscord
- Directorio de etiquetas: tags/
- Password: la que te pasé
Dale a Accept Settings — el icono debe ponerse verde.
5. Comprueba que funciona
En el Content Browser, clic derecho sobre cualquier asset → debería aparecer el menú de SVN con opciones como Check Out, History, etc. Si las ve, está todo correcto.
.uasset o .umap tienes que hacer Check Out primero para bloquear el archivo. Así nadie del equipo puede editarlo al mismo tiempo.
Flujo de trabajo colaborativo con TortoiseSVN
1. SVN Update al inicio de cada sesión
ObligatorioHazlo siempre antes de tocar nada. Te aseguras de tener los últimos cambios del equipo y evitas conflictos.
UI: Click derecho → SVN Update | CLI:svn update
2. Lock / Check Out antes de editar BINARIOS
CríticoUnreal Engine usa archivos binarios (.uasset, .umap, etc.) que no se pueden fusionar automáticamente. Si dos personas los editan a la vez, uno perderá su trabajo.
svn lock [file]
3. Edita tus archivos
Trabaja normalmente en Unreal o tu software de elección (Blender, Photoshop, etc.).
Operación interna en el software correspondiente.4. SVN Commit con mensaje descriptivo
Usa el formato: [AREA] Breve descripción
svn commit -m "[AREA] Message"
5. Libera el bloqueo (Unlock)
Normalmente TortoiseSVN lo hace solo al hacer commit, pero asegúrate de que el candado desaparezca para que otros puedan trabajar.
UI: Click derecho → TortoiseSVN → Release Lock... | CLI:svn unlock [archivo]
6. Nunca dejes bloqueos abiertos por la noche
EtiquetaSi terminas tu jornada, sube tus cambios o libera el bloqueo. No seas "ese" compañero que bloquea el progreso de los demás mientras duerme.
UI: Click derecho → TortoiseSVN → Release Lock... | CLI:svn unlock [archivo]
7. ¿Qué hacer si un archivo está bloqueado?
Comunícate por Discord. Nunca fuerces un bloqueo ("Steal lock") sin hablar antes con la persona que lo tiene.
UI: Click derecho → TortoiseSVN → Check for modifications → Check repository | CLI:svn status -u
8. SVN Cleanup para emergencias
Si TortoiseSVN se queda "colgado" o da errores extraños de base de datos, el comando Cleanup suele arreglarlo.
UI: Click derecho → TortoiseSVN → Clean up... | CLI:svn cleanup
Reglas de Oro 📜
- NUNCA subas archivos binarios que no sean del proyecto (nada de
Intermediate,Saved, oDerivedDataCache). - SIEMPRE haz Update antes de empezar.
- SIEMPRE avisa por Discord si vas a tocar un nivel entero o el
ProjectSettings. - Si sale un conflicto: NO ENTRES EN PÁNICO. Llama a Alex o Axel. No intentes arreglarlo borrando cosas al azar.
"Si sigues estos pasos, el SVN será tu amigo. Si no, será tu peor pesadilla." 💀