🎮 GENTAHAX MCP

Growtopia GENTAHAX v5.61 için EKSİKSİZ AI Araç Seti — Model Context Protocol

👑 Filigran: mr_berk

39 araç · 6832 gerçek item ID · 57 Android API · 18 Windows API · 32 cheat kodu · 39 paket tipi · 22 DLL-doğrulamalı variant fonksiyonu · 19 ban-risk kuralı

SAHTE DEĞİL — GERÇEK VERİLERLE EĞİTİLDİ

📡 Veri Kaynakları (Hepsi Gerçek)

Bu MCP uydurma veri içermez. Tüm bilgi tabanı iki doğrulanmış kaynaktan derlendi:

Engine: Lua 5.4.6 · Script yolları: Android/media/GENTAHAX/Script/*.lua (Android), Script/*.lua (Windows)

🛠️ Araç Seti (39 araç)

📚 Bilgi Tabanı — offline, her zaman çalışır

🛡️ Güvenlik — ban riski analizi (asla çalıştırmaz)

🎮 Canlı Köprü — gerçek zamanlı oyun verisi

📁 Script Yönetimi

gh_scripts_list · gh_script_read · gh_script_write · gh_script_delete · gh_logs_read

ℹ️ Meta

gh_watermark (mr_berk imza bloğu)

⚠️ Ban Riski Sistemi

Kullanıcı güvenliği birinci önceliktir. gh_run_lua her çalıştırmadan önce kodu analiz eder:

{
  "calistirildi": false,
  "uyari": "⚠️ UYARI: BUNDA BAN RİSKİ VAR! Bu kod yüksek riskli işlemler içeriyor...",
  "risk_seviyesi": "YÜKSEK (100/100)",
  "sebepler": ["Sleep'siz sonsuz döngü — dongu icine sleep(300) ekleyin", ...],
  "ne_yapmali": "Kodun bu kısmını düzeltin ya da force=true ile tekrar deneyin."
}

Kural tablosu (19 kural):

• 🔴 YÜKSEK: sleep'siz döngü + paket spam, action|enter_game, hızlı dünya gir-çık, HWID değiştirme (randomGid/randomMac/setGid/setMac), ENet yönlendirme, döngüde requestTileChange
• 🟡 ORTA: auto-collect/fishing/farm (insan aralıklarıyla düşer), Mod Fly, No Clip, toplu drop
• 🟢 DÜŞÜK: ESP/görsel katman, veri okuma, ImGui, webhook

Güvenli mod (varsayılan AÇIK): yüksek riskli kod force=true ile bile çalışmaz — GENTAHAX_SAFE_MODE=0 gerekir.

🟤 "Dünyada Kaç Tane X Var?" — Gerçek Canlı Cevap

Kullanıcı AI'ına dünyada kaç tane dirt var diye sorduğunda, AI gh_world_count_item("Dirt") çağırır ve oyunun canlı belleğindeki TÜM tile'lar taranır:

{
  "soru": "'BUYDIRT dünyasında kaç tane Dirt var?",
  "cevap": "264 adet Dirt (ID 2) — ön plan: 214, arka plan: 50",
  "taranan_tile": 6000,
  "on_plan_fg": 214,
  "arka_plan_bg": 50,
  "canli_dogrulama": { "oyun_dedi": "Dirt", "veritabani_dedi": "Dirt", "uyusuyor": true },
  "ban_riski": "YOK — sadece okuma (RAM taraması), sunucuya hiçbir paket gönderilmedi"
}

Nasıl çalışır:

1. Eşya çözümü: "Dirt" → ID 2 (6832'lik GERÇEK veritabanından; belirsiz isimde asla tahmin etmez, aday listeler)
2. Canlı tarama: köprü getTile() vektörünü tarar — sadece okur, sunucuya paket gitmez → ban riski YOK
3. Çapraz doğrulama: oyunun kendi getItemByID(2).name sonucu veritabanıyla karşılaştırılır

Bu akış uçtan uca test edildi: gerçek Lua runtime'ında 6000 tile'lık simüle dünya, dosya-IPC köprüsü ve MCP protokolü üzerinden 30/30 test geçti (scripts/test_world_count_e2e.py).

🚀 Kurulum

1) Gereksinimler

pip install fastmcp          # MCP sunucu kütüphanesi

2) Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "gentahax": {
      "command": "python",
      "args": ["C:/yol/gentahax-mcp/server.py"],
      "env": {
        "GENTAHAX_SCRIPT_DIR": "C:/Users/KULLANICI/GENTAHAX/Script"
      }
    }
  }
}

3) Cursor / VS Code (Copilot)

.cursor/mcp.json veya .vscode/mcp.json:

{
  "mcpServers": {
    "gentahax": {
      "command": "python",
      "args": ["./gentahax-mcp/server.py"]
    }
  }
}

4) Android (adb köprüsü)

"env": {
  "GENTAHAX_TARGET": "adb",
  "GENTAHAX_ADB_DIR": "/storage/emulated/0/Android/media/GENTAHAX/Script"
}

5) Canlı köprü kurulumu (oyun verisi için)

1. AI'a: gh_bridge_deploy çağır → gentahax_bridge.lua cihaza yazılır
2. GENTAHAX menü → Lua Executor → gentahax_bridge.lua → Execute
3. AI'a: gh_device_status → PONG görüyorsan hazırsın 🎉

Artık AI gerçek zamanlı dünya/oyuncu/envanter verisi okuyabilir ve güvenli kod çalıştırabilir.

🏗️ Mimari

┌─────────────┐   MCP (stdio)   ┌──────────────┐   bridge_in.txt    ┌──────────────────┐
│  Claude /    │ ◄────────────► │  server.py   │ ─────────────────► │ gentahax_bridge  │
│  Cursor AI   │    39 araç     │  knowledge   │ ◄───────────────── │     .lua         │
└─────────────┘                 │  bridge      │   bridge_out.txt   │ (oyun içinde     │
                                └──────────────┘                    │  sürekli thread) │
                                                                    └──────────────────┘

• Bilgi araçları köprü olmadan çalışır (offline)
• Canlı araçlar dosya-IPC köprüsü kullanır: Python bridge_in.txt'ye komut yazar → Lua thread okuyup çalıştırır → sonuç bridge_out.txt'ye döner
• Windows: doğrudan klasör · Android: adb push/pull

📜 Lisans & Sorumluluk

MIT License — bkz. LICENSE.

⚠️ SORUMLULUK REDDİ: Bu proje eğitim ve araştırma amaçlıdır. Growtopia kullanım koşulları üçüncü parti mod/cheat kullanımını yasaklar; hesabınız banlanabilir. GENTAHAX MCP, yüksek riskli kodlarda sizi uyarır ancak nihai karar ve sorumluluk size aittir. Değerli eşyalarınızın olduğu hesaplarda kullanmayın.

👑 mr_berk

GENTAHAX MCP v1.1.0 — Gerçek verilerle eğitildi · Ban riski uyarı sistemli · 39 araç · 6832 gerçek eşya ID

Veri: OFFICIAL GENTA-HAX-DOCS + GENTAHAX v5.61 DLL doğrulaması (Lua 5.4.6) + items.dat tabanlı gerçek item ID listesi