Collector System

Rotating NPC that requests specific high-value cards for premium payouts

Collector NPC

The Collector is a rotating NPC that requests specific high-value cards on a timer. Players who meet the condition or CVG grade thresholds earn premium payouts. Requests rotate automatically, creating a dynamic end-game loop that rewards dedicated collectors.

Collector Configuration

The Collector is configured in configcollector.lua and supports automatic random selection or a manual card list.

Config.Collector = {
  enabled = true,
  currency = 'cash',
  rotation = {
    intervalSeconds = 3600,       -- Rotation interval (seconds)
  },
  ped = {
    location = vector4(315.53, -71.04, 71.31, 71.69),
    model = 'cs_bankman',
    scenario = 'WORLD_HUMAN_CLIPBOARD',
    blipenabled = true,
    blipname = 'Collector',
    blipid = 605,
    scale = 0.4,
    blipcolor = 5
  }
}

Request Types

The Collector supports two request types, each with its own quota and payout multiplier.

Normal Card Requests

• Requests raw (ungraded) cards
• Minimum condition threshold required
• Payout uses normalMultiplier on base sell price
• Up to quota limit per rotation

CVG Graded Requests

• Requests graded slabs only
• Minimum CVG grade threshold required
• Payout uses cvgMultiplier on base sell price
• Separate quota from normal requests

Quotas & Payouts

Control how many cards the Collector accepts per rotation and the payout multiplier for each type.

quotas = {
  normal = 8,                    -- Max normal cards per rotation
  cvg = 4                        -- Max CVG graded cards per rotation
},
payout = {
  normalMultiplier = 1.35,       -- 1.35x base sell price for normal cards
  cvgMultiplier = 1.6            -- 1.6x base sell price for CVG slabs
}

How Payouts Work

• Normal card payout = card base sell price × normalMultiplier
• CVG slab payout = card base sell price × cvgMultiplier × CVG grade multiplier
• Per-player trade limit per requested item resets each rotation
• Button greys out after a player completes a trade for that item

Filters & Rarity Control

Set minimum quality thresholds and control which rarities the Collector will request.

filters = { 
  minCondition = 90,             -- Minimum card condition (1-100)
  minGrade = 9,                  -- Minimum CVG grade (1-10)
  rarities = {
    allow = {
      Normal = false,
      Uncommon = false,
      Rare = false,
      Epic = false,
      Legendary = true,          -- Only Legendary and above
      Holo = true,
      OriginalArt = false
    }
  }
}

Filter Mechanics

• minCondition: Cards below this condition are rejected
• minGrade: CVG slabs below this grade are rejected
• rarities.allow: Set true/false per rarity to control what the Collector requests
• Only allowed rarities appear in the Collector rotation

Card Selection Mode

Choose between automatic random selection from your card pool or a hand-picked manual list.

selection = {
  useManualList = false,         -- false = random from configcards.lua
  manualList = {
    normal = {                   -- Manual list of normal card requests
      -- 'card_merryweather_hq',
      -- 'card_faggio',
    },
    cvg = {                      -- Manual list of CVG card requests
      -- 'card_merryweather_hq',
    }
  }
}

Automatic Mode

• Set useManualList = false
• Picks random cards from Config.Cards
• Respects rarity filters
• New selection each rotation

Manual Mode

• Set useManualList = true
• Define specific cards in manualList
• Separate lists for normal and CVG
• Full control over requested cards

🎯 Next Steps

After configuring the Collector system:

Go to Core Configuration →← Back to Creating Content

Documentation