Merge pull request 'feature/add-win-limit' (#55) from feature/add-win-limit into develop

Reviewed-on: #55

docs/02-setup-main-game/05-main-scene/17-win-limit.md

@@ -0,0 +1,72 @@
+---
+sidebar_position: 17
+title: Win Limit
+description: Display limit win
+---
+
+# Win Limit
+
+### Overview
+
+#### Win Limit
+
+- The **Win Limit** popup appears during gameplay when the player's win points reach a predefined threshold.
+
+![Win Limit Popup](../img/05-main-scene/win-limit/overview.png)
+
+#### Gamble Win Limit
+
+- The **Gamble Win Limit** popup is triggered during the gamble feature when the player reaches the maximum number of allowed gamble attempts (typically 5).
+
+![Gamble Win Limit Popup](../img/05-main-scene/win-limit/overview-gamble.png)
+
+---
+
+### Prefab Location
+
+| Path                                                     | Prefab Name                  |
+|----------------------------------------------------------|------------------------------|
+| `assets/core-assets/hyper-core/packages/present/prefabs` | `present-win-limit-reached`  |
+
+### Scene Hierarchy
+
+Place the prefab in the following scene structure:
+
+```
+Canvas
+└── [main-view]
+    └── [game-view]
+        └── [present-win-limit-reached]
+```
+
+![Scene Structure](../img/05-main-scene/win-limit/win-limit-component.png)
+
+---
+
+### Asset Setup
+
+- Drag and drop the required image onto the node in the editor:
+
+![Asset Setup](../img/05-main-scene/win-limit/assets-win-limit.png)
+
+|      Drag Sprite        |     Node Name         |
+|-------------------------|-----------------------|
+| `you-won`               | `you-won`             |
+| `win-limit-reached`     | `win-limit-reached`   |
+| `gamble-limit-reached`  | `gamble-limit-reached`|
+| `btn-normal`            | `btn-continue`        |
+| `text-continue`         | `continue`            |
+
+
+### Font
+
+- Use a **custom font** to match the win label style for your game theme.
+
+![Font](../img/05-main-scene/win-limit/add-font.png)
+
+---
+
+:::tip
+- Follow the game design layout for assets and fonts.
+- Win limit configuration may vary by game.
+:::