docs: Update the guide for other scripts

README.md

@@ -32,7 +32,7 @@ We implemented some of the following features.
     - Looping of Lotto to Gift Box for much easier management.
     - Long Press on Lotto for faster opening of boxes.
 - Find Appends on Support
-- NP Level Detection
+- NP Level Detection(Finally reliable thanks to PaddleOCR)
 - Auto Send of Friend Request after clearing a quest.
 - Auto on/off toggle of Teapots.
 - Stop script upon reaching certain bond level.
@@ -66,7 +66,7 @@ We implemented some of the following features.
 ### Improved Support Selection
 
 - Support Appends
-- NP Level Detection
+- NP Level Detection(a bit more reliable with PaddleOCR)
 - Support for Grand Servant system
 
 ![Improved Support Selection](https://github.com/user-attachments/assets/00ec91c8-6d8e-4670-b9e1-ba6e66674f58)
@@ -75,7 +75,7 @@ We implemented some of the following features.
 
 Current things being worked on
 
-1. [ ] Migration from hilt to kotlin-inject/metro
+1. [X] Migration from hilt to kotlin-inject/metro
 
 2. [ ] Migrate Battle Configs from prefs to FGA folder.
 

docs/other-scripts/friend-point-gacha.md

@@ -1,3 +1,113 @@
-# Auto Friend Point Gacha
+# Friend Point Gacha
 
-Currently work-in-progress.
+Automatically performs Friend Point (FP) summons in the Friend Point gacha screen.
+
+## Overview
+
+The Friend Point Gacha script continuously triggers 10x summons using Friend Points. It handles inventory management and can redirect to selling or CE enhancement when the inventory becomes full.
+
+## How to Start
+
+1. Navigate to the **Friend Point Summon** screen in the game
+2. The script will automatically detect the FP summon screen when you see:
+   - The "Friend Summon" banner on the initial summon screen
+   - The continue summon button after your first summon
+
+## Workflow
+
+```text
+┌─────────────────────────────────────────┐
+│         Start FP Gacha Script           │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────┐
+│   Check for Daily Free Summon Banner    │
+│   (First time only)                     │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────┐
+│      Perform Initial 10x Summon         │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+        ┌─────────────────────────┐
+        │    Main Summon Loop     │◄──────┐
+        └─────────────┬───────────┘       │
+                      │                   │
+                      ▼                   │
+        ┌─────────────────────────┐       │
+        │  Check Current State    │       │
+        └─────────────┬───────────┘       │
+                      │                   │
+         ┌────────────┼────────────┐      │
+         │            │            │      │
+         ▼            ▼            ▼      │
+    ┌─────────┐ ┌──────────┐ ┌─────────┐  │
+    │Inventory│ │  Summon  │ │ Out of  │  │
+    │  Full   │ │ Continue │ │   FP    │  │
+    └────┬────┘ └────┬─────┘ └────┬────┘  │
+         │           │            │       │
+         ▼           │            ▼       │
+    Handle Full      │       Exit Script  │
+    Inventory        │                    │
+         │           └────────────────────┘
+         ▼
+    ┌─────────────────────────────────────┐
+    │  Redirect to CE Bomb or Sell Menu   │
+    └─────────────────────────────────────┘
+```
+
+## Key Features
+
+### Summon Limit
+
+- **Optional FP limit**: Set a maximum number of summons to perform
+- Once the limit is reached, the script can either stop or redirect to the sell menu
+
+![FP Limit](<../assets/scripts/Friend Point Gacha.png>)
+
+### Inventory Full Handling
+
+When the inventory becomes full, the script can:
+
+1. **Redirect to CE Enhancement** - Create CE bombs with the summoned CEs
+2. **Redirect to Sell Menu** - Sell unwanted cards
+3. **Stop the script** - Exit with an inventory full notification
+
+![FP to CE EXP Bomb](<../assets/scripts/Friend Point Gacha To CE EXP Bomb.png>)
+
+### Connection Retry
+
+- Automatically handles connection issues
+- Retries when network errors occur
+
+## Settings
+
+| Setting | Description |
+|---------|-------------|
+| Limit FP | Enable/disable summon limit |
+| FP Limit Count | Maximum number of summons before stopping |
+| Redirect to Sell | Navigate to sell menu when limit reached or inventory full |
+| Create CE Bomb | Redirect to CE enhancement when inventory is full |
+
+## Exit Reasons
+
+The script will stop and notify you when any of these conditions occur:
+
+| Exit Reason | Description |
+|-------------|-------------|
+| **Inventory Full** | Your inventory is full and no redirect option is enabled |
+| **Run Out of Friend Points** | No more Friend Points available for summoning |
+| **Summon Limit Reached** | The configured summon limit has been reached |
+| **Reached Sell Banner** | Successfully navigated to the sell menu |
+| **Unable to Verify CE Enhancement Menu** | Failed to navigate to CE enhancement after inventory full |
+| **Sell Banner Not Visible** | Expected to see sell menu but could not detect it |
+
+## Tips for Best Results
+
+1. **Clear inventory space** before starting for longer runs
+2. **Enable redirect options** to maximize summoning efficiency
+3. **Set appropriate limits** if you want controlled summon sessions
+4. **Ensure stable connection** for uninterrupted summoning

docs/other-scripts/gift-box.md

@@ -1,3 +1,176 @@
-# Auto Gift Box
+# Auto Gift Box (Present Box)
 
-Currently work-in-progress.
+Automatically collects embers from the gift box (present box) with intelligent filtering.
+
+## Overview
+
+The Gift Box script automatically selects and collects gold embers from your present box. It uses OCR to read stack sizes and filter based on your preferences, ensuring you only collect what you need.
+
+## How to Start
+
+1. Navigate to the **Present Box** screen in the game
+2. The script will automatically detect the gift box screen when:
+   - Gold XP cards (embers) are visible in the list
+   - Silver XP cards are visible
+   - 5-star gold XP cards are visible
+3. Make sure the gift box has items to collect
+
+## Workflow
+
+```text
+┌─────────────────────────────────────────┐
+│         Start Gift Box Script           │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────┐
+│     Locate Ember Pattern Position       │
+│     (Gold, Silver, or 5-Star XP)        │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+        ┌─────────────────────────┐
+        │   Selection Iteration   │◄──────┐
+        └─────────────┬───────────┘       │
+                      │                   │
+                      ▼                   │
+        ┌─────────────────────────┐       │
+        │   Scan Visible Items    │       │
+        └─────────────┬───────────┘       │
+                      │                   │
+                      ▼                   │
+        ┌─────────────────────────┐       │
+        │  For Each Checkbox:     │       │
+        │  • Check if ember type  │       │
+        │  • Read stack count     │       │
+        │  • Apply size filter    │       │
+        │  • Select if valid      │       │
+        └─────────────┬───────────┘       │
+                      │                   │
+                      ▼                   │
+        ┌─────────────────────────┐       │
+        │    Scroll Down List     │       │
+        └─────────────┬───────────┘       │
+                      │                   │
+                      ▼                   │
+        ┌─────────────────────────┐       │
+        │   Check End of List     │       │
+        └─────────────┬───────────┘       │
+                      │                   │
+         ┌────────────┴────────────┐      │
+         │ End                     │ More │
+         ▼                         └──────┘
+┌─────────────────────────────────────────┐
+│        Receive Selected Items           │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────┐
+│   Check if Can Select More Items        │
+└─────────────────────┬───────────────────┘
+         │
+         ▼
+   Exit or Return to Lottery
+```
+
+## Key Features
+
+### Intelligent Ember Detection
+
+- Identifies gold 4-star embers
+- Identifies silver 3-star embers  
+- Identifies gold 5-star embers
+- Uses OCR to read stack sizes (e.g., "x50")
+
+### Stack Size Filtering
+
+- Only selects stacks within your configured maximum size
+- Prevents selecting large stacks you want to keep
+
+### Gold Ember Counting
+
+- Tracks total gold embers selected
+- Stops when reaching your configured limit
+
+### Server-Specific Adjustments
+
+- Adjusts detection regions based on game server
+- Supports JP, EN, KR, TW, and CN servers
+
+## Settings
+
+| Setting | Description |
+|---------|-------------|
+| Max Gold Ember Stack Size | Maximum stack size to select (larger stacks skipped) |
+| Max Gold Ember Total Count | Maximum total gold embers to collect |
+| Loop Into Lottery After Present Box | Return to lottery after collection (when called from lottery) |
+
+![Gift Box Dialog](<../assets/scripts/Gift Box.png>)
+
+## Exit Reasons
+
+The script will stop and notify you when any of these conditions occur:
+
+| Exit Reason | Description |
+|-------------|-------------|
+| **No Embers Found** | Could not locate any embers in the gift box |
+| **Cannot Select Any More** | Reached selection limit or no more valid items |
+| **Return to Lottery** | Successfully collected embers and returning to lottery script |
+
+## Selection Algorithm
+
+For each item in the gift box:
+
+```text
+┌─────────────────────────────────────────┐
+│     Is Item Checkbox Visible?           │
+└─────────────────────┬───────────────────┘
+                      │ Yes
+                      ▼
+┌─────────────────────────────────────────┐
+│   Check Icon Region for Ember Type      │
+│   • Gold 4★ XP?                         │
+│   • Silver 3★ XP?                       │
+│   • Gold 5★ XP?                         │
+└─────────────────────┬───────────────────┘
+                      │ Ember Found
+                      ▼
+┌─────────────────────────────────────────┐
+│   Read Stack Count Using OCR            │
+│   (Extract number from "x50" etc.)      │
+└─────────────────────┬───────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────┐
+│   Is Stack Size ≤ Max Stack Size?       │
+└─────────────────────┬───────────────────┘
+                      │ Yes
+                      ▼
+┌─────────────────────────────────────────┐
+│   Select Item and Add to Count          │
+└─────────────────────────────────────────┘
+```
+
+## Usage with Lottery
+
+When the lottery script detects a full present box, it can automatically invoke the Gift Box script:
+
+1. **Lottery detects present box full**
+2. **Navigates to gift box**
+3. **Gift Box script collects embers**
+4. **Returns to lottery** (if enabled)
+5. **Continues spinning**
+
+## Tips for Best Results
+
+1. **Set appropriate stack size limits** to skip large stacks you want to keep
+2. **Configure gold ember limits** to avoid excessive collection
+3. **Clear non-ember items manually** if they're blocking embers
+4. **Ensure embers are visible** at the start of the gift box list
+
+## Technical Notes
+
+- Maximum 99 items can be selected per batch
+- Uses 3 consecutive null checks to detect end of list
+- Scrolls through the list to find all valid items
+- Handles connection retries automatically