Description: Defines how long (in minutes) nails will stay on the ground before they are automatically removed.
Default:10 minutes
Recommended Values:
5 minutes - For fast-paced servers
10 minutes - Balanced gameplay (default)
15 minutes - For longer tactical scenarios
30 minutes - Extended roadblock scenarios
Note: Setting this too high may cause performance issues if many nails are deployed. Setting it too low may remove nails before they're useful.
DamagePerNail
Description: Determines how much tire damage a single nail will cause when a vehicle's wheel makes contact with it.
Default:33.335 (approximately 33.33%)
How It Works:
Damage is cumulative per tire
Each nail contact adds this percentage to the tire's damage
When damage reaches 100%, the tire bursts instantly
With default value: 3 nails = 100% damage (tire burst)
Recommended Values:
25.0 - 4 nails needed to burst tire (more realistic)
33.335 - 3 nails needed to burst tire (default, balanced)
50.0 - 2 nails needed to burst tire (more effective)
100.0 - 1 nail instantly bursts tire (very effective)
Calculation Example:
Complete Configuration Example
Here's a complete configuration example for a QBCore server with ox_inventory and ox_target:
Advanced Configuration
Custom Prop Model
If you want to use a different nail prop model, contact support for assistance with custom prop integration. The system supports custom prop models but requires proper configuration.
Nail Package Maximum Uses
The maximum number of nails per package can be customized. Contact support for assistance with adjusting this setting.
Damage Detection Range
The damage detection range can be customized. Contact support for assistance with adjusting detection ranges and thresholds.
Tire Contact Threshold
The tire contact threshold determines how close a tire needs to be to a nail for damage to occur. Contact support for assistance with customizing this setting.
Configuration Best Practices
Test After Changes: Always test configuration changes in a development environment first
Balance Settings: Adjust DamagePerNail and CleanUp to match your server's gameplay style
Performance: Monitor server performance when adjusting detection ranges
Framework Match: Ensure framework selection matches your actual server setup
Inventory Match: Verify inventory system matches your installed inventory resource
Verifying Configuration
After making changes:
Restart the J0-nailScript resource
Check server console for any configuration errors
Test nail placement and damage in-game
Verify targeting interactions work correctly
Confirm inventory items function properly
Troubleshooting Configuration
Script Not Working After Config Change
Verify syntax is correct (no typos, proper quotes)
Check console for Lua errors
Ensure all values are valid (numbers for CleanUp and DamagePerNail)
Wrong Framework Behavior
Double-check J0.Core matches your framework
Verify framework resource is running
Check framework exports are available
Targeting Not Working
Verify targeting system is installed and running
Check J0.Target matches your installed targeting system
Ensure targeting resource is started before J0-nailScript
Inventory Issues
Confirm J0.Inventory matches your inventory system
Verify inventory resource is running
Check item exports/functions are working
Configuration complete! Your Nail Trap System is customized for your server. ⚙️
J0.NailsCfg = {
CleanUp = 10, -- Time (in minutes) before deployed nails automatically disappear
DamagePerNail = 33.335 -- Damage percentage applied to a vehicle's tire upon contact with a nail
}
Tire Damage = (Number of Nail Contacts) × DamagePerNail
If Tire Damage >= 100, then Tire Bursts
J0 = {}
-- Core framework selection
J0.Core = "QBCore"
-- Targeting method selection
J0.Target = "ox_target"
-- Inventory system selection
J0.Inventory = 'ox'
-- Nails system settings
J0.NailsCfg = {
CleanUp = 10, -- Nails disappear after 10 minutes
DamagePerNail = 33.335 -- Each nail does 33.335% tire damage
}