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
| Bagian | Bisa 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.
- Buka Dashboard → Overlay, lalu pilih jenis overlay (mis. Alert + Mediashare).
- Cari panel Custom HTML Kartu, lalu klik untuk membukanya.
- Salin salah satu contoh siap pakai di bawah (mulai dari
<divsampai</style>). - Tempel ke kolomnya, ganti tulisannya sesukamu — yang di dalam
{{...}}jangan diubah, itu datanya. - Klik Simpan. Hasilnya langsung terlihat di pratinjau di sampingnya.
- Link di OBS tidak perlu diganti — tampilannya ikut berubah sendiri.
- 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
| Overlay | Bagian 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
| Data | Isi |
|---|---|
{{streamer_name}} | Nama tampilan Anda |
{{streamer_username}} | Username halaman Anda |
Donasi dan kartu yang sedang tampil
| Data | Isi |
|---|---|
{{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
| Data | Isi |
|---|---|
{{goal_title}} | Judul target |
{{goal_current}} | Dana terkumpul |
{{goal_target}} | Nominal target |
{{goal_percent}} | Persentase pencapaian |
{{goal_period}} | Periode target |
Peringkat donatur
| Data | Isi |
|---|---|
{{top_donor}} | Donatur peringkat 1 |
{{top_donor_amount}} | Total donasi peringkat 1 |
Music Box
| Data | Isi |
|---|---|
{{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.
- Buka Dashboard → Overlay, pilih jenis overlay.
- Buka bagian Teks Overlay.
- Ganti kalimatnya, lalu klik Simpan.
Kamu bisa pakai kode {{...}} yang sama seperti di atas. Atau pakai cara singkat ini:
| Cara singkat | Artinya 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.
| Pengaturan | Kegunaan |
|---|---|
--ov-bg | Warna latar kartu |
--ov-text | Warna teks utama |
--ov-accent | Warna aksen |
--ov-font-family | Jenis font tema |
--ov-font-base | Ukuran 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.