# GOD - Nail Trap System

**Dynamic Road Spike System**

### Overview

Take vehicle pursuits 🚗💨 and tactical gameplay to the next level with a fully interactive Nail Trap System! 🔥⚙️

The GOD - Nail Trap System is a comprehensive road spike solution designed for FiveM servers, providing realistic and immersive nail deployment mechanics for police pursuits, ambushes, and tactical roadblocks.

### Key Features

#### 🎯 Deployable Nails

* **Single-Use Nail (`screw_nail`)**: Deploys one spike at a time. Perfect for precise placement and strategic positioning. 🔹
  * **On Foot**: Plant nails directly at your location for roadblocks and ambushes
  * **In Vehicle**: Throw nails out the window while driving to disable pursuing vehicles! Perfect for illegal players escaping police chases 🚗💨
* **Multi-Throw Nail Package (`nailspackage`)**: Allows players to throw multiple spikes at once (up to 20 nails) for wider coverage. Ideal for creating effective roadblocks. 🔸

#### ⚡ Performance Optimized

* **0.00ms resmon usage** - Zero impact on server performance
* Efficient client-server synchronization
* Automatic cleanup system to prevent memory leaks
* Optimized collision detection for tire damage

#### 🔄 Framework Compatibility

* **QBCore** - Full support with native integration
* **ESX** - Complete compatibility with es\_extended
* **Qbox** - Full support for qbox\_core framework

#### 🎮 Inventory System Support

* **ox\_inventory** - Native integration with export functions
* **qb-inventory** - Full support with useable items

#### 🎯 Targeting System Support

* **ox\_target** - Recommended targeting system
* **qb-target** - Alternative targeting solution
* **interact** - Basic interaction system support

#### 🛣️ Realistic Mechanics

* Custom 3D nail prop that persists on the ground
* Physics-based nail placement with proper ground alignment
* Real-time tire damage calculation based on wheel contact
* Configurable damage per nail (default: 33.335% per nail)
* Automatic cleanup after configurable time (default: 10 minutes)

#### 🚗 Vehicle Interaction

* Detects contact between vehicle wheels and deployed nails
* Applies progressive tire damage based on nail contact
* Supports all 6 wheel positions (front, middle, rear - left and right)
* Instant tire burst when damage threshold is reached (100%)
* **Dynamic Pursuit Defense**: Throw nails from moving vehicles to disable pursuing vehicles' tires in real-time

### Use Cases

* **Police Pursuits**: Deploy spike strips to stop fleeing vehicles
* **Escape Tactics**: Illegal players can throw nails from vehicle windows to disable pursuing police vehicles during high-speed chases 🚨🚗
* **Roadblocks**: Create tactical barriers for checkpoints
* **Ambushes**: Set up traps for strategic gameplay
* **Roleplay Scenarios**: Enhance immersion with realistic road hazards

### Requirements

* **ox\_lib** - Required dependency for progress bars and notifications
* FiveM server with one of the supported frameworks
* Compatible inventory system (ox\_inventory or qb-inventory)
* Compatible targeting system (ox\_target, qb-target, or interact)

### Technical Details

* **Language**: Lua 5.4
* **Game**: GTA V (FiveM)
* **Resource Type**: Client & Server Script
* **Network Synchronization**: Full server-client sync for nail positions
* **Collision Detection**: Real-time wheel-to-nail distance calculation (0.5 unit threshold)

***

**Get ready to enhance your server's tactical gameplay with a system designed for realism and high-stakes action!** 🚨🚗


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://god-studios.gitbook.io/god-studios/god-nail-trap-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.