Hitman: Contracts (GTA: V -SP) Mod Missions

# Hitman: Contracts (Mod Pack) — Expanded Edition

A fully modular, contract-driven assassination system for **GTA V Legacy :Single Player Mode**, originally developed by **LouiDev** and now **unofficially maintained, updated, and expanded by Asterisk**.  

This rebuild modernizes the entire experience while keeping the original design philosophy intact.

Original version:  

https://github.com/LouiDev/gtaV-DefaultHitmanContractPack

---

# 🧰 Framework Overview

The system is powered by a clean **core DLL architecture** (`HitmanMod.dll`) that allows creators to add, remove, or update contract packs without touching the main mod.  

Every contract is its own self-contained module, supporting:

• - Unique mission logic  
• - Custom target behaviors and AI  
• - Specialized locations (interior/exterior)  
• - Optional bonus and stealth objectives  
• - Scripted cutscenes, diversions, and events  
• - Pack-based organization for easy installation  
• - Future-proof modular expansion  

Asterisk’s continuation expands mission variety, improves reliability, and fixes long-standing issues across the entire contract ecosystem.

---

# 📱 How to Use

1. - Open your in-game phone and call the **Hitman HQ** contact to receive a *random* contract.  
2. - Or go to the **Hitman HQ building** (marked with a crosshair icon on the map).  
3.   - Walk up to the computer to browse and select a *specific* contract.  
4.   - The front desk also displays your **contract statistics**.  
5. - Once a contract begins, instructions will come through your phone step-by-step.

 Many contracts include **optional objectives**—completing these grants **additional payout bonuses**.

---

# 🔧 What’s Improved in the Maintained Edition

## Stability & Crash Fixes

1. - Fixed crashes involving hack-based contract triggers.  
2. - Resolved key-steal crashes in the plane crash mission.  
3. - Patched scenarios where peds failed to spawn or loaded invalid.  
4. - Fixed missing blips, markers, or broken mission stages.  
5. - Cleaned up outdated Burger Shot meeting areas causing softlocks.  
6. - Patched NPC behavior so meetings always occur as intended.  
7. - Added null-safety to all contract classes.  
8. - Corrected spawns inside blocked or invalid navmesh areas.  
9. - Removed duplicated dialogue, prompts, and TTS spam.  
10. - Fixed repeating TTS speaker-name announcements.  
11. - Corrected timing issues where TTS waited until text finished.  
12. - Fixed entities lingering after missions.  
13. - Repaired contract loading issues within HitmanMod.dll.  
14. - Updated all interior coordinates to valid IPL-loaded versions.  
15. - Fixed broken phone-contact entries and flickering UI transitions.

---

# 🎮 Logic & Presentation Enhancements

1. - Meeting scenes now spawn both participants properly and instantly.  
2. - Verified all interior & exterior locations for accuracy.  
3. - Updated contract descriptions, instructions, and phone texts.  
4. - Refined detection logic, stealth rules, and distance checks.  
5. - Standardized contract structure for all packs (Start/Update/Cleanup).  
6. - Sequential objective system rebuilt for clean transitions.  
7. - Safety fallback spawns added for all mission-critical NPCs.  
8. - Overhauled stealth bonuses and alert-state logic.  
9. - Improved mission markers and navigation clarity.  
10. - Smarter vehicle spawn rules to avoid collision/reset issues.  
11. - Cleanup system fully rewritten for stability.

---

# 🔊 Audio & UI Fixes

1. - Text-to-speech now reads *live* in sync with each message.  
2. - Removed TTS repeating the speaker name every line.  
3. - Reduced phone UI flicker during objective changes.  
4. - Improved subtitle timing and pacing.

---

# 🆕 New Content Added

## New Contracts (7 Total)

1. - **CoffeeMeeting** — Interior meetup with stealth paths.  
2. - **BarDeal** — Undercover exchange in a bar.  
3. - **ParkingLotExchange** — Surveillance-style contract.  
4. - **BeachMeeting** — Casual beachfront hit with discreet options.  
5. - **SniperContract** — Long-range assassination with distance rules.  
6. - **StealthElimination** — Full undetected run required.  
7. - **RoofTopSniper** — High-elevation hit from skyscraper vantage points.

**Total active contracts:** **17**

---

# 🛠️ Additional Features

1. - **Executions** (context takedowns)  
2. - **DragDead** (body relocation for stealth)  
3. - **BulletCam** (slow-motion cinematic kill shots)  
4. - New helper utilities for interiors, pathfinding, and spawn validation  
5. - Expanded modular API for future contract creators  

---

# 🧩 Under-the-Hood Improvements

1. - Reworked spawn validator for peds, props, and vehicles.  
2. - Standardized Start/Update/Abort/Cleanup lifecycle.  
3. - Updated all coordinates to reflect valid IPL states.  
4. - Patched DLL reference mismatches.  
5. - Added memory leak protection throughout mission flow.  
6. - Modularized helper APIs for easier expansion.  
7. - Optimized phone-instruction logic and UI behavior.  
8. - Repaired stealth detection and hit validation triggers.

---

# ⚠️ Known Non-Critical Issues

• - ContractStatsUI disabled until the LemonUI update.  
• - CelebrityContract disabled until custom model imports are ready.  
• - Minor phone-app glitch originates from HitmanMod.dll, not this pack.

---

# 🏁 Final Notes

This updated and expanded edition modernizes the entire HitmanMod contract system—adding reliability, mission variety, stronger AI, synced TTS, and zero progression-breaking bugs.

Maintained by **Asterisk (Iron Will Interactive)**.  

Original development by **LouiDev**.