📞 FAQ & Support

Getting Help

💬 Discord Community

Join our Discord server for:

• Real-time support and assistance

• Feature requests and suggestions

• Updates and announcements

• Script showcases and tips

🔗 Discord Invite: discord.gg/hnVPpj8aT4

Troubleshooting

🚨 Common Issues

Resource Name Error

JC ERROR: Resource must be named 'JC_RestrictedZones' - Script disabled!

Solution:

1. Ensure the resource folder is named exactly JC_RestrictedZones

2. No spaces, different casing, or additional characters

3. Restart the resource after renaming

Framework Not Detected

JC ERROR: No supported framework found!

Solution:

1. Verify ESX or QBCore is installed and working

2. Check that the framework starts before JC_RestrictedZones

3. Update Config.Framework if using specific framework

Database Connection Issues

MySQL connection failed / Table creation error

Solution:

1. Verify oxmysql is installed and configured

2. Check database credentials in server configuration

3. Ensure database user has CREATE TABLE permissions

4. Manually import jc_restrictedzones.sql if needed

Permission Denied Errors

Your job is not authorized to use this system

Solution:

1. Check Config.Jobs.AllowedJobs configuration

2. Verify your job name matches exactly (case-sensitive)

3. Ensure enabled = true for your job

4. Check minimum grade requirements

Zones Not Visible

Zones created but not showing on map/tablet

Solution:

1. Check job permissions (canSeeZonesFrom)

2. Verify zones haven't expired

3. Test with admin permissions

Frequently Asked Questions

❓ General Questions

Q: Does this work with QBCore? A: Yes, the script auto-detects and supports both ESX and QBCore frameworks.

Q: Can I customize the UI colors? A: Yes, all colors are configurable in Config.TabletDesign.

Q: How many zones can be active at once? A: By default, 3 zones per officer. Configurable via Config.Limits.MaxZonesPerOfficer.

Q: Do zones persist after server restart? A: Yes, active zones are stored in the database and restored on restart.

Q: Can I use this with custom frameworks? A: With modifications, yes. Contact support for integration assistance.

🔒 Permission Questions

Q: How do I give admin access? A: Add to server.cfg:

add_ace group.admin "jc.restrictedzones.admin" allow
add_principal identifier.license:YOUR_LICENSE group.admin

Q: Can EMS see police zones? A: Only if configured in canSeeZonesFrom for the EMS job.

Q: Why can't I edit zones from other officers? A: Check canEditZonesFrom configuration and time limits.

🎮 Usage Questions

Q: How do I change the tablet item name? A: Update Config.ItemName and add the item to your inventory system.

Q: Can I disable the tablet prop? A: Yes, set Config.TabletProp.Enabled = false.

Q: How do I change escalation level colors? A: Modify the color values in Config.EscalationLevels.

🔧 Technical Questions

Q: Does it work with custom notification systems? A: Yes, configure Config.Notifications.System = "custom" and specify your resource.

Feature Requests

💡 Requesting Features

1. Join Discord and go to #suggest-a-script

2. Provide detailed description of the feature

3. Explain use case and benefits

Bug Reports

🐛 Reporting Bugs

When reporting bugs, please include:

1. Server Information:

   • Framework (ESX/QBCore version)

   • FiveM artifact version

   • Script version

2. Error Details:

   • Console error messages

   • Steps to reproduce

   • Expected vs actual behavior

3. Configuration:

   • Relevant config.lua sections

   • Server.cfg entries

   • Dependencies installed

4. Screenshots/Videos:

   • UI issues or unexpected behavior

   • Console output

   • Error messages

Update Information

📥 Getting Updates

• Discord announcements for new versions

---

📞 Contact Information

• Discord: discord.gg/hnVPpj8aT4

• Documentation: Updated regularly