Skip to main content

Plugin — Fortune Cards (card-flip game)

Fortune Cards is a fortune-telling card-flip game for streams — when a viewer donates above your threshold, the system randomly flips one card from your deck with a flip animation, flash effect, and sound.

It works as both a "fortune-telling" game and a "command card" game (give cards activity names like "Drink water", "Dance", "Answer a question").

What you'll need​

  • Card images (PNG / JPG / WebP) — at least 2–3
  • A card cover image (the back of the cards) — required, exactly 1
  • (Optional) a reveal sound for the flip
  • A trigger threshold: amount â‰Ĩ X, or = X exactly

Step 1 — Enable the plugin​

  1. Go to Plugins → the Fortune Cards tab
  2. Flip the Enable toggle

Step 2 — Pick a Trigger Mode​

In the Trigger section, pick one of two modes:

  • â‰Ĩ minimum amount — donation â‰Ĩ X baht → trigger
  • = exact amount — donation equal to X exactly → trigger (e.g. only when someone donates exactly 99)

Then enter the amount.

Step 3 — Upload your Card Deck + Cover​

Card deck​

  1. Click + Add Card / Upload Cards
  2. Upload card images one at a time (or several at once)
  3. Name each one (e.g. "Good Luck", "Fortune") — the name shows below the card on flip

Card cover (back image)​

  1. In the Card Cover section — click Upload
  2. Pick the back-of-card image — shown before the flip

:::warning Cover required A Card Cover is required — without it the plugin won't trigger. :::

Step 4 — (Optional) upload a reveal sound​

A short clip that plays when a card flips:

  1. Reveal Sound section — click Upload
  2. Set Volume (0–100%)

Skip it for a silent flip (animation only).

Step 5 — Configure Display + Style​

Tweak:

  • Display Duration — how long the card stays visible after flipping (seconds)
  • Flip Duration — how long the flip animation takes (seconds)
  • Card Width — card size (px)
  • Show Name (toggle) — show the card name below the image
  • Show Donor (toggle) — show the donor's name above the card
  • Donor name color / size
  • Card name color / size
  • Font family

Flash Effect​

  • Enable Flash (toggle) — bright flash during the flip
  • Color — flash color
  • Intensity — how bright

Step 6 — Copy Widget URL → OBS​

  1. Find the Card Widget URL section
  2. Click Copy — URL: http://localhost:3001/cards
  3. OBS → + Sources → Browser → paste URL
  4. Set Width / Height large enough for the card + name
  5. Drag into position in the scene

Step 7 — Test​

The plugin tab has a Preview / Test Draw button — click it to simulate a card flip in the widget without a real donation. Or use the Test Panel and send a donation that meets the threshold.

Tips & Troubleshooting​

  • No card flips on donation: check Enable + Trigger amount + cover image is set + at least 1 card uploaded.
  • Card looks blurry in OBS: upload higher-res images (â‰Ĩ 600px wide recommended).
  • Flip animation feels janky: lower the Flip Duration or shrink Card Width.
  • Want certain cards to be rare: upload a lot of them (10+) — the system picks uniformly at random for now (no weighting like the wheel has).

:::tip Use it as a game instead of fortune-telling Name the cards after "challenges" or "actions" the streamer has to do — e.g. "Draw something for 30s", "Sing one verse". :::

See also​