Description
Addon To Street is a beta script that brings your installed addon peds into the GTA V world without replacing any vanilla models. They can walk around, stand still, smoke, use their phones, and blend into the city like regular NPCs.

Features
- JSON-based spawn system. Spawn points are stored in PedSpawnPoints.json and are created automatically by the included AddonToStreetScanner.exe, so you do not need to edit coordinates manually.
- Addon peds spawn near the player within a configurable radius and are removed automatically when they move too far away or die.
- Advanced spawn control. Enable or disable individual addon ped models from the in-game menu. Your changes are saved and stay active across sessions.
- Ambient activities. Spawned peds can stand, wander, smoke, use a phone, or hold a coffee cup.
- Configurable settings. Scan radius, maximum spawned peds, spawn chance, and minimum spawn distance can all be adjusted in the in-game menu with left and right arrow navigation.
- Blip support. Optional map and minimap blips are available for all active addon peds, with a customizable color.
- Model validator. The Model List submenu shows which models from your INI file are valid and loadable.
- Session log. A Log.txt file is created in the settings folder and resets each time you launch GTA V, so logs do not build up over time.

Requirements
- Script Hook V
- ScriptHookVDotNet v3 Nightly
- LemonUI
- Addon Ped Selector, required to install and register your addon peds

Configuration (In-game menu, F7)
- Enable. Turns the entire script on or off.
- Scan Radius. Sets the radius in meters around the player where addon peds are allowed to spawn.
- Max Addon Peds. Sets the maximum number of addon peds active in the world at once.
- Spawn Chance. Sets the spawn probability per tick. Higher values create more frequent spawns. Maximum is 80%.
- Min Spawn Distance. Sets the minimum distance from the player for a spawn. This prevents peds from appearing right in front of you.
- Reload Spawn Points.
- Clear All Spawns. Removes all active addon peds immediately. They will respawn automatically unless the script is disabled.
- Advanced Spawn. Lets you enable or disable individual models. The submenu header shows the active model count and includes Enable All and Disable All shortcuts.
- Blip Settings. Enables map-only or map plus minimap blips for spawned peds. Color options include White, Red, Green, Blue, Yellow, Purple, Orange, Pink, and Cyan.
- Model List. Shows all models loaded from AddonToStreet.ini and whether each one is valid and loadable by the game.

Notes
- This script is in beta. Some addon ped models may not work perfectly with GTA V’s streaming system.
- Some addon peds may spawn on top of buildings because of spawn point elevation. This is a known beta limitation.
- PedSpawnPoints.json can contain thousands of spawn coordinates.
- If you add new addon peds through Ped Selector after the first scan, run the scanner again and use Reload Spawn Points in the menu.

Troubleshooting
Why does the game crash or close?
- Your GTA V VRAM may be full. Lower graphics settings or reduce Max Addon Peds.
- One of your addon peds may not be compatible with your game version. Test each model individually in Addon Ped Selector first.
- Some addon peds are not compatible with script-based spawning.

Why are textures missing or broken?
- Some addon ped models cannot be active at the same time without texture conflicts. Lower Max Addon Peds or disable specific models in Advanced Spawn until you find the problem model.

Why does the scanner not find my addon peds?
- The wrong GTA V folder was selected. Make sure it is the folder that contains GTA5.exe.
- No addon peds have been installed through Addon Ped Selector yet. The scanner reads from Ped Selector data.

Installation Instructions
- Install Script Hook V and ScriptHookVDotNet v3 Nightly for x64.
- Install LemonUI and Addon Ped Selector, then follow their installation steps.
- Make sure at least one addon ped is already installed and working through Addon Ped Selector.
- Copy all files from the scripts folder into your GTA V scripts folder.
- Place AddonToStreetScanner.exe and CodeWalker.Core.dll in your GTA V root folder, where GTA5.exe is located.
- Run AddonToStreetScanner.exe as Administrator.
- Select your GTA V installation folder in the scanner, then click Start Scan.
- The scan will succeed if it detects the addon peds installed through Ped Selector.
- Launch GTA V and press F7 to open the menu.

Credits
- DexterLooo, script and scanner