⚙️ Room Boom Settings
Introduction
The Room Boom Settings page allows you to customize the gift images displayed in the app during Room Boom level progress. Each level shows a gift image that changes based on the fill percentage (progress) — as users get closer to completing the level goal, the gift image gradually fills up to reflect the progress percentage.
How Does the Fill Percentage System Work?
When gifts are sent inside the room, the progress percentage toward the level goal (target) is calculated. This percentage is visually reflected on the gift image in the app:
- At 0% — the gift image appears empty (level start)
- At 20% — the gift starts partially filling
- At 40% — the gift fills more
- At 60% — the gift is well filled
- At 80% — the gift is nearly full
- At 100% — the gift is completely full (level complete! 🎉)
Note
The gift image changes gradually in front of users in the app to motivate them to continue sending gifts until completing the level.
How to Access:
Side Menu ← 💣 Room Boom ← Room Boom Settings
🔗 Open Room Boom Settings Page
Settings Page
When opening the page, you'll find a list of percentage stages, each representing a certain fill percentage for the gift image. Each stage contains:
Elements of Each Percentage Stage:
| Element | Description |
|---|---|
| 🏷️ Percentage | Badge showing the fill percentage (e.g., 0%, 20%, 40%, 60%, 80%, 100%) — appears in the upper corner |
| 📷 Image | Image upload area — press "Choose File" to select the gift image for this percentage. Supported formats: SVGA, MP4, PNG, JPG, GIF, WEBP, MOV, AVI, MKV, WEBM |
| 👁️ View | Preview of the current gift image — shows how the gift looks at this fill percentage |
| 🏷️ Image Type | Dropdown to specify the uploaded image file type |
Available Image Types:
| Type | Description |
|---|---|
| svga | SVGA animation files — support animation and transparency, ideal for animated visual effects |
| alpha | Alpha channel files — support transparency for blending the image with the app background |
| mp4 | MP4 video files — for displaying animated video as the gift image |
| vap | VAP files — lightweight video format with transparency support |
| Image (png) | Static PNG images — simple images with transparency support |
Percentage Stages:
The settings consist of several stages, each representing a different fill level:
| Percentage | Description | Gift Appearance |
|---|---|---|
| 0% | Level start — gift completely empty | 🎁 Gray gift with no fill |
| 20% | Slight progress — beginning to fill | 🎁 Gift with slight partial fill (yellow) |
| 40% | Medium progress — gift filling up | 🎁 Gift filled up to about half |
| 60% | Good progress — more than half | 🎁 Gift filled above half |
| 80% | Major progress — nearly complete | 🎁 Gift nearly full |
| 100% | Level complete! | 🎁 Gift completely full ✨ |
Understanding the Visual Gradient
Gift images progress from empty (0%) to completely full (100%). In the app, users see the gift gradually filling with each gift sent in the room, creating a visual incentive to continue until completing the level.
How to Set Up Stage Images:
Setup Steps:
- Go to Room Boom Settings from the side menu.
- For each percentage stage (0%, 20%, 40%, etc.):
- Press "Choose File" in the Image section to upload the gift image for this percentage.
- Select the appropriate Image Type from the dropdown (svga, alpha, mp4, vap, or Image png).
- Make sure the image appears in the View section for preview.
- After setting up all stages, press "Submit" or "Save" to apply the settings.
Important Tips:
Tips for Choosing Stage Images
- Gradient: Make sure gift images progress logically from empty to full.
- Consistency: Use the same design style for all stages for a consistent visual experience.
- SVGA for animation: Use SVGA files if you want animated effects on the gift image.
- PNG for simplicity: Use Image (png) if you want simple static images with transparency.
- Size: Keep file sizes small for better performance in the app.
Warning
- An image must be uploaded for each percentage stage to ensure a complete visual experience.
- If a stage is left without an image, a default or blank image may appear to users at that percentage.
- Supported upload formats: SVGA, MP4, PNG, JPG, GIF, WEBP, MOV, AVI, MKV, WEBM.
Quick Summary:
| Action | Steps |
|---|---|
| Open settings | Menu ← Room Boom ← Room Boom Settings |
| Upload image for stage | Press "Choose File" next to desired percentage ← Select image |
| Set image type | Select from dropdown (svga, alpha, mp4, vap, Image png) |
| Preview image | View image in "View" section next to each stage |
| Save settings | Press "Submit" or "Save" after setting up all stages |