Repository files navigation

A plugin for Grand Theft Auto V that generates a labeled LiDAR point cloud from the game environment.

• Grand Theft Auto V
• ScriptHookV

1. InstallScriptHookV following its accompanying instructions
2. Copy-pasteLiDAR GTA V.asi and theLiDAR GTA V folder from the latestrelease into your GTA-V directory (the folder containingGTAV.exe)

1. Navigate to#your_game_directory#/LiDAR GTA V/LIDAR GTA V.cfg and edit the parameters as needed. The parameters include: Horizontal FOV, Vertical FOV, Range, Density and Output filename

2. Start up GTA-V in story mode

3. PressV to cycle through camera modes until first person mode is enabled

4. PressF6 to generate a LiDAR point cloud of the world.

5. Output file is located under#game_directory#/LiDAR GTA V/#your_chosen_filename#.ply

6. The output is a Polygon File Format (.PLY) file containing only vertex data

7. Vertex Color Code:

   Vertex Color	Label
   Red	Vehicle
   Green	Humans and Animals
   Blue	Game props
   White	Road, Buildings and other hitable textures
   Black	No hit

8. It is recommended to useCloudCompare (an open-source point-cloud viewer) to view the PLY file generated byLiDAR GTA V

• You will need Visual Studio 2019 or higher to open this project

• The project requires theDesktop development with C++ workload to be installed in Visual Studio

• The project is targetted at Visual Studio Platform Toolsetv142

• To make development easier, the project will automatically copy the compiledLiDAR GTA V plugin to the directoryD:\Games\GTAV\ after building

  You may want to set this path to point to your GTA-V installation directory. This can be done by right-clickingLiDAR GTA V in theSolution Explorer and editing theCommand Line field underConfiguration Properties -> Build Events -> Post-Build Event -> Command Line

• Any contributions to the project are welcomed, it is recommended to use GitHubPull requests

• Native Trainer (a ScriptHookV sample) was used as a starting point to import configuration

• You are free to use this project in your work. However acknowledgement and a link to this repository would be greatly appreciated. If you do use this project in your work, I would love to hear about it, please drop me an email at19100135@lums.edu.pk
• The LiDAR-GTA-V source code is licensed under theMIT license. Source content taken from other projects is tagged with the respective licenses wherever found