⚙️ Lucky Gift Settings
How to Access:
Gifts ← Lucky Gift Settings
The Lucky Gift Settings page contains two main tabs:
Tab 1: Lucky Gift Settings
Choosing Lucky Gift Version:
Two different versions of the lucky gift system are available. You can choose the version suitable for your app:
Version 1 (Standard)
The standard version of lucky gifts where profit percentages are distributed between the app, owner, and host.
| Field | Description | Example |
|---|---|---|
| App Percentage | App owner's earnings (percentage of gift value) | 50 |
| Owner Percentage | Percentage the owner receives | 10 |
| Host Percentage | Percentage the host (user) receives upon winning | 40 |
After setting the percentages, click "Save Version 1 Settings".
Note
The sum of all three percentages (App + Owner + Host) must = 100%.
🎰 How Does the Lucky Game Work in Standard Version?
When a user sends (throws) a lucky gift in Version 1, the process works as follows:
1. Sending the Gift
- The user selects a lucky gift and clicks "Throw / Gift".
- The full gift price is deducted from the user's (sender's) balance.
2. Gift Value Distribution
- The gift value is split according to the percentages set in settings:
- App Percentage: Goes directly to the app owner (e.g., 50% of gift value).
- Owner Percentage: Goes to the room owner (e.g., 10% of gift value).
3. Determining Win or Loss
- The wheel spins randomly to determine the result:
- If the user wins 🎉: The receiver (host) gets the Host Percentage of the gift value as a prize (e.g., 40%). This is multiplied by a random multiplier from the profit ranges set in gift settings (lowest, medium, highest percentage).
- If the user loses ❌: The receiver doesn't get the host percentage, and it stays with the app.
Version 2 (FairLuck)
An advanced version of lucky gifts that relies on only 3 settings for full control over the lucky gift system.
🎯 Overview — The Lucky Gift Journey
When a user sends a lucky gift, the amount is deducted from their balance, then the system automatically determines whether they win or lose. You control only 3 settings that define how funds are distributed and how fair the system is (multiplier from 5x to 1000x).
Lucky Gift (1,000 Coins)
↓
① App Fee deducted 1.5% = 15 Coins → App Wallet
↓
Net Amount = 985 Coins
↓
③ Win or Lose? (based on RTP 99%)
↓
Win ← Amount × Multiplier = Payout
↓
② Distribution: Receiver 10% | Sender 90%
Lose ← 985 Coins stay in vault
① Setting 1: App Profit
| Detail | Value |
|---|---|
| Key | fair_luck_app_fee_rate |
| Range | 0% — 50% |
| Recommended | 1.5% |
This percentage is the app's direct profit from every lucky gift operation. It is deducted immediately from the bet amount before any other calculations, and added to the App Wallet.
Example: If a user sends a gift worth 1,000 coins with app profit at 1.5%, the app gets 15 coins immediately, and the remaining 985 coins enter the win/loss calculation.
Gift Amount: 1,000 Coins
↓
App Wallet ← 15 Coins (1.5%)
↓
Game Pool ← 985 Coins
Tip
A rate of 1.5% is low enough to keep players excited, while generating steady income for the app from every operation. Increasing it means more profit for the app but less earnings for players.
② Setting 2: Receiver Share
| Detail | Value |
|---|---|
| Key | fair_luck_receiver_fee_rate |
| Range | 0% — 50% |
| Recommended | 10% |
This setting determines how profits are split between the sender and receiver when the sender wins. The percentage defines what the person who received the gift gets from the total winnings. The receiver is the person or room the gift was sent to. Distribution only happens on a win.
Example: If the sender wins with a 10x multiplier on a net amount of 985 coins, the total payout = 9,850 coins. The receiver gets 985 coins (10%) and the sender gets the remaining 8,865 coins.
Win 10x
Total: 9,850 Coins
↓
Receiver (10%) ← 985 Coins
Sender (90%) ← 8,865 Coins
Tip
A rate of 10% encourages users to receive gifts and keeps them in rooms. Increasing it attracts more receivers but reduces sender profits.
③ Setting 3: Target RTP (Return To Player)
| Detail | Value |
|---|---|
| Key | V7_target_rtp |
| Range | 70% — 100% |
| Recommended | 99% |
RTP = Return To Player — the most important setting in the system. It determines the percentage of player funds that are returned to them over the long term.
If the rate is 99%, it means that for every 100 coins players bet in total, 99 coins are returned to them as winnings (over the long term).
How does the system work? The system monitors each player and automatically adjusts their win probability to maintain this rate:
| Player Status | System Response |
|---|---|
| Player losing too much | ← System increases their win chance |
| Player winning too much | ← System decreases their win chance |
| Player balanced | ← No change |
Player bets 100 Coins
↓
System tracks total spent vs received
↓
Compare actual RTP vs Target (99%)
↓
Losing too much ← Increase win chance
Winning too much ← Decrease win chance
Balanced ← No change
Tip
A rate of 99% means the system is nearly fair — the player only loses 1% over the long term (plus app fees). Reducing it to 95% for example increases system vault profits but makes players feel losses faster.
📊 The Full Picture — All Three Settings Together
This diagram shows how all three settings work together in every lucky gift operation:
Sender pays 1,000 Coins
↓
Setting ①: App Fee 1.5% → App gets 15 Coins
↓
Net: 985 Coins enter game
↓
Setting ③: RTP 99% → System decides: Win 10x
↓
Payout: 985 × 10 = 9,850 Coins
↓
Setting ②: Receiver 10% → gets 985 Coins
Sender 90% → gets 8,865 Coins
📋 Examples of Different Outcomes (Gift worth 1,000 Coins)
| Result | App Profit ① | Receiver Share ② | Sender Gets | Sender Net Profit/Loss |
|---|---|---|---|---|
| Loss | 15 | 0 | 0 | -1,000 |
| Win 5x | 15 | 493 | 4,432 | +3,432 |
| Win 10x | 15 | 985 | 8,865 | +7,865 |
| Win 50x | 15 | 4,925 | 44,325 | +43,325 |
| Win 100x | 15 | 9,850 | 88,650 | +87,650 |
| Jackpot 1000x | 15 | 98,500 | 886,500 | +885,500 |
📝 Quick Summary
| Setting | Recommended Value | Effect of Increasing | Effect of Decreasing |
|---|---|---|---|
| ① App Profit | 1.5% | More profit for app | More satisfaction for players |
| ② Receiver Share | 10% | Encourages receiving | More profit for sender |
| ③ RTP | 99% | More fairness | More profit for vault |
Conclusion
With the recommended values (1.5% + 10% + 99%), the app earns steady profit from fees, receivers get a share that encourages them, and players feel the system is fair because they recover 99% of their funds over the long term.
Tab 2: Lucky Gift Coins
This tab controls the sound effects for lucky gifts inside rooms.
| Field | Description | Example |
|---|---|---|
| Lucky Gift Coins | Play coin sound inside the room when the winning amount is greater than or equal to the added value | 2000 |
After setting the value, click "Save".
Tip
- Choose the version suitable for your business model. Version 1 (Standard) is simpler and easier to set up, while Version 2 (FairLuck) provides more advanced control.
- The Lucky Gift Coins value determines the minimum winning amount that triggers the sound effect, making big wins more exciting for users.