Troubleshooting

Common issues and implementation notes for gcm_vipsystem.

`/vipmenu` does not open

Possible Causes

Player is not recognized as staff in isPlayerStaff(src) (server/editablesv.lua).
Config.GroupPermissions does not match framework/ACE groups.
ox_lib is not running.

Fix

Validate isPlayerStaff logic and returned permissions.
Align configured groups with your framework and ACE setup.
Ensure ox_lib starts before gcm_vipsystem.

`/code` says code not found

Possible Causes

Code row does not exist in gcm_vips_codes.
Code was already redeemed or removed.
Command label differs from Config.Commands['redeem_code'].

Fix

Verify code row in DB and status.
Regenerate code if it was consumed.
Confirm command label in config and restart resource.

VIP not applied from code

Possible Causes

Player already has an active VIP in a conflicting state.
Invalid viptype not present in Config.Vips.
Identifier mode mismatch (license vs steam).

Fix

Check active VIP state in DB/cache before redeem.
Ensure viptype exists in configured tiers.
Keep identifier mode consistent across the whole server.

Discord roles are not changing

Possible Causes

Discord role sync is disabled.
Invalid bot token or guild id.
VIP tier has roleID = '0' or invalid role id.

Fix

Enable Config.DiscordRoles.enable.
Set valid botToken and serverId.
Configure proper role IDs for each VIP tier.

Paycheck bonus not running

Possible Causes

Paycheck system is disabled.
Framework detection failed.
Account name does not exist in your framework.

Fix

Enable Config.PaycheckSystem.enable.
Validate framework detection in startup logs.
Use a valid account name (bank, etc.) for your framework.

Tebex bridge command issues

Possible Causes

gcmtebex is executed outside console context.
Invalid arguments passed to the Tebex bridge command.
Log formatting issue around dias variable in one branch.

Fix

Run gcmtebex only from server console/integration layer.
Validate argument format and payload source.
Patch the dias log formatting line if needed.