FAQ

FAQ - Frequently Asked Questions

Common questions and answers about the GOD - Nail Trap System.

General Questions

Q: What frameworks does this script support?

A: The script supports:

• QBCore - Full native support

• ESX (es_extended) - Complete compatibility

• Qbox - Full support

Configure your framework in shared/config.lua with J0.Core.

Q: Which inventory systems are supported?

A: The script supports:

• ox_inventory - Native export integration

• qb-inventory - Framework function integration

Set your inventory system in shared/config.lua with J0.Inventory.

Q: Do I need a targeting system?

A: While not strictly required, a targeting system is recommended for the best experience. Supported systems:

• ox_target (Recommended)

• qb-target

• interact

You can set it to "interact" for basic functionality without a targeting resource.

Q: What is the performance impact?

A: The script is optimized for 0.00ms resmon usage. It uses efficient collision detection and automatic cleanup to maintain optimal performance.

Q: How many nails can be deployed at once?

A:

• Single nails: Unlimited (limited by server performance and cleanup timer)

• Nail package: Maximum 20 nails per package use

Installation Questions

Q: The script won't start. What's wrong?

A: Check the following:

1. Ensure ox_lib is installed and started before J0-nailScript in server.cfg

2. Verify your framework is running

3. Check console for error messages

4. Ensure all dependencies are installed

Q: Items don't appear in my inventory. Why?

A:

1. Verify item names match exactly: screw_nail and nailspackage

2. Check that items are added to the correct inventory file:

   • ox_inventory: data/items.lua

   • qb-inventory: shared/items.lua

3. Restart your inventory resource after adding items

4. Ensure item images are in the correct directory

Q: Do I need to add items for ESX differently?

A: Yes. For ESX, you need to manually register useable items. See the Installation Guide Step 6 for ESX configuration.

Q: Where do I put the item images?

A:

• ox_inventory: Place in ox_inventory/web/images/

• qb-inventory: Place in qb-inventory/html/images/

Copy screw_nail.png from J0-nailScript/installme/ directory.

Configuration Questions

Q: How do I change how long nails stay on the ground?

A: Modify J0.NailsCfg.CleanUp in shared/config.lua. Value is in minutes. Default is 10 minutes.

J0.NailsCfg = {
    CleanUp = 15, -- Nails stay for 15 minutes
    DamagePerNail = 33.335
}

Q: How do I adjust tire damage per nail?

A: Modify J0.NailsCfg.DamagePerNail in shared/config.lua. Default is 33.335% (3 nails = burst tire).

J0.NailsCfg = {
    CleanUp = 10,
    DamagePerNail = 50.0 -- 2 nails = burst tire
}

Q: Can I use a different nail prop model?

A: Yes, the nail prop model can be customized. Contact support for assistance with custom prop integration.

Q: How do I change the maximum nails per package?

A: The maximum nails per package can be customized. Contact support for assistance with adjusting this setting.

Usage Questions

Q: Can I throw nails from a moving vehicle to stop pursuing police?

A: Yes! This is one of the key features for illegal roleplay. When you use a screw_nail item while inside a vehicle:

• The nail is thrown forward from your vehicle's position

• It lands on the road behind your vehicle

• Any pursuing vehicle (police or otherwise) that drives over it will take tire damage

• Perfect for high-speed chases and escape scenarios! 🚨🚗

Q: How do I place nails?

A:

• Single nail: Use the screw_nail item from inventory

  • On foot: Places nail at your feet

  • In vehicle: Throws nail forward out the window - Perfect for illegal players escaping police! The nail lands behind your vehicle, ready to puncture pursuing vehicles' tires 🚗💨

• Nail package: Use the nailspackage item, then press E repeatedly (up to 20 times)

Q: How do I remove nails?

A: Target a deployed nail with your targeting system and select "Remove Nails". You'll receive a screw_nail item back.

Q: Can I remove nails placed by other players?

A: Yes, any player can remove any deployed nail using the targeting interaction.

Q: Do nails work on all vehicles?

A: Yes, the system detects all 6 wheel positions (front, middle, rear - left and right) and works with all vehicle types.

Q: How many nails does it take to burst a tire?

A: By default, 3 nails (33.335% damage each = 100% total). You can adjust this in configuration.

Q: What happens if I drive over the same nail multiple times?

A: Each nail can only damage a tire once. After contact, the nail is deleted to prevent multiple hits.

Technical Questions

Q: How does the damage detection work?

A: The system continuously checks if vehicle wheel bones are within 0.5 units of a nail. When contact is detected, damage is applied and the nail is removed.

Q: Are nails synchronized across all players?

A: Yes. All nail positions are stored server-side and synchronized to all clients. When a nail is placed or removed, all players are notified.

Q: What happens to nails when the resource restarts?

A: All client-side nail objects are cleaned up when the resource stops. Nails stored server-side will be lost on server restart (they're stored in memory, not database).

Q: Can I save nail positions to a database?

A: The current version stores nails in server memory only. For persistent storage, you would need to modify the server script to save/load from a database.

Q: What's the detection range for nail contact?

A:

• Initial check: 10 units around vehicle

• Tire contact: 0.5 units between tire bone and nail position

Troubleshooting Questions

Q: Nails don't appear when I use the item. Why?

A:

1. Check if the custom prop model is available/streamed

2. Verify targeting system is configured correctly

3. Check client console for errors

4. Ensure ox_lib is running

Q: Nails don't damage tires. What's wrong?

A:

1. Verify you're driving over the nail (within 0.5 units)

2. Check if damage configuration is set correctly

3. Ensure vehicle has proper wheel bones

4. Check console for errors

Q: I get errors about missing exports. What do I do?

A:

1. Verify your framework is running

2. Check that ox_lib is installed and started

3. Ensure targeting system is installed if using one

4. Verify inventory system is running

Q: The targeting interaction doesn't appear. Why?

A:

1. Check J0.Target matches your installed targeting system

2. Verify targeting resource is started before J0-nailScript

3. Ensure targeting system is properly installed

4. Try setting to "interact" as a fallback

Q: Items are consumed but nails don't spawn. Help!

A:

1. Check server console for errors

2. Verify custom prop model exists

3. Check client console for spawn errors

4. Ensure ox_lib progress bar is working

Performance Questions

Q: Will this script lag my server?

A: No. The script is optimized for 0.00ms resmon usage and uses efficient detection methods.

Q: How many nails can I have active at once?

A: There's no hard limit, but performance may degrade with hundreds of nails. The automatic cleanup (default 10 minutes) prevents accumulation.

Q: Does the script use a lot of network bandwidth?

A: No. Nail positions are only synced when placed/removed, not continuously.

Compatibility Questions

Q: Does this work with [insert script name]?

A: The script should work with most vehicle and inventory scripts. If you encounter conflicts, check:

1. Item name conflicts

2. Export name conflicts

3. Resource start order

Q: Can I use this with custom vehicle mods?

A: Yes, as long as vehicles have proper wheel bones (which most do).

Q: Does this work with vehicle damage scripts?

A: Yes, the script only affects tire damage and shouldn't conflict with other damage systems.

Customization Questions

Q: Can I change the nail placement animations?

A: Yes, animations can be customized by modifying the client script. Contact support for assistance with custom animations.

Q: Can I add custom notifications?

A: Yes, modify the notification system in client/cl_utils.lua. The script uses framework notifications (QBCore) or ox_lib notifications (ESX).

Q: Can I restrict nail usage to certain jobs?

A: You would need to modify the server script to add job checks in the useable item handlers.

---

Still have questions? Check the Troubleshooting Guide or contact support.