CodeWalker-Anleitung: Download, Einrichtung und Kartenbearbeitung

CodeWalker ist ein Windows-Tool zum Anzeigen von GTA V-Archiven und zur Arbeit mit Kartendaten. Lade es ausschließlich aus dem offiziellen CodeWalker-Repository oder über das Angebot des Autors auf GTA5-Modsherunter. Verwende keine fremden Downloadspiegel oder neu gepackten Programmdateien.

Bestätige die Ziel-GTA-Edition, bevor du Assets installierst oder exportierst. Legacy-Pakete sind nicht automatisch Enhanced-ready; befolge die offizielle Anleitung zur Enhanced-Asset-Konvertierung wenn dies dein Ziel ist.

Was CodeWalker tut – und was es nicht tut

CodeWalker kann GTA V RPF-Archive durchsuchen, die Welt rendern, Entitäten inspizieren, Projekte erstellen und Kartendateien wie YMAP bearbeiten. Sein Projektfenster unterstützt auch andere vom Autor beschriebene Spieldatenformate. Es ist kein Ersatz für eine 3D-Modellierungssoftware, Versionskontrolle, Backups oder einen FiveM-Testserver im Spiel.

Anforderungen und sichere Download-Quellen

Das Repository nennt einen 64-Bit-Windows-PC, eine PC-Version von GTA V, DirectX-11-fähige Grafik und die erforderliche .NET-Laufzeitumgebung. Prüfe vor der Installation die aktuelle Dokumentation des Autors, da sich Entwicklungsbuilds und Anforderungen ändern können.

• Offizielles GitHub-Repository von dexyfex für Quellcode und Projektdokumentation.
• GTA5-Mods-Seite des Autors für die veröffentlichte Distribution.

Konfiguriere den GTA V-Pfad

1. Extrahiere das vom Autor bereitgestellte Archiv in einen dedizierten Werkzeugordner.
2. Starte CodeWalker von diesem Ordner aus.
3. Wähle beim ersten Start das Stammverzeichnis deiner GTA V-Installation aus, falls CodeWalker es nicht automatisch erkennt.
4. Warte, bis die anfänglichen Weltdaten geladen sind, bevor du davon ausgehst, dass die Anwendung blockiert ist.

World View und Project Window verwenden

World View dient der visuellen Navigation. Die dokumentierte Steuerung nutzt WASD zum Bewegen, Ziehen mit linker Maustaste zum Drehen der Kamera und das Mausrad für Zoom und Bewegungsgeschwindigkeit. Öffne die Toolbox zum Prüfen ausgewählter Objekte und die Hauptwerkzeugleiste zum Wechseln der Auswahl- und Transformationsmodi.

Erstelle und speichere ein .cwproj -Projekt vor der Bearbeitung. Das Project Window hält Dateien und Objekte der aktuellen Aufgabe zusammen. Das Bearbeiten eines Objekts bei geöffnetem Fenster kann die zugehörige YMAP dem Projekt hinzufügen.

Arbeite mit YMAP- und YTYP-Projekten

Eine YMAP verwaltet gewöhnlich Platzierungen in der Welt. Eine YTYP beschreibt Archetypen und kann Informationen für Innenraumabläufe enthalten. Bewahre Quelldateien, Exporte und die fertige FiveM-Ressource in getrennten Ordnern auf, damit ein Export nicht die einzige bearbeitbare Kopie überschreibt.

1. Erstelle oder öffne ein Projekt und füge nur die für diese Karte erforderlichen Dateien hinzu.
2. Wähle Entitäten in der Weltansicht aus und bewege, drehe oder skaliere sie dann gezielt.
3. Speichere bearbeitete YMAP-Dateien aus dem Projektfenster und überprüfe den Ausgabepfad.
4. Prüfe bei MLO-Arbeiten Änderungen an YTYP, Räumen, Portalen und Archetypen im Rahmen des vollständigen Innenraumablaufs.

Exportiere, sichere und teste

Kopiere vor jeder Bearbeitung den gesamten Projektordner in eine datierte Sicherung. Exportiere in einen getrennten Buildordner, vergleiche die Dateiliste mit dem Projekt und bewahre den letzten funktionierenden Build auf. Der CodeWalker-Autor beschreibt das Werkzeug als noch in Entwicklung. Abstürze und unvollständige Darstellung sind daher möglich; häufiges Speichern und rücknehmbare Änderungen sind wichtig.

Verpacke das Ergebnis als FiveM-Ressource

Ein gängiges Kartenressourcenlayout behält das Ressourcenmanifest im Ressourcenstamm und exportierte Kartenassets in einem stream Verzeichnis. Veröffentliche nicht das rohe CodeWalker-Projekt als Serverressource. Verwende die FiveM MLO Erstellungsanleitung für den vollständigen Workflow für Modellierung, Export, Manifest und In-Game-Validierung.

my-map/
├── fxmanifest.lua
└── stream/
    ├── map.ymap
    └── archetypes.ytyp

Häufige CodeWalker-Probleme

• Die Welt ist leer oder wird noch geladen: prüfe das GTA-V-Stammverzeichnis und warte, bis der erste Ladevorgang abgeschlossen ist.
• Ein Bearbeitungsschritt fehlt im Projekt: bestätige, dass das Projektfenster geöffnet war und die korrekte YMAP Teil des gespeicherten Projekts ist.
• Der Server zeigt die alte Karte an: vergleiche die exportierten Dateien mit dem stream -Ordner der Ressource und starte nur die vorgesehene Testressource neu.
• CodeWalker stürzt ab: Öffne das zuletzt bekannte gute Projekt wieder und reduziere die Änderung auf die kleinste reproduzierbare Bearbeitung, bevor du sie upstream meldest.