Documentation

Visual Effects & Styling

Complete guide to card visual effects, rarity colors, and styling options

Visual Effects System

Complete visual effects system with 11 unique effect types, configurable rarity colors, and toggle controls for performance optimization.

Effects Configuration

Global Effects Toggle

Enable or disable all visual effects system-wide for performance control.

Config.EffectsEnabled = true  -- Set false to disable all effects

High Rarity Effects

Control which rarities receive enhanced visual effects.

Config.HighRarity = {
  ['Normal'] = false,
  ['Uncommon'] = false,
  ['Rare'] = true,
  ['Epic'] = true,
  ['Legendary'] = true,
  ['Holo'] = true,
  ['OriginalArt'] = true,
}

Effect Types (11 Available)

Common Effects

  • • Common_Uncommon
  • • Holofoil_Rare
  • • Cosmos_Holofoil
  • • Radiant_Holofoil

Special Effects

  • • VMax
  • • VStar
  • • Trainer_Holo
  • • Rainbow_Rare

Premium Effects

  • • Secret_Rare
  • • Trainer_Gallery
  • • Shiny_Vault

Effect Assignment Example

Config.Cards = {
  ['card_legendary_dragon'] = {
    name = 'Legendary Dragon',
    rarity = 'Legendary',
    effectType = 'Rainbow_Rare',  -- Premium rainbow effect
    -- ... other properties
  },
  ['card_shiny_pokemon'] = {
    name = 'Shiny Pokemon',
    rarity = 'Holo',
    effectType = 'Shiny_Vault',    -- Special shiny effect
    -- ... other properties
  }
}

Rarity Color System

Each rarity has a unique color scheme for UI elements, borders, and visual indicators.

Standard Rarities

  • • Normal: #9ca3af (Gray)
  • • Uncommon: #22c55e (Green)
  • • Rare: #3b82f6 (Blue)
  • • Epic: #a855f7 (Purple)

Premium Rarities

  • • Legendary: #f59e0b (Gold)
  • • Holo: #06b6d4 (Cyan)
  • • OriginalArt: #232527ff (Black)

Color Configuration

Config.RarityColors = {
  ['Normal'] = '#9ca3af',
  ['Uncommon'] = '#22c55e',
  ['Rare'] = '#3b82f6',
  ['Epic'] = '#a855f7',
  ['Legendary'] = '#f59e0b',
  ['Holo'] = '#06b6d4',
  ['OriginalArt'] = '#232527ff'
}

Binder Visual Themes (18 Available)

Each binder can use one of 18 visual themes for unique collection presentation.

Dark Themes

  • • Dark
  • • Dark_Blue
  • • Midnight_Purple
  • • Steel_Grey
  • • Black
  • • Crimson_Black

Colorful Themes

  • • Vibrant
  • • Vibrant_Pink
  • • Neon_Cyan
  • • Sunset_Orange
  • • Forest_Green
  • • Ocean_Teal

Special Themes

  • • Light
  • • Gold_Black
  • • Azure_Black
  • • Sandstone
  • • Glacier_Blue
  • • Plum_Rose
  • • Emerald_Stone

Theme Assignment Example

Config.Binders = {
  { 
    item = 'jg_warlords_book', 
    themebook = 'Dark_Blue',           -- Dark blue theme
    brand = 'jg_warlords' 
  },
  { 
    item = 'jg_shin_genesis_book', 
    themebook = 'Neon_Cyan',           -- Bright cyan theme
    brand = 'jg_shin_genesis' 
  },
  { 
    item = 'jg_void_ether_book', 
    themebook = 'Forest_Green',        -- Nature theme
    brand = 'jg_void_ether' 
  }
}

TC Machine (Vending Machine)

The TC Machine is an interactive vending machine prop that gives players an alternative way to buy packs and accessories without visiting the NPC shop.

Machine Features

  • • Custom prop: jim_g_trading_cards_vending_machine
  • • 12 predefined locations across the map
  • • Same inventory as the Buy Shop
  • • Toggle enabled/disabled per machine
  • • Bridge target or drawtext interaction

Configuration

Config.TCMachine = {
  enabled = true,
  prop = 'jim_g_trading_cards_vending_machine',
  locations = {
    vector4(25.74, -1347.28, 29.5, 271.22),
    vector4(-48.62, -1757.04, 29.42, 45.74),
    -- ... 12 total locations
  }
}

Show Player Button

The Show Player feature lets players share their cards with nearby players in real-time, enabling social card trading interactions.

How It Works

  • • Enabled via Config.ShowPlayerButton = true
  • • When viewing a card, a "Show Player" button appears
  • • Sends the card view to nearby players within range
  • • Recipient sees the full card with effects, condition, and metadata
  • • Each show degrades the card condition by Config.Condition.degradeAmount (if enabled)

Performance Optimization

Effects Control

  • • Toggle all effects with Config.EffectsEnabled
  • • Selective effects via Config.HighRarity
  • • Performance mode for low-end systems
  • • Individual card effect customization

Best Practices

  • • Use EffectsEnabled = false for performance
  • • Limit HighRarity to reduce visual load
  • • Test effects on target hardware
  • • Consider player preferences