Documentation v1.4.1

Complete guide to WildGuns Deputy — the cowboy automation sheriff.

Installation

Step 1: Install Extension

1. Download or install WildGuns Deputy from the Chrome Web Store
2. Click the extension icon in Chrome's toolbar to verify it's installed

Step 2: Open the Game

1. Go to wildguns.gameforge.com
2. Log in to your account and enter any server
3. You should see a ★ star icon on the right side of the game page

Step 3: Open the Panel

Click the ★ star icon to open the Deputy panel. All features are accessible from this panel.

Activation

How to Activate

1. Open the Deputy panel (click the ★ star)
2. Expand the License section
3. Paste your license key into the text area
4. Click Activate
5. You should see "License activated! Yeehaw!"

Activation Issues

If you see "Activated" but features don't work:

1. Refresh the page — press F5 after activating
2. Check the Bot Master toggle — make sure it shows ACTIVE (not PAUSED)
3. Enable features individually — each feature has its own toggle
4. Check Activity Log — scroll down to see what the bot is doing or any errors

Troubleshooting

"License activated" but nothing happens

1. Check the Bot Master toggle at the top of the panel — must be ACTIVE
2. Each feature has its own toggle — enable the ones you want
3. For Auto Build: select buildings in the building list (check the boxes)
4. For Auto Train: add unit tasks (select unit → set count → click Add)
5. Check the Activity Log at the bottom for error messages

"Hardware mismatch"

Your license is bound to a different computer/browser. Each license works on one device. Contact support to reset your fingerprint if you changed devices.

"Session expired"

The game session timed out. Refresh the page or enable Auto-Login in the Status section.

"Not enough resources"

The bot tries to build/train but you don't have enough resources. It will retry on the next tick. You can lower the check interval for faster retries.

"No available traders"

All your market traders are busy on trips. The bot will skip this village and retry next tick when traders return.

Features stop after a while

• Check if your game session expired (look for lobby redirect)
• Check if Bot Master got paused
• Check Activity Log for any errors
• Refresh the page — features auto-resume if they were enabled

Bot Master Toggle

The golden bar at the top of the panel controls ALL features at once.

• ACTIVE (green) — all enabled features are running
• PAUSED (red) — everything stops. The panel dims to show the paused state.

Configuration While Paused

You can configure everything while the bot is paused — change settings, enable/disable feature toggles, set thresholds, add farm targets. When you turn the master switch back on, all enabled features start automatically.

Auto Build

All Plans

Automatically upgrades buildings in your village(s). Works across multiple villages simultaneously.

Setup

1. Open Auto Build section
2. Select a village from the Configure Village dropdown
3. Check the buildings you want to auto-upgrade
4. Set Max Lv. for each building (leave empty for no limit)
5. Choose a Build Mode:
   • Lowest Resource First — prioritizes resource fields with the lowest level
   • Balanced Resources — evens out resource types first
   • All Enabled (Lowest First) — upgrades any checked building, lowest first
6. Toggle Auto Build on

Instant Finish

Enable Instant Finish to automatically use the free finish button when builds have less than ~5 minutes remaining. Costs nothing.

Max Level

Set a target level for each building. Once reached, the bot skips it (shows green ✓). Leave empty for unlimited upgrades.

Smart Cost Caching

The bot caches building costs and only re-fetches when levels change. This minimizes server requests and speeds up decision-making.

Auto Train

All Plans

Automatically trains troops in your village(s). Supports all unit types per-village with priority ordering.

Setup

1. Open Auto-Train section
2. Select a village from the dropdown
3. Set Min Reserves — resources the bot won't touch (keeps this much untouched)
4. Under ADD UNIT, select a unit type, set count, click Add
5. Enable the task checkbox
6. Toggle Auto-Train Troops on

Continuous Mode

Check the ∞ checkbox on a task to train the maximum affordable every tick (ignores count). Great for constant troop production.

Priority Order

Tasks execute from top to bottom. Use the ▲ ▼ arrows to reorder. Higher priority units train first and get resources first.

Food Safety

When enabled, the bot skips training in a village if food production is negative (avoids starvation).

Defense Priority

If the Defense system detects an incoming attack, Auto-Train pauses its village switching to avoid blocking defensive actions.

Unit Types

Unit	Type	Building
Farmer	Infantry	Barracks
Soldier	Infantry	Barracks
Spy (Hunter)	Infantry	Barracks
Marksman	Infantry	Barracks
Cowboy	Cavalry	Stable
Cavalry	Cavalry	Stable
Bomber	Siege	Cannon Foundry
Artillery	Siege	Cannon Foundry

Resource Manager

All Plans

Automatically transfers resources between your villages via the Market. Three modes available.

Threshold Mode

Set minimum resource levels per village. When any village drops below, resources are sent from the richest village that can spare them.

Balance Mode

Equalizes resources across all villages. Sends from surplus villages to deficit ones. Good for keeping everything even.

Supply Mode (Capital)

All villages feed one priority village. Perfect for a capital that trains troops non-stop.

Min Transfer Amount

Set a global minimum total for transfers. Transfers where the total (wood + brick + ore + food) is below this amount are skipped. Prevents sending tiny amounts that waste trader trips.

Donor / Receiver Exclusions

In the village dashboard, you can exclude specific villages from being donors (won't send resources) or receivers (won't receive resources). Useful for protecting a village's resources.

Market & Trader Detection

The bot auto-detects which villages have a Market building and refreshes trader availability every tick. Villages without a Market can still receive resources but cannot send.

Requirements

• At least 2 villages
• Market building in source villages
• Available traders (not all on trips)

Custom Transports

All Plans

Send resources to specific coordinates on a separate timer from the main Resource Manager. Useful for feeding allies, off-map villages, or specific targets.

Setup

1. Scroll to the Custom Transports section inside Resource Manager
2. Click Add Rule
3. Set the target coordinates (X | Y), source village, and amounts
4. Choose a send mode:
   • Fixed — send exact amounts (capped at what's available)
   • Surplus — send everything above a "keep" threshold
   • All — send all resources from the source village
5. Enable the rule and toggle Custom Transports on

Independent Timer

Custom Transports run on their own interval, separate from the main RM cycle. Configure the interval independently.

Defense System

All Plans

Monitors all your villages for incoming attacks and takes automatic defensive actions.

Detection

Scans all villages periodically for incoming troop movements. Configurable scan interval (default: 60 seconds). Alerts trigger when an attack enters the configured early-warning window.

Defense Modes

• Dodge — sends troops out of the village just before the attack lands, then recalls them after
• Evacuate — sends troops and resources to a safe village
• Spend — rapidly spends resources (builds, trains) so the attacker loots nothing

Audio Alerts

Plays an alarm sound when an attack is detected within the trigger window. Never miss an incoming raid.

Mute Attacks

Click the mute button on a detected attack to silence its alert. Useful for ignoring known fake attacks.

Safe Village

Configure a safe village where troops/resources are evacuated to. Should be a village far from the front lines.

Priority System

When an attack is detected, Auto-Train and Resource Manager automatically defer their village switching to avoid interfering with defensive actions.

Map Scanner

All Plans

Scans the world map around your village to find enemies, allies, and bonus terrain tiles.

How to Use

1. Home coordinates are auto-detected
2. Select scan radius (Small / Medium / Large)
3. Click Scan
4. Results show: enemy villages (with score, alliance, distance), own villages, ally villages, explorable terrain

Click any result to navigate to that map position. Click + Farm to add an enemy to your farm list.

Auto Explore

All Plans

Sends spies (Hunters) to explore nearby terrain tiles automatically. Finds resource bonuses.

Requirements

• At least 5 Hunters (spies) in your village
• Scan the map first (Map Scanner section)

Terrain Types

Select which terrain to explore: Forest, Mountain, Desert, Cactus, Lake. Each can contain resource bonuses.

Farm List

All Plans

Automatically raids target villages at configurable intervals.

Setup

1. Scan the map to find enemies
2. Click + Farm on enemy villages in the scan results
3. Or manually add targets via coordinates
4. Set raid interval (default: 15 minutes)
5. Configure troops per target and source village
6. Enable Auto-Farm

Multi-Source Raids

Assign different source villages to different targets. The bot groups raids by source village to minimize switching. Each target can use different troop compositions.

Attack Types

• Plunder (Raid) — steals resources, lower troop losses
• Attack — kills defending troops, takes resources

Raid Jitter

The bot adds random timing jitter (±20%) to raid intervals so attacks aren't predictable. Configurable jitter percentage.

Defense Priority

If any of your villages has an incoming attack, Farm List pauses to keep troops home for defense.

Intel Scanner

All Plans

Automatically collects and organizes spy reports into a searchable table. Know your enemies' strength at a glance.

Setup

1. Open the Intel section
2. Set the scan interval (how often to check for new reports)
3. Toggle Intel on

Data Collected

For each spied village: owner, coordinates, alliance, resources, troops stationed, wall level, and building levels (depending on espionage research level).

Multi-Village Setup

Deputy works across all your villages simultaneously. Here's how:

Auto Build — All Villages

Use the Configure Village dropdown to select each village and configure its buildings + max levels independently. The bot cycles through all villages with auto-build enabled, switching context automatically.

Auto Train — All Villages

Same pattern: select each village in the dropdown, add training tasks. The bot switches to each village, trains, and moves on.

Resource Manager — All Villages

Works globally by design. Click Refresh to load all village data. Markets are auto-detected on first run and trader counts refresh every tick.

Defense — All Villages

Scans all villages simultaneously for incoming attacks. Defensive actions (dodge, evacuate, spend) work per-village.

Capital Mode (Supply)

The most common setup: one village trains troops, all others send resources to it.

Quick Setup

1. Open Resource Manager section
2. Click Refresh to load villages
3. Click the ☆ star next to your training village
4. Done! Mode switches to Supply, thresholds auto-configured

What Happens

• Capital thresholds set to 0 (receives everything)
• Source villages keep 500 reserve (enough for their own building)
• All surplus above 500 is sent to capital
• Adjust reserves in Threshold Settings if needed

Per-Village Configuration

All settings are saved per-village. When you switch villages in the game, the extension loads that village's configuration automatically.

Settings stored per-village:

• Auto Build: enabled buildings, max levels, build mode, delay, instant finish
• Auto Train: unit tasks, reserves, continuous mode, priority order

Settings stored globally:

• Resource Manager (manages all villages as a system)
• Custom Transports rules
• Defense configuration and safe village
• Map Scanner results
• Farm List targets
• Auto-Explore explored tiles
• Intel reports
• Bot Master toggle state

Background Mode

Deputy continues running when the game tab is in the background. Chrome normally throttles timers in background tabs, but Deputy uses a service worker alarm system to keep all features on schedule.

• A 1-minute alarm fires from the background service worker
• Each feature checks if it's overdue and runs if needed
• Re-entrancy protection prevents duplicate ticks from stacking
• All features respect their configured intervals even in background

FAQ

Can I use one license on multiple devices?

No. Each license is bound to one device (browser fingerprint). To switch devices, contact support to reset your fingerprint.

Does the bot work while the tab is in background?

Yes. The bot runs as long as the WildGuns tab is open (doesn't need to be focused). A background service worker keeps all timers on schedule.

Is it safe? Will I get banned?

Deputy uses random delays between actions to avoid detection patterns. It makes the same requests your browser would. However, no bot is 100% undetectable — use at your own risk.

My session keeps expiring

Enable Auto-Login in the Status section. The bot will redirect to the lobby and reconnect automatically.

Can I use it on multiple servers?

Yes. The license works on all servers. Settings are separate per server (stored in Chrome's local storage).

How do I update the extension?

Chrome updates extensions automatically. You can also go to chrome://extensions and click "Update".

Can I configure features before enabling the master switch?

Yes. You can set up all feature toggles, thresholds, farm targets, training tasks, and settings while the master switch is off. When you turn it on, everything starts at once.

What happens when my license expires?

All automation features stop immediately. Your game account is not affected. Settings are preserved and features resume when you renew.

The Resource Manager skips some villages

Check these things:

• Does the village have a Market building? (click Scan Markets to check)
• Is the village excluded as a donor? (check the village dashboard)
• Are all traders busy? The bot skips villages with no available traders and retries next tick.
• Is the transfer amount below the Min Transfer Total setting?

Changelog

v1.4.1

• Fixed: Market detection and trader refresh no longer runs when master switch is off
• Fixed: Trader counts now refresh for ALL villages every tick (not just current village)
• Fixed: Villages with temporarily busy traders are no longer permanently skipped

v1.4.0

• Added: Re-entrancy protection on all 8 feature tick functions — prevents concurrent execution
• Added: All toggle switches now sync properly (uncheck on start failure, update on programmatic stop)
• Added: Features can be configured while master switch is off — auto-start on resume
• Added: Global minimum transfer amount setting for Resource Manager
• Added: Stronger visual dimming when master switch is paused
• Fixed: BACKGROUND_TICK watchdog no longer fires concurrent ticks for any feature
• Fixed: All schedule functions check enabled state before rescheduling
• Fixed: License deactivation now stops ALL 8 features (was only stopping 2)
• Fixed: Defense and Custom Transport ticks now have full cryptographic license verification
• Fixed: Intel timer properly cleared on pause and restarted on resume
• Fixed: Features stop mid-execution when disabled (enabled checks after await points)

v1.3.9

• Fixed: Resource Manager coordinate parsing for villages with coords ≥ 1000
• Fixed: Resource Manager no longer sends to (0|0) when coordinates fail to parse
• Fixed: All features respect master switch — cannot start when paused
• Fixed: Defense muted attacks now persist across page refreshes
• Added: Coordinate fallback chain (DOM → overview → cached)

Support

Need help? Reach us:

When reporting issues, include:

• Which server you're playing on
• What you're trying to do
• Any error messages from the Activity Log
• Your browser version (chrome://version)