🗺️Lootbox 2.0
Last updated
Last updated
The Lootbox is a game that offers daily rewards to players. The process is simple: players open the game daily, revealing and getting their reward. Prizes are customizable and can vary daily, including options like points, bonuses, mini-game attempts, tangible items, and more.
The lootbox comes with 2 different layouts - Cards and Map. With the map Lootbox layout, you can easily create a themed Advent Calendar for Christmas, Easter, or other occasions.
The lootbox skin should be uploaded in the “Mini-games’ skin editor” following the same approach that is used for mini-games. Here are the main steps:
Go to the Mini-games skin editor in the BO
Select the ‘Lootbox’ type from the creation wizard
Enter the name of the skin
Choose the layout - Cards or Map
Upload the package with the images
You can override the CSS if you want to introduce some UI changes
Save the skin
You can choose from existing skins or create a custom one. Browse the available skins for the Card layout here:
Here you can find the available skins for the Map layout:
For the map layout, the positions of the prizes are pre-defined for 7 and 25 days, so if you create a Lootbox with 7 or 25 prizes you don't have to adjust the positions of the prizes on the map. If you want to introduce more or less than the pre-defined prizes you need to adjust the positions of the prizes in the CSS editor in the skin or in the game template. The maximum amount of prizes that can be added is 31.
Please note that you must use '!important' when adjusting CSS on the game template and skin levels.
The Lootbox game must be assigned to a Custom Section first, so start by creating a Custom Section. Once the Custom Section is ready, you can proceed with creating the Lootbox game.
Each Custom Section can contain only one Lootbox game, but you can create multiple Custom Sections.
The prizes in the loot box can be won by the players only once in 24 hours.
If a player does not play the game in 24 hours, the prize for the day will be marked as missed and cannot be won.
After the Custom section is created you can proceed with the creation of the Lootbox itself. Start by selecting the schedule and the layout of Lootbox you want to create. Based on the schedule and duration set in the wizard, the game’s prizes will be generated automatically. You can then customize the game and the prizes by selecting prize types, adding images, updating descriptions, and more.
The Lootbox mini-game can be created in the BO under the Retention Games section.
Click the ‘Create’ button and set a schedule for your Lootbox. You can choose from two schedule types:
Weekdays (Monday to Sunday): Use this option for a recurring Lootbox on specific days of the week. The start time is always midnight, and you can select a time zone to align each day with your local midnight. For example, set up a Lootbox to run only on weekdays, Monday to Friday.
Calendar Days: Use this option for specific calendar dates. The start time is also midnight, with an adjustable time zone. For example, create a Christmas Advent Calendar running from December 1st to December 25th.
Select the layout of the Lootbox
Cards - in this layout, prizes are hidden behind cards arranged in a horizontal row. Players flip each card to reveal their rewards
Map - this layout is used for creating an Advent Calendar for a holiday-themed experience. The prizes are hidden in a gift box that pops up with a festive animation and reveals the reward.
After creating the game template, you can begin customizing the game:
Choose a Name
Select a Skin
Set Visibility: Define who can see the game
Configure Game UI: Set the game rules, add a promo image and text, and customize other display elements.
Select the Custom Section where the Lootbox game will be displayed
For the Horizontal layout of the Lootbox the ‘Promo text’ will be displayed under the title on the UI.
Customize the Prizes - The number of prizes will be automatically generated based on the selected schedule when the game is created.
Select the prize type
Enter Prize name
Add Prize image - ⚠️ It is recommended to use square images ⚠️
Select winning message
The Lootbox game should be assigned to a Custom Section.
Each prize is linked to a specific date or day in the BO, once the date/day is set it cannot be edited anymore.
Each prize is created by default with ‘Surchage’ enabled and ‘Stock items = 0’, this means that the prize pool will be infinite and the prize cannot run out of stock.
The images for the prizes should be square (example: 512x512).
Is the lootbox available in standalone mode?
Yes. You can use -> Example: _smartico.dp('dp:gf_section&id=205&standalone=true'); -> id=205 is the ID of the Custom section with the Lootbox.
