# Introduction

In this guide, you’ll learn…

- What are Collection Sets?

- Configuring Collection Sets

 

* * *

# What are Collection Sets

Collection Sets provide players with a new in-game mechanism, which allows them to collect cards and receive rewards with progression (by collecting specific cards or by finishing the whole set). Collections have the potential to increase player retention by providing them with clear goals and rewarding progression. It might also have a positive impact on increasing interactions with the game's content.

# Configuring Collection Sets

Configuring Collection sets involves the following steps:

1. Specifying the Main Configuration Details

2. Selecting or Configuring Gacha Chests

3. Configuring Card(s)

4. Specifying the Final Reward

## Specifying the Main Configuration Details

Specifying the main configuration detail involves setting the name of the collection sets and defining their availability.

1. In your game, navigate to **Events \> Collection Sets**.
On this page, you’ll be able to see the existing collection sets, in which event configuration they will be used, and their availability.

2. To create a new collection set, click **[+Add Collection Set]** on the upper right side of the screen.

3. Give your collection set a name and select the availability of the collection set (Test/Live).

4. Select or deselect the toggle to enable or disable the usage of custom weights for the cards.
Selecting this toggle will display the **Custom Weigh** t field in the **Cards** section.



Custom weight allows users to define custom weight for each card regardless of their rarity configuration in drop probability. If custom weight is selected, each card has to have custom weight configured separately.

## Configuring Card(s)

The next step in configuring a **Collection Set** is to configure the cards panel.

1. **Position:** This field is pre-populated and it determines the order or ranking of the card among other cards.
The order can be changed with the arrows next to each card.

2. In the **Asset Key** field, specify a reference key for the card’s associated asset.

3. Specify the card rarity in the **Rarity** field. Rarity influences the card's availability in the system.

4. In the **Custom weight** field, enter an integer value to denote the weight of the card.
This field appears only if the configuration settings have custom weight set to true. A higher weight means the card has a higher chance to drop.

5. Select the conversion rate for a duplicated card, in the **Duplicate Conversion** dropdown.
In Duplicate conversion, you can configure, what game item players should receive if they have a duplicate card

6. In the blank field next to the **Duplicate Conversion** dropdown, specify an integer for the number of conversion items.

7. Click [**+ Add**] to add as many duplicate conversion items as required.

8. Next, click the second [**+ Add**] button to assign rewards obtained with the card. Rewards are optional here.

9. Select the reward for the card, in the **Rewards** dropdown.

10. In the blank field next to the **Rewards** dropdown, specify an integer for the number of rewards items.
You can also configure the Backup Rewards from the **Game Items** setting in **Hawk**.

11. Click [**+ Add**] to add as many rewards for the card as required.
Rewards are optional; you can save the configured card(s) without adding rewards.

12. Click [**+ Add Card**] to add as many cards as required.

##
Selecting or Configuring the Gacha Chests

Gacha chests are a type of in-game item that contains collection cards.
When a player opens a gacha chest, they receive one or more collection cards from a predefined pool, but they don't know what they'll get in advance.

Gacha Sets can be added to the Collection chest in either of the following ways:

1. Selecting an existing Gacha Chest

2. Configuring a new Gacha Chest

### Selecting an Existing Gacha Chest

To select an existing Gacha chest, perform the following steps:

1. In the Tier 1 dropdown, select the relevant option from the dropdown.

2. Repeat the same step for the rest of the tiers.

### Configuring a New Gacha Chest

Configuring a new Gacha chest involves assigning an existing drop probability to the Gacha chest or adding a new drop probability and then assigning it to the Gacha chest being configured.

1. Navigate to **Events \> Gacha Chest**.
On this page, you’ll be able to see the existing Gacha chests, in which collection set they will be used, and their tiers.

2. To create a new collection set, click **[+Add Gacha Chest]** on the upper right side of the screen.

3. Specify a unique name for the new Gacha chest.

4. Select the relevant tier from the **Tier** dropdown.
Each Gacha chest can be assigned any tier relating to its rarity.
Only the Gacha chest associated with a particular tier is available while configuring the tiers in the collection set.

5. From the **Probability Drop** dropdown, select the relevant option.
Refer to the [Adding a New Drop Probability](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/edit-v2/3583279198?draftShareId=7cb40abf-f872-4c0f-9f75-b0e4b7260f8f#Adding-a-New-Drop-Probability) sub-topic below if you want to add a new drop probability instead of choosing an existing one.

6. Click [**+Add**] to specify the minimum rarity and possibility of retry.

7. From the **Min rarity** dropdown, select the relevant item rarity.
This setting ensures that only the items with the specified or higher rarity will be available in this particular Gacha pull.

8. Check or uncheck the **Retry on/off** checkbox.
This setting enables or disables the retry mechanism. If checked, the probability retry value determines the chance to have the reshuffle option.
If the **Retry on/off** checkbox is checked, the option to specify the probability of retry is available. The retry can occur up to 3 times.

**Re-Try Flow Example**
Server rolled the cards. One of them Player already has, and this card has re-try marked on with chance 50%

- Server rolls the re-try (there is 50% that rolling a new card will happen, 50% that not). Player was lucky and got a re-try

- Server re-tries the roll. The new card also exists in Players inventory

- Server rolls the re-try (there is 50% that rolling a new card will happen, 50% that not). Player was lucky and got a re-try

- Server re-tries the roll. The new card also exists in Players inventory

- Server rolls the re-try (there is 50% that rolling a new card will happen, 50% that not). Player was lucky and got a re-try

- Server re-tries the roll. The new card also exists in Players inventory

- Player receives the card with no more re-tries, as max number of re-try attempts was reached

1. Specify the probability of retry if it is available.

2. Click [**+Add**] to add more items and configure their minimum rarities and possibilities of retry.

3. Click the **[Save]** button to apply the changes.

4. If you need to discard your changes, click **[Cancel]**.

5. Next, perform the steps listed under the [Selecting an Existing Gacha](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/edit-v2/3583279198?draftShareId=7cb40abf-f872-4c0f-9f75-b0e4b7260f8f#Selecting-an-Existing-Gacha-Set)chest sub-topic above to add the new Gacha chest to the collection set.

## Adding a New Drop Probability

Drop probabilities define the chances of receiving a card of a specific rarity when a card is rolled.

To add a new drop probability, perform the following steps:

1. Navigate to **Events \> Drop Probabilities**.
On this page, you’ll be able to see the existing drop probabilities, in which configuration they will be used, and their availability.

2. To create a new drop probability, click **[+Add Drop Probability]** on the upper right side of the screen.

3. Specify a unique name for the drop probability.

4. In the **Item Rarity** fields from 1 through 5, specify the appropriate weight.
Higher Weight: Increases the likelihood of obtaining an item of that rarity.
Lower Weight: Decreases the likelihood, making the item rarer.

5. Click **[Save]** to save the drop probability.

The percentages displayed in the colour-coded bar are calculated based on the weights assigned to each rarity level.

The system uses these weights to determine the probability distribution for item drops. Here’s how the calculation typically works:

**Total Weight** :

First, the system sums up all the weights for all item rarities.
For Example: Total Weight= 40+25+15+12+10=102

**Individual Rarity Probability** :

The probability of getting an item of a particular rarity is calculated as:
Probability (Rarity X) = Weight of Rarity X
----------------- x 100
Total Weight

For Example: Rarity 1 = (40 / 102 ) x 100 = 39.22%

Setting up the Completion Reward

This section allows you to define the rewards that a player will receive upon completing a collection activity.

1. Select the primary reward game item, in the first dropdown.

2. In the blank field next to the first dropdown, specify an integer for the number of primary reward items.

3. Select an additional reward game item, in the second dropdown.

4. In the blank field next to the second dropdown, specify an integer for the number of additional reward items.

5. Click [**+ Add**] to add as many rewards as required for completing the collection activity.

6. Click the **[Save]** button to apply the changes.

7. If you need to discard your changes, click **[Cancel]**.

* * *

## **Selecting Collection Sets as an Activity**

- Users can select the activity type: **"Collections Sets"** while configuring an event.

- Once selected, an **Activity Configuration** dropdown allows choosing from the configured collection sets.

* * *