CodeWalker es una herramienta para Windows que permite explorar los archivos de GTA V y trabajar con datos de mapas. Descárgala únicamente desde el repositorio oficial de CodeWalker o la distribución del autor en GTA5-Mods. No utilices sitios de descarga alternativos ni ejecutables reempaquetados.
Confirma la edición de GTA de destino antes de instalar o exportar assets. Los paquetes de Legacy no son automáticamente compatibles con Enhanced; sigue la guía oficial de conversión de activos de Enhanced cuando ese sea tu objetivo.
Lo que hace CodeWalker y lo que no hace
CodeWalker puede explorar los archivos RPF de GTA V, renderizar el mundo, inspeccionar entidades, crear proyectos y editar archivos de mapa como YMAP. Su Project Window también admite otros formatos de datos del juego descritos por el autor. No sustituye a una suite de modelado 3D, al control de versiones, a las copias de seguridad ni a un servidor de pruebas de FiveM en el juego.
Requisitos y fuentes de descarga seguras
El repositorio indica un PC con Windows de 64 bits, una copia de GTA V para PC, gráficos compatibles con DirectX 11 y el runtime de .NET requerido. Consulta la documentación actual del autor antes de instalar, ya que las compilaciones de desarrollo y los requisitos pueden cambiar.
- Repositorio oficial de GitHub de dexyfex para el código fuente y la documentación del proyecto.
- Página de GTA5-Mods del autor para la distribución publicada.
Configura la ruta de GTA V
- Extrae el archivo proporcionado por el autor en una carpeta dedicada a herramientas.
- Inicia CodeWalker desde esa carpeta.
- En el primer inicio, selecciona la raíz de tu instalación de GTA V si CodeWalker no la detecta automáticamente.
- Espera a que se carguen los datos iniciales del mundo antes de dar por hecho que la aplicación se ha bloqueado.
Usa World View y la ventana Project Window
World View es la superficie de navegación visual. Los controles del autor usan WASD para el movimiento, arrastrar con el botón izquierdo para rotar la cámara y la rueda del ratón para el zoom y la velocidad de movimiento. Abre el Toolbox para inspeccionar las selecciones y la barra de herramientas principal para cambiar los modos de selección y transformación.
Crea y guarda un .cwproj proyecto antes de editar. La ventana Project Window mantiene juntos los archivos y las entidades de la tarea actual; editar una entidad mientras está abierta puede añadir al proyecto el YMAP propietario.
Trabaja con proyectos YMAP y YTYP
Normalmente, un YMAP contiene las colocaciones en el mundo. Un YTYP describe arquetipos y puede incluir información utilizada por los flujos de trabajo de interiores. Mantén los archivos fuente, los archivos exportados y el recurso final de FiveM en carpetas separadas para que una exportación no pueda sobrescribir la única copia editable.
- Crea o abre un proyecto y añade solo los archivos necesarios para ese mapa.
- Selecciona entidades en World View y luego muévelas, rótalas o escálalas de forma deliberada.
- Guarda los archivos YMAP editados desde la ventana Project Window y revisa la ruta de salida.
- Para el trabajo con MLO, valida los cambios de YTYP, salas, portales y arquetipos como parte del flujo de trabajo completo de interiores.
Exporta, haz copias de seguridad y prueba
Antes de cada sesión de edición, copia toda la carpeta del proyecto en una copia de seguridad con fecha. Exporta a una carpeta de compilación separada, compara la lista de archivos con el proyecto y conserva la última compilación que funcionaba correctamente. El autor de CodeWalker describe la herramienta como un trabajo en curso, por lo que son posibles bloqueos o un renderizado incompleto; los guardados frecuentes y los cambios reversibles son importantes.
Empaqueta el resultado como un recurso de FiveM
Una estructura habitual para un recurso de mapa coloca el manifiesto en la raíz del recurso y los archivos de mapa exportados en un directorio stream. No publiques el proyecto sin procesar de CodeWalker como recurso del servidor. Consulta la guía de creación de MLO para FiveM para seguir el proceso completo de modelado, exportación, creación del manifiesto y validación dentro del juego.
my-map/
├── fxmanifest.lua
└── stream/
├── map.ymap
└── archetypes.ytypProblemas comunes de CodeWalker
- El mundo está en blanco o sigue cargando: verifica la carpeta raíz de GTA V y deja que termine la primera carga.
- Falta una edición en el proyecto: confirma que la ventana Project Window estaba abierta y que el YMAP correcto forma parte del proyecto guardado.
- El servidor muestra el mapa antiguo: compara los archivos exportados con la carpeta
streamdel recurso y reinicia únicamente el recurso de prueba previsto. - CodeWalker se bloquea: vuelve a abrir el último proyecto que funcionaba correctamente y reduce el cambio a la edición reproducible más pequeña antes de reportarlo al proyecto original.