Skip to main content

Plugin — Fortune Cards (เกมเปิดไพ่)

Fortune Cards เป็นเกมเปิดไพ่ทำนายดวงสำหรับสตรีม — ผู้ชมโดเนทถึงเกณฑ์ → ระบบสุ่มเปิดไพ่ 1 ใบจาก deck พร้อม flip animation, flash effect และเสียง

ใช้ได้ทั้งแบบ "ทำนายโชค" และ "สั่งซื้อท่าทาง" (ตั้งชื่อไพ่เป็นกิจกรรม เช่น "ดื่มน้ำ", "เต้น", "ตอบคำถาม")

สิ่งที่ต้องเตรียม​

  • ภาพไพ่ (PNG / JPG / WebP) — อย่างน้อย 2–3 ใบขึ้นไป
  • ภาพ card cover (หลังไพ่) — บังคับมี 1 รูป
  • (ทางเลือก) เสียง reveal เวลาพลิกไพ่
  • ตัดสินใจเกณฑ์: trigger ที่ amount ≥ X หรือ = X เป๊ะ ๆ

ขั้นที่ 1 — เปิด Plugin​

  1. ไปที่ Plugins → แท็บ Fortune Cards
  2. เปิด toggle Enable

ขั้นที่ 2 — เลือก Trigger Mode​

ในส่วน Trigger เลือก 1 ใน 2 mode:

  • ≥ minimum amount — โดเนทเท่ากับหรือมากกว่า X บาท → trigger
  • = exact amount — โดเนท เท่ากับ X เป๊ะ ๆ → trigger (เช่นต้องโดเนท 99 พอดี)

แล้วกรอก amount ที่ต้องการ

ขั้นที่ 3 — อัปโหลด Card Deck + Cover​

Card deck​

  1. กด + Add Card / Upload Cards
  2. อัปโหลดภาพไพ่ทีละใบ (หรือหลายใบพร้อมกัน)
  3. ตั้งชื่อแต่ละใบ (เช่น "ดวงดี", "โชคลาภ") — ชื่อจะแสดงใต้ไพ่ตอนเปิด

Card cover (back image)​

  1. ในส่วน Card Cover — กด Upload
  2. เลือกภาพหลังไพ่ — ใช้ตอนยังไม่ flip

:::warning ต้องมี cover Card cover เป็น บังคับ — ไม่ตั้งจะ trigger ไม่ได้ :::

ขั้นที่ 4 — (ทางเลือก) อัปโหลด Reveal Sound​

อัปโหลดเสียงสั้น ๆ ที่จะเล่นตอนพลิกไพ่:

  1. ส่วน Reveal Sound — กด Upload
  2. ตั้ง Volume (0–100%)

ถ้าไม่ตั้ง — flip จะเงียบ (มีแค่ animation)

ขั้นที่ 5 — ตั้งค่า Display + Style​

ปรับ:

  • Display Duration — ไพ่โชว์อยู่กี่วินาทีหลัง flip
  • Flip Duration — animation flip ใช้เวลากี่วินาที
  • Card Width — ขนาดไพ่ (px)
  • Show Name (toggle) — แสดงชื่อไพ่ใต้ภาพ
  • Show Donor (toggle) — แสดงชื่อคนโดเนทด้านบน
  • Donor name color / size
  • Card name color / size
  • Font family

Flash Effect​

  • Enable Flash (toggle) — แสงวับช่วงพลิกไพ่
  • Color — สี flash
  • Intensity — ความเข้ม

ขั้นที่ 6 — Copy Widget URL → OBS​

  1. หาส่วน Card Widget URL
  2. กด Copy — URL: http://localhost:3001/cards
  3. OBS → + Sources → Browser → วาง URL
  4. ตั้ง Width / Height ให้พอครอบไพ่ + ชื่อ
  5. ลากตำแหน่งใน scene

ขั้นที่ 7 — ทดสอบ​

ใน Plugin tab มีปุ่ม Preview / Test Draw — กดเพื่อจำลองการเปิดไพ่ใน widget โดยไม่ต้องโดเนทจริง หรือใช้ Test Panel ส่ง donation amount ที่เข้าเกณฑ์

Tips & Troubleshooting​

  • ไพ่ไม่เปิดเลยตอนโดเนท: ตรวจ Enable + Trigger amount + ภาพ cover ตั้งแล้ว + มี card ≥ 1 ใบ
  • ภาพไพ่เบลอใน OBS: อัปโหลดภาพ resolution สูงขึ้น (แนะนำ ≥ 600px กว้าง)
  • Flip animation ไม่ smooth: ลด Flip Duration หรือลดขนาด Card Width
  • อยากให้ไพ่ "หายาก": อัปโหลดเยอะ ๆ (10+ ใบ) — ระบบสุ่มเสมอภาคตอนนี้ ไม่มี weight แบบ wheel

:::tip ใช้เป็นเกมแทนทำนาย ตั้งชื่อไพ่เป็น "ท่าทาง" / "challenge" ที่ต้องทำเมื่อเปิดได้ — เช่น "วาดรูป 30 วินาที", "ร้องเพลง 1 ท่อน" :::

ดูเพิ่มเติม​