# OnTheBlock - Street Immersion Mod

A reactive-world crime, street reputation, and roleplay sandbox for GTA V
single-player. OnTheBlock focuses on living consequences: police pressure,
gang politics, detective cases, social heat, NPC memory, vehicles, stash
systems, and a phone/social layer that reacts to what the player actually does.

OnTheBlock includes a credited legacy dealer framework and extends it with a
large set of original systems built around faction warfare, police realism,
street reputation, AI interaction, and persistent world state.

## Features - Free Community Edition

**Drug Dealing Framework** - recruit dealers, stash supply, expand territory,
manage product, control zones, and build street money.

**Faction Warfare** - crews remember violence. Kill a rival and their side can
respond later with walk-ups, drive-bys, hunter cars, safehouse hits, or follow-up
waves.

**Gang Identity** - gang peds use faction-aware colors, territory logic, names,
and speech rules so neighborhoods feel distinct.

**Tactical Police** - cops escalate through contact, challenge, detain, arrest,
and combat states. They use cover, crossfire, callouts, and scene-aware behavior
instead of only teleporting pressure onto the player.

**Suspect Profiles** - police can track clothing, vehicle, mask use, license
plate, vehicle color, and witness descriptions. Change the right evidence trail
and the search can weaken. Leave proof behind and the case follows you.

**Disguise System** - masks and outfit changes affect whether witnesses and
police can identify you.

**Viral Recorder** - witnesses may film you. If footage spreads before you stop
it, your description can become harder to shake.

**Hot Zones** - repeated activity in the same area increases local heat. Cops
patrol more, NPCs react faster, and stores or civilians can treat you
differently until the block cools down.

**Crowd Blending** - dense pedestrian areas can make visual ID harder, giving
the player a believable way to disappear without magic.

**Hood Awareness** - rivals react when you enter their turf, especially if you
are known for hurting their side or wearing the wrong colors.

**Detective Cases** - serious crimes can generate follow-up scenes, detective
questions, evidence buildup, DMs, and warrant logic tied to actual proof.

**Hunter Cars** - rivals can circle the neighborhood looking for you instead of
only spawning on top of the player.

**In-Game Social Feed** - tweets, posts, rumors, diss-track reactions, news
blurbs, and street commentary respond to kills, fame, beefs, and reputation.

**Phone Messenger** - detective DMs, contact messages, snitch tips, gang-member
requests, quick replies, and contact handling live inside an in-game phone UI.

**Reputation Axes** - heat, fear, infamy, street respect, civilian hate, police
hate, gang hate, money rep, and hero perception affect how the world reacts.

**Morning Brief** - daily in-game roundup of the chaos from the previous day.

**Photo Capture** - capture moments in-game and attach them to social posts.

## OnTheBlock Supporter Build

Supporters help fund continued development and get access to supporter builds,
install guidance, license support, patch notes, known-issue tracking, and direct
feedback channels through Discord.

Planned and active supporter-side systems include:

**Live AI Dialog** - talk to NPCs by voice, with character-aware responses,
memory, and personality.

**Area-Aware Speech** - NPC register changes by neighborhood and archetype.

**Detective Interrogation Expansion** - deeper questioning, witness pressure,
and case theory.

**Persistent NPC Identity** - NPCs can keep names, memories, relationships, and
history across sessions.

**Diss Tracks and Rap Beef** - rivals and the player can escalate social beef
through in-world music/social systems.

Supporter page:

```text
https://www.patreon.com/cw/Chris22622
```

## Installation

1. Install ScriptHookV.
2. Install ScriptHookVDotNet 3.6.0+ / the compatible Enhanced SHVDN3 build.
3. Install NativeUI and iFruitAddon2.
4. Drop `OnTheBlock.dll`, `OnTheBlock.ini`, and the `OnTheBlock/` folder into
   your `<GTA V>\scripts\` directory.
5. Launch GTA V single-player. The mod boots automatically.

Do not use this in GTA Online.

## Known Issues

- Very long modded sessions can still be sensitive to game build, SHVDN build,
  other scripts, and install order.
- SHVDN3 DLLs load at game launch. After replacing the DLL, fully restart GTA V.
- Some systems are intentionally configurable because lower-end setups may need
  fewer ambient spawns.
- If a crash happens, `scripts/OnTheBlock_crashtrail.log` and
  `ScriptHookVDotNet.log` are the best truth sources.

## Configuration

Edit `OnTheBlock.ini` to enable or disable systems individually. Common flags:

```ini
SAFE_MODE                = false
EXTRA_SAFE_MODE          = false
COP_SEARCH_BEHAVIOR_ON   = false
ENABLE_DISGUISE_SYSTEM   = false
LIVING_BLOCK_ON          = false
QUIET_TENSION_ON         = false
ACTIVE_HUNT_ON           = false
SNITCH_TIPS_ON           = false
DISS_TRACKS_ON           = false
```

Many ambient systems are configurable because they spawn extra entities. Turn
them on one at a time if you are testing stability.

## Credits

OnTheBlock uses and extends the LSlife framework by Mcal9909 for the original
drug-dealing, dealer, area, and stash-management foundation.

Additional OnTheBlock systems by chris22622 include world reactivity, faction
systems, police/detective logic, suspect profiles, vehicle evidence, warrants,
phone/social systems, NPC memory, AI dialog integration, visuals, supporter
licensing, and many gameplay extensions around the living-block concept.

Special thanks to the SHVDN community and the GTA V single-player modding
community.

## License / Use

OnTheBlock is an unofficial single-player fan project. It requires a legal PC
copy of GTA V and ScriptHookVDotNet. Do not use in GTA Online, FiveM, multiplayer
cheating, money drops, griefing, or ban bypassing.

Free/community files are for personal single-player use. Redistribution,
repackaging, or inclusion in mod packs without explicit permission is
prohibited. Supporter features require an active supporter subscription.
