# Three-prop source exercise

Original placement data by CodeWalkerMod contributors, 2026-09-20. See ../LICENSE.txt.
No GTA models, textures, collision meshes or third-party mod files are included.

## Contents

- project.cwstudio.json: editable Map Studio project; three prop_roadcone02a placements.
- cw_three_props.ymap.xml: CodeWalker-format source XML, not a native .ymap binary.
- fxmanifest.lua: a minimal map-resource manifest for the eventual native YMAP.

The local positions are (0,0,0), (2,0,0) and (4,0,0); rotations are identity.
Origin (0,0,0) is an exercise coordinate, NOT a verified suitable GTA V location.
Bounds are illustrative. Names reference game assets that you must verify in your
own licensed, matching Legacy installation. The manifest cannot supply those assets.

## Exercise

1. Open the JSON with Map Studio's Open control at /tools/map-studio/.
2. Confirm exactly three props. Move the middle prop and save a new JSON copy.
3. Choose a clear test location in your game and set the project origin accordingly.
4. Export source. In CodeWalker, inspect the YMAP against real assets, calculate
   extents/flags, compile or save native output and reopen it before packaging.
5. Put only the native game file into your test resource's stream directory; keep
   fxmanifest.lua at the resource root. Follow /tutorials/stream-map-fivem/.
6. Confirm all three placements and their positions in a fresh development-server
   session. Record edition, game build, tool builds and any missing dependencies.

## Test status

Source serialization is covered by automated tests. The browser import is checked
separately. Native compilation, CodeWalker reload, terrain alignment, collision and
FiveM gameplay are UNVERIFIED until you actually perform those steps. This example
is not a finished map download, Enhanced conversion or a supported native fixture.

Rebuild text source from the site repository with:
    node scripts/build-learning-examples.mjs