WEST GAME HELPER
================

Plays the daily chores of your West Game II town inside an Android emulator on your Windows PC:
gathering, training, mine upgrades, alliance help and gifts, research, mail, free chests and event rewards.
It only presses free buttons. It never presses gold, recharge or purchase buttons.

West Game Helper is an independent tool. It is not made, approved or supported by the makers of West Game II.
Automating a game can break the game's terms of service and your account could be limited or banned.
You use it at your own risk.


WHAT YOU NEED
-------------
 * Windows 10 or 11, 64-bit.
 * LDPlayer (free Android emulator) with West Game II installed. Other emulators can work but are not tested.
 * An active West Game Helper subscription (order number + the email you ordered with).

You do not need to install Python or anything else. Everything is in this folder.


EMULATOR SETUP (one time)
-------------------------
 1. Install LDPlayer and open it.
 2. LDPlayer settings > Advanced (Display): choose "Mobile", resolution 900 x 1600, DPI 320. Save and restart it.
 3. LDPlayer settings > Other settings: turn ADB debugging ON ("Open local connection"). Save.
 4. Install West Game II from Google Play inside LDPlayer. Set the game language to English.
 5. Open the game and log in yourself. Finish the tutorial so you are standing in your town.

West Game Helper never asks for your game or Google password.


START
-----
 1. Keep LDPlayer open with the game running (you may minimise it).
 2. Double-click "Start West Game Helper.bat".
 3. First time only: read the notice, then enter your order number and email to activate this computer.
 4. Leave the window open. It works in rounds, then rests 12-20 minutes.

Stop:   close the window.
Pause:  create an empty file named PAUSE in the "app" folder. Delete it to continue.
Log:    app\bot.log shows everything it did.

Do not play the same account on a phone while the helper runs; the game logs one of you out.
If you do log in on a phone, the helper waits 20 minutes and then logs back in.


SETTINGS (optional)
-------------------
Copy app\settings.example.json to app\settings.json and change what you need:

  max_marches             how many march slots your town has
  reserve_marches         slots kept free for rallies and events
  gather_types            what to gather, in order
  minutes_between_rounds  rest between rounds [shortest, longest]
  quiet_hours             for example [1, 6] = do nothing from 1 AM to 6 AM; null = always on
  tasks                   the chores to run; remove a name to turn that chore off
  adb_path, serial        only needed if the emulator is not found automatically

This edition plays one character per computer.


SUBSCRIPTION
------------
The helper checks your subscription over the internet when it starts and a few times a day.
It sends your order number and email once, at activation, to the DeskBot license service. They are not saved
on this computer. If you cancel, the helper stops working when the paid period ends.
One subscription activates on your own computer; contact support to move it.


TROUBLE
-------
 "No emulator found"        Start LDPlayer, turn on ADB debugging (step 3), start the helper again.
 "Screen size must be..."   Set 900 x 1600 and DPI 320 (step 2).
 It taps the wrong things   Set the game language to English and close any pop-up, then let it try again.
 After a game update        Some screens can change. Updates to the helper are free for subscribers.

Support: https://deskbot.store
