Overview

This repository contains a production-ready Turtle WoW automation tool focused on:

• High-efficiency fishing automation with bobber detection (sound, pixel, template matching)
• Grinding and leveling with smart combat rotations for all 9 classes
• Gathering automation for mining (Copper → Thorium) and herbalism routes
• Gold farming optimization with custom route recording and playback
• Support for Turtle WoW, Kronos, Elysium and other 1.12.1 private servers

All core features are implemented in Python with a full CLI menu, configuration via config.json and modular architecture (core, modules, utils, data).

---

Turtle WoW Bot: Fishing, Grinding, Leveling & Gathering Automation Tool

Advanced Turtle WoW bot for fishing, grinding, leveling, gold farming and gathering automation.

🎮 What is this Turtle WoW bot?

This repository contains a Python-based WoW automation tool that handles repetitive tasks in Vanilla WoW 1.12.1 clients:

• Auto fishing with bobber detection (OpenCV, sound, pixel)
• Grinding / leveling loop with combat rotations for all classes
• Gathering automation for mining and herbalism routes
• Gold farming with custom waypoint routes and session statistics

It is written as a stand-alone WoW farming tool with a console menu (main.py).

---

� Who is this Turtle WoW bot for?

If you are looking for:

• "turtle wow fishing bot"
• "wow vanilla grinding bot"
• "wow 1.12.1 leveling bot"
• "turtle wow gold farming tool"
• "wow private server automation"
• "kronos wow bot" or "elysium wow bot"

— this repository provides a fully functional Turtle WoW bot in Python.

---

✨ Key Features of Turtle WoW Bot

🎣 Auto Fishing

• Automatic fishing loop with multiple bobber detection modes
• Sound detection – catches fish by listening for splash sound
• Pixel detection – visual bobber tracking with OpenCV
• Template matching – advanced image recognition for bobber
• Auto-apply fishing lures (Shiny Bauble, Nightcrawlers, Aquadynamic Fish Attractor)
• AFK fishing with randomized delays
• Supports all fishing zones and pools
• Fish statistics and session tracking

🎮 Grinding & Leveling

• Smart combat rotation for all 9 classes (Warrior, Paladin, Hunter, Rogue, Priest, Shaman, Mage, Warlock, Druid)
• Auto-targeting with threat management
• Pulls mobs, kills, loots automatically
• Health and mana management with food/water/potions
• Auto-skinning after kills
• Death recovery with corpse running
• Experience and gold per hour tracking

⛏️ Gathering – Mining & Herbalism

• Mining automation – Copper, Tin, Iron, Mithril, Thorium veins
• Herbalism automation – Peacebloom, Silverleaf, Mageroyal, Kingsblood, and all herbs
• Custom route recording and playback
• Node priority system (skip low-level nodes)
• Player detection and avoidance
• Mount usage for faster farming
• Gold farming optimization

🧭 Navigation & Pathfinding

• A pathfinding algorithm* for optimal routes
• NavMesh support for all Vanilla WoW zones
• Obstacle avoidance and collision handling
• Stuck detection with auto-recovery
• Smooth path interpolation
• Waypoint system with route editor

🛡️ Behavior & Timing

• Randomized mouse movements and delays
• Randomized action timing
• Session time limits
• AFK behavior simulation
• Low resource footprint

---

🌍 Supported Servers

Server	Version	Status
Turtle WoW	1.12.1+	✅ Fully Supported
Kronos	1.12.1	✅ Supported
Elysium	1.12.1	✅ Supported
Darrowshire	1.12.1	✅ Supported
Other Vanilla Servers	1.12.1	✅ Supported

This tool is designed for Vanilla WoW (1.12.1) and works with most private servers using this client version.

---

📦 Installation

System Requirements

• OS: Windows 10 / Windows 11 (64-bit)
• Python: 3.8 or higher
• WoW Client: Vanilla (Turtle WoW, etc.)
• RAM: 4GB minimum
• Permissions: Run as Administrator

Quick Start Guide

# 1. Clone this WoW bot repository
git clone https://github.com/analyticallylave/turtle-wow-bot.git

# 2. Navigate to bot directory
cd turtle-wow-bot

# 3. Install Python dependencies
pip install -r requirements.txt

# 4. Launch the bot
python main.py

Dependencies

opencv-python    # Bobber detection for fishing
numpy            # Image processing
pyautogui        # Mouse/keyboard automation
pywin32          # Windows API integration
psutil           # Process detection
Pillow           # Screen capture

---

🚀 How to Use

Interactive Menu

python main.py

This opens the main menu where you can:

1. Start Grind Bot (leveling/farming)
2. Start Fishing Bot
3. Start Gathering Bot (mining/herbalism)
4. Configure combat rotations
5. Record custom routes
6. Adjust settings

Command Line (Advanced)

# Start grinding bot directly
python main.py --grind

# Start fishing bot
python main.py --fish

# Start gathering/farming bot  
python main.py --gather

# Load custom configuration
python main.py --config myprofile.json

# Enable debug logging
python main.py --debug

---

⚙️ Configuration

Bot Settings (config.json)

{
  "client": {
    "process_name": "WoW.exe",
    "behavior_mode": 2,
    "scan_interval": 0.05
  },
  "pathing": {
    "pathfind_algorithm": "astar",
    "waypoint_tolerance": 2.5,
    "stuck_timeout": 8
  },
  "fishing": {
    "detection_mode": "pixel",
    "auto_lure": true,
    "cast_delay": [0.5, 1.5]
  },
  "combat": {
    "pull_range": 30,
    "health_potion_percent": 30,
    "eat_at_percent": 50
  },
  "enabled_modules": ["navigation", "combat", "gathering"]
}

Setting Up Combat Rotations

1. Launch the bot and select your class
2. Go to Settings > Combat Rotation
3. Customize spell priorities
4. Save your rotation profile

Recording Gathering Routes

1. Select Route Recorder from menu
2. Click Start Recording
3. Walk your desired farming path in-game
4. Save with a descriptive name (e.g., "Durotar Copper Route")

---

📊 Feature Comparison

Feature	This Tool
Price	Free
Open Source	✅
Vanilla 1.12.1	✅
Turtle WoW	✅ Full
Fishing	✅
Grinding	✅
Gathering	✅
Python API	✅
Customizable	Fully

---

❓ Frequently Asked Questions

Is this tool free?

Yes, this is a free and open-source automation tool. No subscription or license key required.

Does the fishing work on Turtle WoW?

Yes! This tool fully supports Turtle WoW private server with all custom content.

What classes are supported?

All 9 Vanilla WoW classes: Warrior, Paladin, Hunter, Rogue, Priest, Shaman, Mage, Warlock, and Druid.

Can I use this for gold farming?

Yes, the gathering module with mining/herbalism routes is designed for gold farming.

Does it work with other servers?

Yes, it works with Kronos, Elysium, Darrowshire and other 1.12.1 private servers.

---

📁 Project Structure

turtle-wow-bot/
├── main.py                    # CLI entry point
├── requirements.txt           # Python dependencies
├── config/
│   └── settings.py            # Configuration manager
├── core/
│   ├── engine.py              # Bot engine & main loop
│   └── client.py              # WoW client integration
├── modules/
│   ├── combat/
│   │   ├── rotation.py        # Class combat rotations
│   │   └── targeting.py       # Target selection logic
│   ├── fishing/
│   │   ├── detector.py        # Bobber detection (OpenCV)
│   │   └── lures.py           # Fishing lure management
│   ├── gathering/
│   │   ├── nodes.py           # Herb/ore node detection
│   │   └── routes.py          # Farming route system
│   └── navigation/
│       ├── pathfinder.py      # A* pathfinding algorithm
│       └── waypoints.py       # Waypoint management
├── utils/
│   └── logger.py              # Logging system
└── data/
    ├── navmesh/               # Navigation mesh files
    ├── profiles/              # User profiles
    └── routes/                # Saved farming routes

---

📜 License

This project is licensed under the MIT License. See LICENSE for details.

---

⚠️ Disclaimer

This software is provided for educational and research purposes only. Use at your own risk. The developers are not responsible for any consequences resulting from use of this software.

---

⭐ Support the Project

If you find this Turtle WoW bot useful:

• Star the repository on GitHub
• Watch it to follow future updates
• Share ideas or improvements via issues / pull requests