Editing with CodeWalker

CodeWalker is the free editor everyone uses for GTA V maps. It reads your GTA install and lets you open, edit and save .ymap files.

Before you start

• Don’t edit the map in place. Copy the ymap you want to change into your own resource, or keep a copy of the original. The next update of the map overwrites its own folders.
• Work on a test server. Reconnect (and clear the FiveM cache) every time you test a streamed file, FiveM keeps old versions around.

Edit an existing ymap

1. Find the file. ymaps sit under stream/ in each resource, grouped by area (for example apocalypse-statewide/stream/regions/landmarks/). The Locations reference lists which ymap each place comes from.
2. In CodeWalker open the project window, create a project and add the ymap to it.
3. Fly to the place, select props and move, rotate or delete them. Keep props on the ground and out of doors, garages and roads people need.
4. Let CodeWalker recalculate the extents before saving. Inflated extents make the engine think the ymap is in range from kilometres away, which is what fills the pools.
5. Save, put the file back in the stream/ folder of your resource and restart it.

Add your own ymap

Make a small resource next to the map, so updates never touch it:

resources/[the_apocalypse_project_custom]/my-places/
├── fxmanifest.lua
└── stream/
    └── my-camp.ymap

fx_version 'cerulean'
game 'gta5'
this_is_a_map 'yes'
dependency 'apocalypse-core'   -- only if you use the map's custom props

ensure [the_apocalypse_project]
ensure [the_apocalypse_project_custom]

Custom props (.ydr with their own .ytyp) also need the archetype file registered:

data_file 'DLC_ITYP_REQUEST' 'stream/my_props.ytyp'

House rules the map follows

Same rules apocalypse-world-core uses for its own placements, worth copying:

• Don’t block doors, garages, MLO and IPL entrances or intersections.
• Keep safezones and anything your framework spawns (traders, bases, mission spots) clear.
• Static clutter stays static, only wrecks are physical.
• Don’t ship CodeWalker project files, screenshots or backups inside the streamed folders. Players would download them.