For the complete documentation index, see llms.txt. This page is also available as Markdown.

Common Errors

πŸ”΄ The weapon is given but the gun doesn't delete anything

Cause: The player has the weapon but doesn't have the required permissions.

Fix: Make sure the permission system is correctly configured:

  • ACE: Check that add_ace group.yourgroup madonne.deletegun allow is present in your server.cfg and that the player is in the correct group.

  • MadonnAdmin: Ensure MS_MadonnAdmin is started before MS_Delete_Gun and that the player has a valid staff rank.

  • Custom: Verify that your GetPerms function in customs/perms.lua returns true for the player.


πŸ”΄ The weapon is not automatically given on join

Cause 1: AUTOMATICALLY_GIVE_WEAPON is set to false.

Fix: Set it to true in config/main.lua.

Cause 2: The player doesn't have the required permissions, so the weapon is intentionally not given.

Fix: Grant the player the correct permission (see above).

Cause 3 (ESX + ox_inventory): The INVENTORY option is not set correctly.

Fix: Make sure FRAMEWORK is set to "esx" and INVENTORY is set to "ox" if you are using ox_inventory.


πŸ”΄ Notifications are not showing up

Cause: The NOTIFICATION_TYPE is set to a system that is not running on your server.

Fix: Either:

  • Set NOTIFICATION_TYPE to "auto" to let the resource detect the available system automatically.

  • Set it to "default" to use the native GTA V notification.

  • If using "other", make sure your custom handler is correctly defined in customs/notifs.lua.


πŸ”΄ Multi-mode command doesn't work

Cause: ENABLE_MULTI_MODE is set to false.

Fix: Set ENABLE_MULTI_MODE to true in config/main.lua, and make sure config/modes.lua is properly configured with at least one mode.


πŸ”΄ The resource loads but nothing happens (no weapon, no permissions)

Cause: The INIT_DELAY may be too short, causing the resource to check permissions before the player is fully loaded.

Fix: Increase the INIT_DELAY value in config/main.lua (e.g. set it to 3 or 5).

⚠️ If you are using MadonnAdmin, an additional 10-second delay is always applied on top of INIT_DELAY. This is normal behavior.


πŸ”΄ MS_Delete_Gun throws errors on start

Cause: A dependency resource is not started before MS_Delete_Gun.

Fix: Make sure your server.cfg starts resources in the correct order:


πŸ”΄ You lack the required entitlement to use MS_Delete_Gun

This message indicates that your server does not have the necessary entitlement to start the resource. This is related to FiveM's Escrow protection system.

Check the following points one by one:

  • βœ… The CFX Portal key listed in your server.cfg does not contain any typing error

  • βœ… The CFX Portal key belongs to the FiveM account that was used to purchase or claim the resource

  • βœ… The resource has been successfully claimed on the CFX Portal

  • βœ… The CFX Portal key linked to your server belongs to you, and not to your hosting provider

⚠️ Important warning about hosting provider keys

Some hosting providers include a shared CFX Portal key as part of their offers. We strongly advise against using such keys. A key that does not belong to you will block the use of any resource protected by FiveM's Escrow system, without exception β€” not just this one. Always use your own personal CFX Portal key.


πŸ’¬ Still having issues?

If you are still experiencing problems after following the steps above, feel free to reach out to us:

Last updated