Tu primer objetivo es sencillo: abrir el mundo de GTA V, seleccionar un objeto y guardar un proyecto CodeWalker. Deja la edición de archivos del juego para más adelante. No necesitas instalar CodeWalker dentro de un recurso FiveM ni sustituir nada en la carpeta de GTA V.
Elige la descarga con cuidado
Usa la página de dexyfex en GTA5-Mods o los canales de publicación enlazados por el autor. Este sitio proporciona el archivo concreto ZIP v30_dev46 proporcionado en esa página; no afirma que dev46 sea la versión de desarrollo más reciente. El archivo figura con fecha del 29 de enero de 2024. Consulta las instrucciones actuales del autor antes de elegir una versión para un proyecto nuevo.
El en GitHub contiene el código fuente. Descargar el repositorio como ZIP no es lo mismo que descargar una versión de Windows lista para ejecutar.
Extrae todo el archivo de la aplicación en una carpeta dedicada. No ejecutes el programa desde dentro del ZIP comprimido. Mantén juntos los archivos que lo acompañan y no sustituyas archivos individuales por los de una versión distinta.
Comprende los requisitos publicados
El README indica una instalación de GTA V para PC, un procesador x64, 4 GB de RAM con 8 GB o más recomendados y gráficos compatibles con DirectX 11 / Shader Model 4.0. El requisito histórico de Windows es Windows 7 o posterior. Es la información de compatibilidad publicada por el autor, no una recomendación de usar un sistema operativo sin soporte.
Hay una pequeña diferencia entre las fuentes proporcionadas: el README indica .NET Framework 4.5 o posterior, mientras que la descripción de GTA5-Mods especifica 4.5.2. Sigue los requisitos de la versión que instales realmente. No consideres una especificación mínima antigua una garantía para los assets actuales del juego o para todas las versiones de desarrollo.
Indica a CodeWalker dónde está GTA V
En el primer inicio, selecciona la carpeta de tu instalación de GTA V cuando se solicite. El README describe la detección automática de una ruta histórica predeterminada de Steam. Tu instalación puede estar en otro lugar; elige su ubicación real en vez de recrear la ruta del ejemplo.
La vista del mundo se carga de forma predeterminada y puede tardar en completarse. Antes de concluir que falta algo, comprueba la carpeta del juego elegida y el estado de carga de la aplicación. Mantén sencilla la prueba inicial: sin assets personalizados ni un gran proyecto de mod existente.
Elige ahora la edición de destino. Legacy y Enhanced son destinos de assets separados. Un enlace a un archivo antiguo no demuestra compatibilidad con Enhanced. Lee la nota sobre planificación de ediciones antes de exportar trabajos para un servidor Enhanced.
Usa la primera sesión como una prueba de navegación
Usa WASD para moverte, mantén Shift para acelerar y arrastra con el botón izquierdo del ratón para girar la cámara. La rueda cambia el zoom y la velocidad básica. Pulsa T para mostrar la barra principal. Activa la selección de entidades, haz clic derecho en un objeto e inspecciona sus detalles.
Todavía no muevas ese objeto. Abre la ventana Project Window, crea un proyecto y guárdalo en tu directorio de trabajo. Un archivo .cwproj es tu proyecto del editor; no es un recurso de mapa FiveM.
Un espacio de trabajo útil separa las entradas de las salidas:
cw-workshop/
source/ # Blender files and editable project files
exports/ # Interchange files and exported game assets
resource/ # Only the files intended for FiveM
notes/ # Tool versions, game build and test observations
Los nombres de las carpetas son una sugerencia de organización, no un requisito de CodeWalker.
Cuando la aplicación no se inicia
Registra el error exacto, la versión de la aplicación y la edición del juego seleccionada. Comprueba los requisitos de la versión y la integridad de la extracción. Un mundo vacío y una aplicación que falla antes de abrirse son problemas distintos; explica cuál tienes cuando pidas ayuda.
No intentes corregir un error de inicio desactivando programas de seguridad, descargando un ejecutable reempaquetado o sustituyendo archivos del juego sin relación con el problema. El autor describe CodeWalker expresamente como un trabajo en curso; los cierres inesperados pueden ser fallos de la aplicación, no una prueba de una instalación incorrecta.
Continúa con los controles de navegación y edición, después crea un primer YMAP pequeño.