mt2 macro (Open Source Automation) – Python OpenCV Tabanlı Metin2 Görsel Otomasyon Botu (Educational Tool)

mt2macro, bilgisayarlı görü (computer vision) tabanlı açık kaynaklı bir masaüstü otomasyon projesidir. Python, OpenCV, mss ve WinAPI kullanılarak geliştirilmiştir ve modern otomasyon sistemlerinin nasıl çalıştığını öğretmeyi amaçlar.

Proje özellikle görsel şablon eşleştirme (template matching), ekran yakalama (screen capture) ve GUI tabanlı otomasyon mantığını göstermek için tasarlanmıştır. CustomTkinter ile modern bir arayüz sunar ve düşük CPU kullanımı ile arka planda stabil çalışacak şekilde optimize edilmiştir.

Bu proje yalnızca eğitim ve araştırma amaçlıdır. Gerçek oyunlarda veya üçüncü taraf yazılımlarda ToS ihlali oluşturabilecek kullanım önerilmez.

---

Özellikler

Görsel Tabanlı Algılama (Computer Vision)

• OpenCV ile template matching sistemi
• Gerçek zamanlı ekran analizi (real-time detection)
• Dinamik hedef algılama yapısı

Modern Arayüz (GUI)

• CustomTkinter ile geliştirilmiş modern panel
• RGB efektli kenarlık animasyonu
• Splash screen (açılış ekranı)
• Dark mode (koyu tema)

Performans & Stabilite

• Düşük CPU kullanımı (~%1–2)
• Arka planda sessiz çalışma (background process)
• Timeout ve takılma algılama sistemi

Esneklik

• Farklı görsel template desteği
• Her türlü masaüstü uygulamasına uyarlanabilir yapı
• Kolay yapılandırılabilir config sistemi

Güvenlik / Kontrol

• Emergency exit (ESC)
• Pause / Resume (F12)
• Otomatik hata algılama ve yeniden başlatma

---

Kurulum

Projeyi klonla


git clone https://github.com/guvenada/mt2macro.git
cd mt2macro



Gerekli paketleri yükle


pip install -r requirements.txt

---

Kullanım

Programı başlat


python external_gui.py



Hedefleri tanımla

• Capture Main → Ana hedef ekran görüntüsü alınır
• Capture Sub → Yan hedefler (elite, buton vb.) kaydedilir
• Görseller target.png ve elite1.png olarak saklanır

Ayarlar

• Threshold (Hassasiyet): 0.55 – 0.75 önerilir
• Action Delay: işlem hızını belirler

Servisi başlat

• START SERVICE → bot arka planda çalışır
• F12 → duraklat / devam ettir
• ESC → acil çıkış

---

Proje Yapısı

• external_gui.py → Ana GUI uygulaması
• external_bot.py → Headless (komut satırı) otomasyon sürümü
• requirements.txt → Python bağımlılıkları
• LICENSE → MIT lisansı
• EDUCATIONAL_CERTIFICATE.md → Eğitim amaçlı kullanım belgesi

deneyelim.