• ✅ Automatische Barbarensuche: Sucht und farmt automatisch Barbarendörfer in der Umgebung
• 🧠 Intelligente Optimierung: Analysiert Berichte zur Effizienz-Bewertung und passt Farmziele dynamisch an
• 📈 Adaptive Pausen: Längere Pausen für Dörfer mit wenig Beute oder hohen Verlusten
• 🔒 Beutelimit-Schutz: Überwacht das weltweite Farm-Beutelimit und verhindert weitere Befehle bei Erreichen

Das Smart Farming Feature ersetzt fehlende Template-Truppen intelligent durch verfügbare Einheiten:

Beispiel: Template fordert 20 Axtkämpfer (200 Kapazität), aber nur 10 verfügbar? → Smart Farming nimmt 10 Axtkämpfer + 4 Speerträger = gleiche Beute-Kapazität!

Gleicht Ressourcen zwischen den Dörfern automatisch aus, um Engpässe zu vermeiden und den Bau zu beschleunigen.

• 🔄 Automatische Nutzung: Nutzt freie Truppen zum Ressourcensammeln, wenn sie nicht für Farmen/Verteidigung benötigt werden
• 🔓 Auto-Unlock: Schaltet höhere Sammel-Stufen automatisch frei
• 🎯 Intelligente Priorisierung: Weist alle verfügbaren Truppen den effizientesten Operationen zu
• ⚙️ Konfigurierbare Priorität: Wähle zwischen Sammeln oder Farmen als Vorrang

Öffne eine Kommandozeile (Terminal, PowerShell, CMD) im Hauptverzeichnis des Bots:

# Standard-Installation
pip install -r requirements.txt

# Bei mehreren Python-Versionen
python -m pip install -r requirements.txt

python twb.py

💡 Hinweis: Beim ersten Start wird ein interaktiver Einrichtungs-Wizard gestartet, der dich durch die Grundkonfiguration führt.

Die gesamte Steuerung des Bots erfolgt über die zentrale Konfigurationsdatei config.json.

Beim ersten Start von python twb.py wirst du durch einen interaktiven Wizard geführt:

✅ Nach Abschluss wird eine config.json erstellt und der Bot ist einsatzbereit!

Die config.json kann mit jedem Texteditor bearbeitet werden. Änderungen werden beim nächsten Bot-Durchlauf automatisch geladen.

Diese Vorlage wird für neu hinzugefügte Dörfer verwendet. Jedes Dorf kann individuell überschrieben werden.

🔓 Auto-Unlock: Der Bot schaltet höhere Sammel-Slots automatisch frei!

💡 Wie funktioniert Smart Farming?

Wenn dein Farm-Template z.B. 20 Axtkämpfer fordert, aber nur 10 verfügbar sind:

1. Phase 1: Nimmt die 10 verfügbaren Axtkämpfer (100 Kapazität)
2. Phase 2: Füllt die fehlende Kapazität (100) mit Prioritäts-Einheiten auf
3. Ergebnis: 10 Axtkämpfer + 4 Speerträger = 200 Kapazität (wie ursprünglich gewollt)

Die Prioritätenliste bestimmt, welche Einheiten bevorzugt werden. Leichte Kavallerie (light) hat 80 Kapazität und ist daher effizienter als Speerträger (spear) mit 25.

💡 Tipp: Teste mit dry_run: true bevor du den Balancer aktivierst!

ℹ️ Per-Dorf-Override: In villages.<id>.balancer_enabled kannst du einzelne Dörfer ein- oder ausschließen.

Werden automatisch erkannt und gesetzt:

• knight_enabled, flags_enabled, quests_enabled
• farm_bag_limit_enabled - Farm-Beutelimit-Schutz
• farm_bag_block_scouts - Scout-Läufe bei Limit stoppen

• enabled - Detailliertes Log aktivieren
• connection_string - Speicherort (Standard: file://cache/logs/twb_{ts}.log)

• enabled - Benachrichtigungen aktivieren
• channel_id - Deine Telegram Chat-ID
• token - Telegram-Bot-Token

"Die Stämme" schützt den normalen Login-Vorgang mit einem ReCaptcha, was eine Automatisierung erschwert. TWB umgeht dieses Problem auf elegante Weise: Anstatt sich mit Benutzername und Passwort anzumelden, verwendet der Bot eine gültige Sitzungs-Cookie.

Wie funktioniert das?

1. Du loggst dich normal im Browser in deinen Account ein.
2. Dein Browser erhält vom Spieleserver ein Cookie, das deine Sitzung identifiziert.
3. Du kopierst den Wert dieses Cookies und fügst ihn beim ersten Start des Bots ein.
4. Der Bot sendet dieses Cookie bei jeder Anfrage an den Server und erscheint so, als wäre er ein ganz normaler, eingeloggter Browser.

⚠️ Wichtig: Diese Cookies haben eine begrenzte Lebensdauer. Um zu vermeiden, dass der Bot plötzlich ausgeloggt wird, solltest du dich mindestens 1-2 Mal pro Tag im Browser neu einloggen und dem Bot bei Aufforderung ein frisches Cookie zur Verfügung stellen. Ein 24/7-Betrieb mit einem einzigen Cookie ist ein hohes Risiko für eine Sperre.

Der Bot operiert in einer Endlosschleife, die bei jedem Durchlauf folgende Schritte ausführt:

graph TD
    A[Start] --> B{Aktive Stunden?}
    B -->|Ja| C[Internet-Check]
    B -->|Nein| D[Inaktiver Modus]
    C --> E[Konfiguration laden]
    E --> F[Übersicht abrufen]
    F --> G[Dörfer durchlaufen]
    G --> H[Farm-Manager ausführen]
    H --> I[Pause]
    I --> B
    D --> I

1. Prüfung der aktiven Stunden: Der Bot prüft, ob er sich in den in der Konfiguration definierten "active_hours" befindet.
2. Internet-Check: Eine kurze Prüfung, ob eine Internetverbindung besteht.
3. Konfiguration laden: Die config.json wird neu eingelesen, um Änderungen zu übernehmen.
4. Übersicht abrufen: Der Bot lädt die Dorf-Übersichtsseite. Dadurch erkennt er die aktuell verfügbaren Dörfer und die Welteinstellungen (z.B. ob Ritter oder Flaggen aktiv sind).
5. Dörfer durchlaufen: Der Bot iteriert durch jedes in der config.json als "managed": true markierte Dorf und führt die entsprechenden Aktionen aus (Bauen, Rekrutieren, Farmen etc.).
6. Farm-Manager ausführen: Nach dem Durchlauf aller Dörfer wird der globale Farm-Manager (farm_manager) aufgerufen, um die Farm-Statistiken zu analysieren und zu optimieren.
7. Pause: Der Bot pausiert für die in "active_delay" oder "inactive_delay" definierte Zeit, plus eine zufällige Spanne, um menschliches Verhalten zu simulieren.

Eine der stärksten Funktionen des Bots ist die selbstständige Optimierung der Farm-Effizienz. Dies geschieht durch die Analyse der im cache/reports/ Ordner gespeicherten Berichte.

• Analyse: Der farm_manager berechnet für jede Farm die durchschnittliche Beute und die prozentualen Truppenverluste.
• Profil-Anpassung: Farmen mit konstant hoher Beute werden als "high_profile" markiert und häufiger angegriffen, während Farmen mit geringer Beute oder leichten Verlusten als "low_profile" markiert werden, und die Pause bis zum nächsten Angriff wird erhöht.
• Sicherheits-Check: Wenn eine Farm konstant hohe Verluste (>50%) verursacht, wird sie als unsicher ("safe": false) markiert und nicht mehr automatisch angegriffen.

TWB enthält ein optionales Web-Interface, das eine visuelle Übersicht über den Bot-Status bietet.

# Navigiere in das webmanager Verzeichnis
cd webmanager

# Starte den Server
python server.py

Öffne deinen Browser und gehe zu http://127.0.0.1:5000/, um das Dashboard zu sehen.

Wenn der Bot aktualisiert wird und neue Konfigurations-Optionen in der config.example.json hinzukommen, erkennt TWB dies automatisch. Deine bestehende config.json wird gesichert (config.bak) und die neuen Optionen werden intelligent hinzugefügt, ohne deine bisherigen Einstellungen zu überschreiben. Dies stellt sicher, dass deine Konfiguration immer auf dem neuesten Stand ist, ohne dass du sie manuell anpassen musst.

Das Cookie findest du in den Entwicklertools deines Browsers (Taste F12).

1. Gehe zum "Netzwerk" (oder "Network") Tab.
2. Lade die Spielseite neu (F5).
3. Suche nach einer Anfrage, die game.php heißt.
4. Klicke darauf und suche in den "Anfrage-Headern" (Request Headers) nach dem cookie: Eintrag. Kopiere den gesamten Wert.

Der Bot ist so konzipiert, dass er sich nach einem Absturz bis zu dreimal selbst neu startet.

Wenn er dauerhaft abstürzt, überprüfe die Log-Dateien im cache/logs/ Ordner. Dort findest du detaillierte Fehlermeldungen, die dir (oder der Community im Discord) helfen können, das Problem zu diagnostizieren.

Das Risiko ist real und sollte nicht unterschätzt werden. Um es zu minimieren:

• ✅ Verwende realistische Pausenzeiten (active_delay).
• ✅ Nutze die "active_hours", um eine "Schlafenszeit" für den Bot zu simulieren.
• ✅ Aktualisiere dein Cookie regelmäßig.
• ✅ Vermeide es, den Bot auf brandneuen Welten oder mit einem neuen Account zu aggressiv zu nutzen.

Mit Git:

git pull

Ohne Git:

1. Lade die neue Version herunter
2. Entpacke sie
3. Kopiere deine config.json in den neuen Ordner

💡 Dank der automatischen Konfigurations-Aktualisierung bleiben deine Einstellungen erhalten!