Panduan untuk Custom HTML Overlay

Panduan Custom HTML Overlay TipBox

Fitur Custom HTML memungkinkan Anda mengatur tampilan teks pada kartu overlay sesuai gaya Anda. Bagian lainnya, seperti video, GIF, suara, dan bilah progres, tetap dikelola TipBox agar tampilan stream selalu berjalan lancar.

Apa yang bisa dan tidak bisa Anda ubah

BagianBisa diubah?
Video YouTube, TikTok, GIF, dan audio❌ Tidak
Tampilan "Memuat media" dan bilah progres❌ Tidak
Kartu moderasi (konten diblokir)❌ Tidak
Info lagu (thumbnail dan judul) pada alert❌ Tidak
Player lagu Music Box❌ Tidak
Posisi, lebar, warna, font, dan animasi masuk✅ Ya, lewat dashboard
Teks kartu: nama donatur, nominal, pesan, judul target, daftar peringkat, antrean lagu, nama sound✅ Ya

Cara menggunakan (langkah demi langkah)

Kamu tidak perlu bisa coding. Cukup salin, tempel, simpan.

  1. Buka Dashboard → Overlay, lalu pilih jenis overlay (mis. Alert + Mediashare).
  2. Cari panel Custom HTML Kartu, lalu klik untuk membukanya.
  3. Salin salah satu contoh siap pakai di bawah (mulai dari <div sampai </style>).
  4. Tempel ke kolomnya, ganti tulisannya sesukamu — yang di dalam {{...}} jangan diubah, itu datanya.
  5. Klik Simpan. Hasilnya langsung terlihat di pratinjau di sampingnya.
  6. Link di OBS tidak perlu diganti — tampilannya ikut berubah sendiri.
  7. Kalau mau balik seperti semula, hapus semua isi kolomnya lalu klik Simpan.

Pratinjau di dashboard sama persis dengan yang tampil di stream.

Soal bingkai kartu: setelah Custom HTML diisi, semua kotak pada kartu tampil polos (tanpa garis tepi dan bayangan) agar desain Anda tidak terbingkai ganda. Untuk menampilkan kembali bingkai bawaan tema, centang Bungkus slot & media pakai border & bayangan tema.

Bagian yang dapat Anda atur per jenis overlay

OverlayBagian yang bisa dikustomisasi
Alert + Mediashare✅ Kotak info donasi: nama donatur, nominal, pesan
Soundboard✅ Nama sound dan pengirim
Music Box✅ Lagu yang lagi diputar, lagu berikutnya, pemesan, dan jumlah antrean
Target Donasi✅ Judul target, persentase, dan jumlah dana terkumpul
Peringkat Donatur✅ Judul papan dan daftar donatur

Pada overlay Alert, urutan tampilan mengikuti pengaturan Gaya Kartu:

  • Klasik: media di atas, kotak info Anda di bawah.
  • Pesan Besar: kotak info Anda naik ke atas media, dengan pesan donasi tampil lebih besar.

Data yang bisa ditampilkan

Tulis nama data di antara dua kurung kurawal, misalnya {{donor}}, dan TipBox akan menggantinya dengan isi sebenarnya. Data yang tidak relevan akan tampil kosong, sehingga satu template aman dipakai di overlay mana pun.

Informasi kreator

DataIsi
{{streamer_name}}Nama tampilan Anda
{{streamer_username}}Username halaman Anda

Donasi dan kartu yang sedang tampil

DataIsi
{{donor}}Nama pendonasi
{{amount}}Nominal donasi (contoh: Rp25.000)
{{message}}Pesan donasi
{{sound_name}}Nama sound yang diputar
{{moderation_reason}}Alasan konten diblokir (kosong jika lolos)

Target donasi

DataIsi
{{goal_title}}Judul target
{{goal_current}}Dana terkumpul
{{goal_target}}Nominal target
{{goal_percent}}Persentase pencapaian
{{goal_period}}Periode target

Peringkat donatur

DataIsi
{{top_donor}}Donatur peringkat 1
{{top_donor_amount}}Total donasi peringkat 1

Music Box

DataIsi
{{musicbox_title}}Judul lagu berikutnya
{{musicbox_channel}}Artis atau pembuat lagu berikutnya
{{musicbox_requester}}Pemesan lagu berikutnya
{{queue_count}}Jumlah lagu dalam antrean

Untuk daftar peringkat atau antrean lagu yang lengkap, dibutuhkan pengaturan lanjutan. Hubungi tim TipBox atau minta bantuan pengembang Anda.

Ubah kalimat bawaan (panel Teks Overlay)

Selain Custom HTML, tiap jenis overlay punya panel Teks Overlay buat ganti kalimat bawaannya tanpa tempel kode.

  1. Buka Dashboard → Overlay, pilih jenis overlay.
  2. Buka bagian Teks Overlay.
  3. Ganti kalimatnya, lalu klik Simpan.

Kamu bisa pakai kode {{...}} yang sama seperti di atas. Atau pakai cara singkat ini:

Cara singkatArtinya sama dengan
[donatur] / [donator]{{donor}}
[jumlah] / [nominal]{{amount}}
[pesan]{{message}}
[lagu] / [judul]{{musicbox_title}}
[n]angka (mis. jumlah top / sisa antrean)

Contoh: tulis [donatur] baru saja berdonasi [jumlah] — hasilnya sama seperti {{donor}} baru saja berdonasi {{amount}}.

Mengikuti tema overlay

Agar desain Anda selaras dengan tema di dashboard, gunakan pengaturan tema yang sudah tersedia dan hindari menulis warna atau font secara manual. Dengan begitu, tampilan otomatis menyesuaikan saat Anda mengganti tema.

PengaturanKegunaan
--ov-bgWarna latar kartu
--ov-textWarna teks utama
--ov-accentWarna aksen
--ov-font-familyJenis font tema
--ov-font-baseUkuran font dasar

Contoh siap pakai

Alert donasi

<div class="donasi">
  <div class="baris">
    <span class="nama">{{donor}}</span> berdonasi
    <span class="nominal">{{amount}}</span>
  </div>
  <div class="pesan">{{message}}</div>
</div>
<style>
  .donasi { padding: 16px 20px; text-align: center; background: var(--ov-bg); color: var(--ov-text); }
  .baris { font-size: calc(var(--ov-font-base) * 1); }
  .nama, .nominal { font-weight: 900; }
  .nominal { color: var(--ov-accent); }
  .pesan { margin-top: 6px; font-size: calc(var(--ov-font-base) * 0.9); opacity: .9; }
</style>

Target donasi

<div class="goal">
  <span>{{goal_title}}</span>
  <span>{{goal_percent}}%</span>
</div>
<style>
  .goal { display: flex; justify-content: space-between; gap: 16px; padding: 4px 2px 12px; font-size: calc(var(--ov-font-base) * 0.9); font-weight: 800; }
</style>

Music Box (lagu berikutnya + jumlah antrean)

<div class="lagu">
  <div class="judul">{{musicbox_title}}</div>
  <div class="info">{{musicbox_channel}} • diminta {{musicbox_requester}}</div>
  <div class="antrean">{{queue_count}} lagu dalam antrean</div>
</div>
<style>
  .lagu { padding: 16px 20px; text-align: center; background: var(--ov-bg); color: var(--ov-text); }
  .judul { font-size: calc(var(--ov-font-base) * 1.1); font-weight: 900; }
  .info { margin-top: 4px; font-size: calc(var(--ov-font-base) * 0.85); opacity: .8; }
  .antrean { margin-top: 8px; font-size: calc(var(--ov-font-base) * 0.8); opacity: .7; }
</style>

Soundboard (nama sound + pengirim)

<div class="sound">
  <div class="nama">{{sound_name}}</div>
  <div class="dari">diminta {{donor}}</div>
</div>
<style>
  .sound { padding: 16px 20px; text-align: center; background: var(--ov-bg); color: var(--ov-text); }
  .nama { font-size: calc(var(--ov-font-base) * 1.1); font-weight: 900; }
  .dari { margin-top: 4px; font-size: calc(var(--ov-font-base) * 0.85); opacity: .8; }
</style>

Hal yang perlu diketahui

  • Media dan bilah progres dikelola TipBox. Ini memastikan video, lagu request, dan sound selalu berjalan penuh hingga selesai.
  • Elemen kartu tidak dapat diklik. Kartu hanya untuk ditampilkan agar tidak mengganggu stream.
  • Tinggi kartu menyesuaikan isi, dengan batas maksimum 1200 px. Kelebihannya akan disembunyikan.
  • Kartu aman dan terisolasi. Template Anda tidak dapat mengakses data akun atau halaman TipBox.
  • Ingin tampilan yang jauh berbeda? Sesuaikan tema di dashboard terlebih dahulu, lalu biarkan Custom HTML Anda mengisi bagian dalam kartu.