General

The basic connection to the emulator, plus the small daily jobs every account has: alliance help, gifts and research donations, quests, mail, the tavern, lucky eggs and covert ops.

• Emulator address is the ADB port of your BlueStacks instance, normally 127.0.0.1:5555. The second instance usually has a different port.
• Alliance lucky eggs have the highest priority of anything the helper does: other work is put aside to claim one.
• Covert ops sends heroes from the "?" on the left, guards the chests and claims them. Its diamond refresh switches are off by default, each refresh has a cap, and there is a daily diamond budget.
• The tavern only uses free recruits unless you switch Free only off.

💰 These switches spend stamina, items, resources or diamonds

• Alliance research donations · Enabled (Default: On): A few resources (about 600 herb/grain/wood per donation)
• Alliance research donations · Max donations per run: A few resources (about 600 herb/grain/wood per donation)
• Tavern recruiting · Free recruits only (Default: On): Recruit tickets (only when this is switched off)
• Covert ops · Use scrolls to refresh quest quality (Default: On): Covert ops scrolls
• Covert ops · Use Super Refresh (all chests to UR; also needs diamond refresh on; default off): Diamonds (capped per refresh and counted in the daily budget)
• Covert ops · Use diamonds to refresh chest quality (only when out of scrolls; default off): Diamonds (capped per refresh and by the daily budget)
• Covert ops · Max diamonds per chest refresh (default 100): Diamonds (never more than this per refresh)
• Covert ops · Covert Ops daily diamond budget (shared by Super Refresh and diamond refresh, resets at server midnight; caravans not included): Diamonds (daily total)
• Covert ops · Scrolls to keep (for refreshing quest quality): Covert ops scrolls (above the number you keep)

Switches

Basic settings

Switch	Default	What it does
Emulator address device	127.0.0.1:5555	The adb address of BlueStacks, normally 127.0.0.1:5555. Change it only if your emulator uses a different port.
Keep last run times on start resume_schedule	On	Whether to keep each task's last run time after the helper restarts. On: tasks that are not yet due are skipped; off: every task runs once on each start.

Advanced settings (usually leave as they are)

Switch	Default	What it does
Screenshot method capture_method	Automatic (recommended)	How the helper takes screenshots. Leave it on Automatic: at start it tests the options and picks the fastest one that matches the adb screenshot pixel for pixel. Automatic (recommended) / Always adb / LDPlayer's own capture (LDPlayer only) / Direct adb with compressed transfer
OCR engine ocr_engine	Automatic (recommended)	The engine that reads numbers and text on screen. Automatic tries PaddleOCR first for single-line numbers (such as the heal %) and falls back to Windows OCR when unsure; normally leave it alone. Automatic (recommended) / Always Windows OCR / PaddleOCR (same as automatic)
adb location adb_path	(empty)	Location of the adb program. Empty = find it automatically (registry / PATH); fill it in only if the wrong one is picked, e.g. HD-Adb.exe inside the BlueStacks folder.
LDPlayer folder ld_dir	(empty)	LDPlayer install folder. Keep it empty if you only use BlueStacks; empty = find it automatically, fill it in only if the wrong one is picked.
Rest per round (s) round_pause	20, 40	The random rest after each round of tasks, given as two numbers: shortest, longest (seconds). Longer rests mean fewer actions.

Background watcher

Switch	Default	What it does
Idle on world map watcher.idle_on_world	On	Return to the world map after territory tasks so that returning squads can be sent out again at once. Normally leave it on.

Advanced settings (usually leave as they are)

Switch	Default	What it does
Watcher interval (s) watcher.interval	3 s	How often the watcher thread takes a screenshot to check for alliance help, rallies, idle squads and the Pirate Legacy. Smaller values react faster but load the emulator more.

Alliance help

Switch	Default	What it does
Enabled help.enabled	On	Automatically taps the golden fist next to the Alliance button on the main screen to help allies speed up builds and research. Needs an alliance; turn it off if you have none.

Alliance gifts

Switch	Default	What it does
Enabled guild_gift.enabled	On	Claims the gifts on the Daily and Advanced pages of Alliance Gifts, using Claim All when it is shown. Needs an alliance.
Interval (min) guild_gift.interval	120 min	How many minutes between visits to claim alliance gifts.

Alliance research donations

Switch	Default	What it does
💰 Enabled guild_research.enabled	On	Donates to the alliance technology the leader recommended (thumbs-up) in exchange for alliance coins. Only the normal-resource Donate button is used; the diamond donation is blocked. 💰 Spends: A few resources (about 600 herb/grain/wood per donation)
Interval (min) guild_research.interval	120 min	How many minutes between runs of alliance research donation.
💰 Max donations per run guild_research.max_donate	30	Maximum number of donations per run; it stops by itself when the count is used up. Larger values earn more alliance coins and use more resources. 💰 Spends: A few resources (about 600 herb/grain/wood per donation)

Loot

Switch	Default	What it does
Enabled loot.enabled	On	Claims the rewards in the loot gift box next to the squad list on the world map (from monster fights and rallies) with Claim All.
Interval (min) loot.interval	60 min	How many minutes between runs of loot claiming.

Quests

Switch	Default	What it does
Enabled quests.enabled	On	Claims the green Claim rewards of main-line and daily quests.
Interval (min) quests.interval	20 min	How many minutes between runs of quest claiming.

Advanced settings (usually leave as they are)

Switch	Default	What it does
Page layout (advanced) quests.layout	simple	Layout used to recognise the quest page (advanced). Keep the default simple.

Mail

Switch	Default	What it does
Enabled mail.enabled	On	Claims mail rewards: opens each category that has a red dot and taps Claim All; the Top Up and Favourites categories are not opened.
Interval (min) mail.interval	30 min	How many minutes between runs of mail claiming.

Advanced settings (usually leave as they are)

Switch	Default	What it does
Page layout (advanced) mail.layout	simple	Layout used to recognise the mail page (advanced). Keep the default simple.

Tavern recruiting

Switch	Default	What it does
Enabled tavern_recruit.enabled	On	Tavern recruiting: automatically recruits heroes and survivors. By default only free recruits are used, never tickets.
Max minutes per session tavern_recruit.minutes	60 min	Maximum minutes a tavern recruiting session may run before the helper moves on to other tasks.
Recruit heroes tavern_recruit.recruit_hero	On	Whether to recruit heroes.
Recruit survivors tavern_recruit.recruit_survivor	On	Whether to recruit survivors.
💰 Free recruits only tavern_recruit.free_only	On	On: only free recruits are made and no tickets are used. If turned off, recruit tickets are used once the free recruits run out. 💰 Spends: Recruit tickets (only when this is switched off)
Interval (min) tavern_recruit.interval	60 min	How many minutes between runs of tavern recruiting.

Halloween dig

Switch	Default	What it does
Enabled halloween_dig.enabled	On	Halloween pumpkin-cat dig: taps the pumpkin icon at the bottom right, then sends squads, stays on guard and claims the reward just like the Pirate Legacy. Only useful while the event is running.

Raven gratitude

Switch	Default	What it does
Enabled raven_gratitude.enabled	On	Raven's Gratitude event: taps Go in the event popup and then fights the raven-marked exploration stages. Only useful while the event is running.

Alliance lucky eggs

Switch	Default	What it does
Enabled lucky_egg.enabled	On	Taps the Lucky Egg that appears in alliance chat to collect its diamond reward. Needs an alliance.
Interval (min) lucky_egg.interval	10 min	How many minutes between runs of Lucky Egg checks.

Alliance check

Switch	Default	What it does
Enabled alliance_check.enabled	On	Periodically checks whether the account is in an alliance and switches alliance-only features on or off accordingly.
Interval (min) alliance_check.interval	60 min	How many minutes between runs of alliance membership checks.

Duel recall

Switch	Default	What it does
Enabled duel_recall.enabled	On	Monday duel: recalls gathering squads shortly before server midnight so the resources count towards the Monday duel score. The timing is set under Gather. Needs an alliance.
Interval (min) duel_recall.interval	1 min	How many minutes between runs of Monday duel recall checks.

Covert ops

Switch	Default	What it does
Enabled covert_ops.enabled	On	Covert Ops (question-mark entry in the left column): automatically dispatches heroes on missions and stands by the chests as they finish to tap and claim them. Refresh options below control scroll and diamond use (diamonds are off by default).
Interval (min) covert_ops.interval	5 min	How many minutes between Covert Ops checks (dispatching heroes, watching chests).
💰 Use scrolls to refresh quest quality covert_ops.refresh_quality	On	When no UR quest is on the page, scrolls are used to refresh the quest quality; nothing is refreshed while an undispatchable UR quest is shown. 💰 Spends: Covert ops scrolls
💰 Use Super Refresh (all chests to UR; also needs diamond refresh on; default off) covert_ops.super_refresh	Off	Uses Super Refresh to turn all chests into UR at once. It only works when diamond refresh is also on; off by default. 💰 Spends: Diamonds (capped per refresh and counted in the daily budget) Requires: Covert ops · Use diamonds to refresh chest quality (only when out of scrolls; default off)
💰 Use diamonds to refresh chest quality (only when out of scrolls; default off) covert_ops.diamond_refresh	Off	After scrolls run out, diamonds are used to refresh chest quality. Off by default; think before turning it on because it spends diamonds. 💰 Spends: Diamonds (capped per refresh and by the daily budget)
💰 Max diamonds per chest refresh (default 100) covert_ops.diamond_refresh_max_cost	100 diamonds	A single chest refresh is skipped if its diamond price is above this amount. Default 100. 💰 Spends: Diamonds (never more than this per refresh) Requires: Covert ops · Use diamonds to refresh chest quality (only when out of scrolls; default off)
💰 Covert Ops daily diamond budget (shared by Super Refresh and diamond refresh, resets at server midnight; caravans not included) covert_ops.daily_diamond_budget	2000 diamonds	Maximum diamonds Covert Ops may spend per day, shared by Super Refresh and normal diamond refresh; resets at server midnight and caravans are not counted. 💰 Spends: Diamonds (daily total) Requires: Covert ops · Use diamonds to refresh chest quality (only when out of scrolls; default off)
💰 Scrolls to keep (for refreshing quest quality) covert_ops.keep_tickets	0	Number of scrolls always kept back when refreshing quest quality. 0 = may use them all. 💰 Spends: Covert ops scrolls (above the number you keep) Requires: Covert ops · Use scrolls to refresh quest quality
Dispatch order (UR / SSR / SR) covert_ops.order	UR, SSR, SR	The order in which mission qualities are dispatched; by default UR first, then SSR, then SR.
Seconds between dispatches covert_ops.dispatch_gap_seconds	60 s	Minimum seconds between two dispatches.
Min seconds between chest finish times covert_ops.gap_seconds	60 s	A newly dispatched chest must finish at least this many seconds apart from existing chests, so each one can be claimed in turn.
Seconds before finish to stand by the chest covert_ops.pre_guard_seconds	10 s	How many seconds before a chest finishes the helper stands by it.
Start tapping the chest at this many seconds left covert_ops.tap_start_seconds	3 s	Start tapping the chest when this many seconds remain on its countdown.
Seconds ahead to interrupt other tasks and go to the chest covert_ops.travel_seconds	60 s	How many seconds before a chest finishes the helper interrupts other tasks and heads over (leave enough time to get there from another screen).