Epic7 Shopper - Secret Shop Auto Refresh

Refreshes Epic Seven's Secret Shop until the bookmarks you actually want show up. Image matching scales to any window size. Random delays, click offsets, and scroll variation so it does not look like a metronome.

Fork of sya1999's Epic Seven Secret Shop Refresh. Navigate to the Secret Shop first. ESC stops it.

---

Features

• Multi-Resolution Support - Works with any window size (auto-scales detection images)
• Image-Based Detection - Uses template matching instead of fixed coordinates
• Anti-Detection Measures - Random delays, click offsets, and scroll variations
• Multiple Item Support - Detects and purchases all desired items in a single view
• Safety Checks - Pauses if you navigate away from the shop
• Out of Skystone Check - Stops script if the user is out of skystones
• Live Shopping Display - Real-time overlay showing items purchased, refresh counter, and elapsed time
• Purchase History Summary - View aggregated statistics from all shopping sessions with per-item efficiency rates
• Debug Mode - Detailed output and screenshot saving for troubleshooting
• Robust Error Handling - Clear error messages for invalid input formats

Quick Start

Prerequisites

• Python 3.9+ (tested with 3.12)
• Epic Seven running in windowed mode
• Navigate to the Secret Shop before starting

Installation

1. Clone or download this repository
2. Install dependencies:

   pip install -r requirements.txt

Running

1. Open Epic Seven and navigate to the Secret Shop
2. Run the application:

   python .\\E7SecretShopRefresh.py

3. Select your game window from the dropdown (should be auto-detected)
4. Check the items you want to purchase (Covenant, Mystic, Friendship bookmarks)
5. (Optional) Set a Skystone budget
6. Click Start Refresh
7. Press ESC to stop at any time

Command Line Options

# Normal mode
python .\\E7SecretShopRefresh.py

# Debug mode (detailed output)
python .\\E7SecretShopRefresh.py --debug

# Debug mode with screenshot saving (for troubleshooting)
python .\\E7SecretShopRefresh.py --debug --screenshot

# Show window info and scaling details, then exit
python .\\E7SecretShopRefresh.py --info

# Use custom reference size for your own screenshots
python .\\E7SecretShopRefresh.py --size=1920x1080

# Combine options
python .\\E7SecretShopRefresh.py --debug --screenshot --size=1920x1080

Option Details

Option	Description
--debug	Enable debug mode with detailed logging output
--screenshot	Save debug screenshots of search areas (requires --debug)
--info	Display available windows and scaling information, then exit
--size=WIDTHxHEIGHT	Specify custom reference size for assets (e.g., --size=1920x1080)

Note:

• If an invalid format is provided to --size, the program will display a clear error message and exit.
• The --screenshot option works best with --debug enabled to see when and where screenshots are saved.

GUI Settings

Setting	Description
Window Title	Select your game window from the dropdown or type the exact window name
Covenant/Mystic/Friendship	Toggle which bookmark types to purchase
Skystone Budget	Maximum skystones to spend (leave empty for unlimited)
Auto Placement	Automatically position the game window
History Button (📊)	Click the button in the top-right corner to view aggregated purchase history statistics

Building an Executable

Using the spec file (recommended):

pip install pyinstaller
pyinstaller .\\E7SecretShopRefresh.spec

Or with a simple command:

pyinstaller -F --noconsole -i assets/icon.ico .\\E7SecretShopRefresh.py

The executable will be created in the dist folder.

Note: When distributing, you need to include the assets folder alongside the executable, or use the spec file which bundles assets automatically.

Important Notes

1. Administrator Mode: If using the PC client (not an emulator), run the program as Administrator
2. Monitor Must Stay On: The program takes screenshots to detect items - don't turn off your display
3. Test First: Manually refresh until a bookmark appears, then start the program to verify detection works
4. Stay in Shop: The program assumes you're already in the Secret Shop - it won't navigate there automatically

Troubleshooting

Items not being detected?

1. Run with --debug flag to see confidence scores
2. If confidence is low (<0.8), the images may need updating for your resolution
3. Use --info to check your window size and scaling information
4. Try providing custom screenshots with --size=WIDTHxHEIGHT
5. Use --screenshot (with --debug) to save debug images for analysis

Button clicks missing?

The anti-detection system adds random offsets to clicks. If buttons are consistently missed, check if your window has unusual borders or scaling.

Program clicking in wrong places?

Make sure you're in the Secret Shop before starting. The safety system will pause if it can't find the refresh button.

Invalid size format error?

When using --size, make sure to use the format WIDTHxHEIGHT (e.g., 1920x1080). Both values must be valid integers.

Custom Screenshots

If the included images don't work for your setup:

1. Take screenshots of the items/buttons at your resolution
2. Save them in the assets folder with the same names:
   • item_covenant.png, item_mystic.png, item_friendship.png (items)
   • button_buy.png, button_refresh.png, button_refresh_confirm.png, button_buy_confirm.png (buttons)
   • button_buy_sold.png (sold indicator)
3. Run with --size=WIDTHxHEIGHT matching your screenshot resolution

Purchase History

Purchase history is automatically saved to the ShopRefreshHistory folder as CSV files. Each session records:

• Timestamp
• Duration
• Refresh count
• Skystone spent (calculated as refresh_count × 3)
• Gold spent (total cost of all purchased items)
• Items purchased (count for each bookmark type: Covenant, Mystic, Friendship)

CSV files are named refreshAttempt[Cov][Mys][Frie].csv based on which items you're tracking. Files are created automatically when you start shopping.

History Summary

Click the 📊 History button in the top-right corner of the main window to view aggregated statistics across all your shopping sessions:

• Total Refreshes - Sum of all refreshes across all sessions
• Total Time - Combined duration of all shopping sessions
• Total Skystone/Gold Spent - Cumulative spending across all sessions
• Items Purchased - Per-item statistics showing:
  • Item count with icon
  • Efficiency percentage (items found per refresh, calculated only from refreshes that searched for that specific item)
  • Format: amount / percentage%

The efficiency percentage is calculated per-item, accounting for the fact that not all refreshes search for all items (e.g., if Friendship bookmarks aren't always tracked, their efficiency is only calculated from refreshes where they were being searched).

ToDo

• Out of Gold check - I .. have too much Gold to check that currently, sorry =D

License

See LICENSE file.

Happy refreshing! May your bookmarks be plentiful!