171 lines
5.3 KiB
Markdown
171 lines
5.3 KiB
Markdown
---
|
|
sidebar_position: 6
|
|
---
|
|
|
|
# Special Win Setup
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
Special Wins are high-value reward events in slot games, cagegorized based on the payout threshold:
|
|
|
|
| Win Type | Trigger Threshold | Preview |
|
|
|-----------|-----------------------|----------------|
|
|
| **Big Win** | Medium payout |  |
|
|
| **Super Win** | High payout |  |
|
|
| **Mega Win** | Maximum payout |  |
|
|
|
|
Each type delivers increasing visual excitement to highlight significant player rewards.
|
|
|
|
---
|
|
|
|
## Implementation
|
|
|
|
### Core Components
|
|
|
|
The special win system consists of three main components:
|
|
|
|
| Component | Purpose |
|
|
|-----------|---------|
|
|
| `hyper-special-win-initializer` | Handles system initialization and setup |
|
|
| `hyper-present-special-win` | Manages animation sequences and display logic |
|
|
| `hyper-special-win-label-point-effect` | Controls win amount visualization |
|
|
|
|
|
|
|
|
#### Coin Effect System
|
|
|
|
The coin shower effect uses prefab variants for different markets:
|
|
|
|
|
|
|
|
| Submodule | Theme | Preview |
|
|
|-------------|---------------|---------------|
|
|
| `hyper-coin-shower-international` | International |  |
|
|
| `hyper-coin-shower-chinese` | Chinese |  |
|
|
|
|
:::tip
|
|
- Position the Special Win node as per game design
|
|
:::
|
|
|
|
---
|
|
|
|
### Asset Configuration
|
|
|
|
#### 1. Static Resources
|
|
|
|
Store static assets in platform-specific directories:
|
|
|
|
| Platform | Path | Preview |
|
|
|----------|------|---------|
|
|
| Desktop | `assets/textures/desktop/preloads/special-wins` |  |
|
|
| Mobile | `assets/textures/mobile/preloads/special-wins` |  |
|
|
|
|
🔗 [View Platform Asset Structure](http://localhost:3000/docs/cagegory/game-asset-structure)
|
|
|
|
---
|
|
|
|
#### 2. Animation Setup
|
|
|
|
##### Special Win Animation Flow
|
|
|
|
```mermaid
|
|
%%{init: {'theme': 'base', 'themeVariables': { 'fontSize': '25px', 'fontFamily': 'arial' }}}%%
|
|
graph TD
|
|
%% Win Types with Thresholds
|
|
SW[Special Wins] --> BW["Big Win"]
|
|
SW --> SPW["Super Win"]
|
|
SW --> MW["Mega Win"]
|
|
|
|
%% Big Win stages with flow
|
|
BW --> BWI[bigwin-in]
|
|
BWI --> BWL[bigwin-loop]
|
|
BWL --> BWO[bigwin-out]
|
|
|
|
%% Super Win stages with flow
|
|
SPW --> SPWI[superwin-in]
|
|
SPWI --> SPWL[superwin-loop]
|
|
SPWL --> SPWO[superwin-out]
|
|
|
|
%% Mega Win stages with flow
|
|
MW --> MWI[megawin-in]
|
|
MWI --> MWL[megawin-loop]
|
|
MWL --> MWO[megawin-out]
|
|
|
|
%% Legend nodes
|
|
L0["Feature Name"]-->L1["Win Types"] --> L2["In State"] --> L3["Loop State"] --> L4["Out State"]
|
|
class L0 specialWin
|
|
class L1 winType
|
|
class L2 inStage
|
|
class L3 loopStage
|
|
class L4 outStage
|
|
|
|
%% Style definitions
|
|
classDef inStage fill:#e6f3ff,stroke:#666,font-size:25px
|
|
classDef loopStage fill:#fff2cc,stroke:#666,font-size:25px
|
|
classDef outStage fill:#f8cecc,stroke:#666,font-size:25px
|
|
classDef winType fill:#d5e8d4,stroke:#82b366,font-size:25px
|
|
classDef specialWin fill:#fff4dd,stroke:#ff0000,font-size:25px
|
|
|
|
class BWI,SPWI,MWI inStage
|
|
class BWL,SPWL,MWL loopStage
|
|
class BWO,SPWO,MWO outStage
|
|
class BW,SPW,MW winType
|
|
class SW specialWin
|
|
|
|
%% Adjust node spacing
|
|
linkStyle default stroke-width:4px,stroke:#ff0000
|
|
```
|
|
|
|
|
|
##### Step 1: Add Animation Resources
|
|
|
|
Place animated assets in the following directories:
|
|
|
|
| Platform | Path | Preview |
|
|
|----------|------|---------|
|
|
| Desktop | `assets/textures/desktop/postloads/anim-special-win` |  |
|
|
| Mobile | `assets/textures/mobile/postloads/anim-special-win` |  |
|
|
|
|
##### Step 2: Configure Animation Settings
|
|
|
|
| Setting | Example |
|
|
|------------------|---------|
|
|
| Static Fallback |  |
|
|
| Loop Animation |  |
|
|
|
|
🔗 [View Animation Provider Setup](http://localhost:3000/docs/setup-main-game/main-scene/system#animation-provider-setup)
|
|
|
|
:::tip
|
|
- Move assets to `custom-scale/` directory to resolve image quality issues
|
|
- Asset paths may vary by project configuration
|
|
:::
|
|
|
|
##### Step 3: Font Configuration
|
|
|
|
- **Path:** `assets\game-assets\fonts\preloads\main-game\fnt-special-win`
|
|
- Follow these steps to configure fonts for special win displays:
|
|
|
|
1. **Package Font Assets**
|
|
- Import font files into project
|
|
|
|
|
|
|
|
2. **Font Integration**
|
|
- Add font asset to special win component
|
|
|
|
|
|
|
|
3. **Layout Settings**
|
|
|
|
- Configure text alignment
|
|
- Adjust font size and spacing
|
|
|
|
|
|
|
|
|
|
:::tip
|
|
Customize font styles based on each game's design.
|
|
:::
|