Exports and Statebags

• Context: client export
• Signature:

local vipType = exports['gcm_vips']:getVip()

• Returns:
  • VIP key string (for example vip_oro) when active
  • false when player has no active VIP

Usage example

local vipType = exports['gcm_vips']:getVip()
if vipType then
    print(('Player VIP is %s'):format(vipType))
end

• Context: server export
• Signature:

local vipType = exports['gcm_vips']:getVip(source)

• Returns:
  • VIP key string if active
  • false otherwise

Usage example

local vipType = exports['gcm_vips']:getVip(source)
if vipType == 'vip_diamante' then
    -- apply premium server-side logic
end

• Context: server export
• Signature:

local ok = exports['gcm_vips']:giveVipUser(src, vipType, days)

• Parameters:

  • src (number): target player source
  • vipType (string): key in Config.Vips
  • days (number): duration in days (0 means lifetime)

• Returns:

  • true on inserted/extended VIP
  • false on failure or incompatible active VIP state

Usage example

local ok = exports['gcm_vips']:giveVipUser(source, 'vip_oro', 30)
if not ok then
    print('VIP grant failed')
end

• Context: server export
• Signature:

local remaining = exports['gcm_vips']:getDaysRemaining(src)

• Returns:
  • number (days remaining)
  • 'lifetime'
  • false when no active VIP

Usage example

local remaining = exports['gcm_vips']:getDaysRemaining(source)
if remaining == 'lifetime' then
    print('Permanent VIP')
elseif type(remaining) == 'number' then
    print(('VIP expires in %s days'):format(remaining))
end

At the moment, there are no documented statebag keys in gcm_vips. If statebag keys are added in future updates, they will appear here with ownership notes and read/write examples.