[4ian]

Turns the 3D GTA with a map (#1081, with its scattered forests from #1084 and its tunnel from #1089, all merged) into a starter that themes can re-skin, ground and forests included.

Targets the branch of #1082 (theme support for custom objects and scattered models), which is rebased on the latest main. Merge order: #1082, then this one.

What changed

• examples/3d-gta-with-a-map is moved to examples/starting-3d-grand-theft-auto-with-a-map: only starting-* folders are starters, and only starters are themed. The game is unchanged.
• A new theme-slots.json maps:
  • the player, cars and crates (like the GTA starter);
  • the buildings, skyscrapers and houses to building.tower;
  • the trees of the town and the scattered forests (their Model property) to nature.tree, the scattered bushes to nature.grass, the cones and barriers to prop.obstacle;
  • the 4 layers of the terrain (grass, asphalt, rock, concrete) to terrain.ground, terrain.road, terrain.rock and terrain.pavement, with their normal maps;
  • the colors of the grass to terrain.grass.base and terrain.grass.tip.
• It ignores the street lights, the road markings, the invisible map limits and the placeholders of the terrain extension's objects.
• The extensions are updated to their latest versions on the main branch of the extensions repository: Terrain3D (empty collision surface of scattered models without trunk collisions, Give scattered models without trunk collisions an empty collision surface GDevelop-extensions#2310) and ThirdPersonCamera 1.9.0.

How it was tested

• checkStarterThemeSlots passes for all the starters, and every theme applies to it with applyThemeToStarter.
• Its 9 gameplay tests pass with node scripts/run-gameplay-tests.js.
• With the themes built locally from the assets PR (GDevelopApp/GDevelop-assets#704), I applied the pirate and winter themes and ran it in GDevelop (full resolution screenshots):

Not checked

• All the buildings share one slot, so a theme makes every building the same model, scaled to the volume of the one it replaces. Pirate houses look small, and the winter theme's "building" is a decorated tree.
• I haven't checked the database build or the deployment to staging.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Wa8uKpYuQrYqGYnqGCsquj

[github-actions]

Preview the game(s) changed or added in this Pull Request

• https://editor.gdevelop.io?project=https://raw.githubusercontent.com/GDevelopApp/GDevelop-examples/claude/awesome-knuth-vaoj1s-gta-themes/examples/starting-3d-grand-theft-auto-with-a-map/starting-3d-grand-theft-auto-with-a-map.json

---

This is an automatic message displaying links to the games in this PR - double check the JSON in case of doubt.