Troubleshooting

Referral panel does not open

Possible Causes

• Config.Command.enabled is false.
• Command name differs from expected (Config.Command.command).
• Player was not loaded yet and data callback returns empty.

Fix

• Enable command in config.lua.
• Use the configured command value.
• Confirm framework load event is firing and server gcm_referral:load runs.

Code submission always fails

Possible Causes

• Player is trying to claim own code.
• Player already has claimedcode.
• Target code does not exist in gcm_referral_users.

Fix

• Use a different referral code.
• Reset claimedcode in DB only if intended.
• Verify target code row exists and is unique.

Claims or items do not update in UI

Possible Causes

• Database import is missing one or more tables.
• SQL permissions prevent read/write operations.
• Admin lacks configured group permissions.

Fix

• Re-import database.sql.
• Check MySQL user privileges and server logs.
• Validate Config.GroupPermissions and ACE/framework group mapping.

Webhook logs not delivered

Possible Causes

• Config.Logs.enabled is false.
• Webhook URLs are invalid or revoked.

Fix

• Set Config.Logs.enabled = true.
• Replace webhook URLs with valid active endpoints.

Implementation Risk Notes

Incomplete Integration Hooks

Custom.Reward and Custom.GetPlayerVip are stubs by default, so reward/VIP behavior may be incomplete until customized.

Sensitive Webhooks in Config

Config currently ships with concrete webhook values; rotate and replace with your own secured endpoints before production.

Mixed Identifier Sources

Code uses license-based identifiers in multiple paths. Ensure your server identity strategy is consistent across framework and vehicle integrations.