🤖 Advanced Auto Bot, Macro & Management Script for Whiteout Survival

Completely free. Fully open-source. Zero paywalls.

  

---

📖 About  •  ✨ Features  •  🎬 Showcase  •  🛠️ Installation  •  📱 Emulator  •  🚀 Roadmap

---

📖 About The Project

WOS Bot — a free and open-source bot that automates daily tasks, manages multiple accounts, and boosts your Whiteout Survival progression. No paywalls, ever.

Note

Acknowledgment: This project is built upon the excellent foundational work of wosbot by camoloqlo. It is continually developed and expanded with new features and improvements.

✨ Key Features

Packed with features to automate nearly every aspect of the game.

⚔️ Combat & Events Feature Description Arena Battles Automatically fight your Arena matches Polar Terror Join or initiate hunts seamlessly Bear Trap Participate and maximize your damage Alliance Rallies Auto-join rallies & configurable manual rallies Tundra Truck Manage "My Trucks" section efficiently Beast Hunting Auto-hunt wilderness beasts with configurable march count and beast level	🏰 City Management Feature Description Troop Training Auto-train and promote troops to higher tiers Intel & Experts Complete intel missions & manage experts Gathering Keep march queues busy with optimal gathering Hero Recruitment Auto-claim daily hero recruitment options Fire Crystals Collect from Crystal Lab & War Academy Furnace Priority Automatically prioritize and queue Furnace upgrades
🐾 Pets & Exploration Feature Description Pet Adventure Manage food, treasure, and stamina automatically Tundra Trek Automate exploration with optimized routing Journey of Light Full automation with smart pathfinding Exploration Chests Automatically open and claim rewards Auto-Exploration Fully automated wilderness exploration handling	🤝 Alliance & Social Feature Description Alliance Tech Contribute to tech and claim alliance gifts Mail & Rewards Keep inbox clean, claim time-based rewards Nomadic Merchant Process merchant trades efficiently Gift Code Hub Fetch and copy the latest gift codes directly from the UI

⚙️ Advanced Bot Capabilities

Run and manage multiple accounts simultaneously with seamless switching

Intelligent idle monitoring ensures time-sensitive events are never missed

Dynamically inject quick operations into the active queue without disruption

Advanced UI providing real-time logs and bot troubleshooting tools

---

🎬 Showcase & Media

🎥 Video Showcase — Click to expand

Click the image above to watch the full demo on YouTube

📸 Screenshots — Click to expand

---

🛠️ Installation & Setup

Note

Follow these steps to compile and run the bot from source code.

1️⃣ Prerequisites

Requirement	Version	Download
	17 or newer	Adoptium Temurin
	3.8+	Download Maven

💡 Windows Users: Adding Java & Maven to PATH

1. Press Win + R, type sysdm.cpl, and press Enter
2. Go to Advanced → Environment Variables
3. Under System variables, select Path and click Edit
4. Add the bin directories of your Java and Maven installations:

   C:\Program Files\Eclipse Adoptium\jdk-17\bin
   C:\apache-maven-3.9.9\bin
   

5. Click OK and restart your terminal
6. Verify with:

   java -version
   mvn -version

2️⃣ Compilation

# Clone the repository
git clone https://github.com/Shederator/wosbot.git
cd wosbot

# Build the project
mvn clean install package

Tip

Once completed, the compiled .jar file will be in the wos-hmi/target directory (e.g., wos-bot-1.7.1.jar).

3️⃣ Running the Bot

# Navigate to the target directory
cd wos-hmi/target

# Run the compiled jar
java -jar wos-bot-1.7.1.jar

Important

We highly recommend running via command line to access real-time logs for easier debugging. Double-clicking the .jar works, but console logs won't be visible.

---

📱 Emulator Configuration

The bot interfaces with your Android emulator via ADB. Officially supported:

   

Emulator Executable Paths

When prompted by the bot launcher, select the command-line controller (not the graphical app):

📂 MuMu Player

C:\Program Files\Netease\MuMuPlayerGlobal-12.0\shell\MuMuManager.exe
C:\Program Files\Netease\MuMuPlayer\nx_main\MuMuManager.exe

📂 MEmu

C:\Program Files\Microvirt\MEmu\memuc.exe

📂 LDPlayer 9

C:\LDPlayer\LDPlayer9\ldconsole.exe

[!WARNING] You must manually enable ADB: Settings → Other settings → ADB debugging → Enable local connection

Required Instance Settings

Setting	Value	Status
Resolution	720 × 1280 (Portrait)	🔴 Mandatory
DPI	320	🔴 Mandatory
Language	English	🔴 Mandatory
CPU / RAM	2 Cores / 2 GB	🟡 Recommended

Tip

In the game's settings, disable Snowfall and Day/Night Cycle, and avoid Ultra graphics. This considerably improves performance and visual reliability for the bot.

---

🚀 Roadmap

We are continuously working to expand the bot's capabilities.

Status	Feature	Description
	🎣 Fishing Event	Full automation of the fishing event
	🦁 Beast Hunting	Auto-hunt beasts with configurable march count and level
	🎁 Gift Code Hub	Fetch and copy the latest gift codes directly from the UI
	💬 Messaging Integrations	Discord, Telegram & WhatsApp notifications
	🏛️ Alliance Management	Advanced alliance management tools
	🧠 AI Integration	Handling unprogrammable logic & dynamic tasks

---

🤝 Contributing

Contributions are what make the open-source community amazing!
Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch    →  git checkout -b feature/AmazingFeature
3. Commit your Changes           →  git commit -m 'Add some AmazingFeature'
4. Push to the Branch            →  git push origin feature/AmazingFeature
5. Open a Pull Request

---

⭐ Star History

_{If you find this project useful, please consider giving it a star!}

---

Developed with ❤️ for the Whiteout Survival community

Have suggestions or need help?