Untitled

avatar
unknown
plain_text
9 months ago
9.5 kB
6
Indexable
# Z-Guard v3.0 - Oper Edition
## Komut Kılavuzu ve Kullanım Dökümanı

---

## 🔐 Yetkilendirme

**Sadece şu nickler komutları çalıştırabilir:**
- **Zagor**
- **Shadow**

Diğer kullanıcılar şu mesajı görür:
```
========================================
[Z-Guard] ERISIM ENGELLENDI
[Z-Guard] Sadece Zagor ve Shadow yetkili!
========================================
```

---

## 📦 Kurulum

### 1. Dosyaları Hazırlama
```
C:\AfraN-IV\z-guard.txt          (ana script)
C:\AfraN-IV\proxy_list.txt       (proxy IP listesi - opsiyonel)
C:\AfraN-IV\banned_countries.txt (yasaklı ülkeler - otomatik oluşur)
C:\AfraN-IV\banned_cities.txt    (yasaklı şehirler - otomatik oluşur)
C:\AfraN-IV\geo_cache.txt        (otomatik oluşur)
```

### 2. Script Yükleme
```
/load -rs C:\AfraN-IV\z-guard.txt
```

### 3. İlk Çıktı
```
========================================
   Z-GUARD v3.0 - OPER EDITION
========================================
 Hash Table Mode: AKTIF
 Max Capacity: 100,000+ IP
 Encoding: ANSI/Windows-1254
 Yetkili Oper: Zagor, Shadow
========================================

[Z-Guard] Proxy listesi yukleniyor...
[Z-Guard] Yuklendi: 10000 / 44000 (22.7%)
[Z-Guard] Yuklendi: 20000 / 44000 (45.5%)
...
[Z-Guard] PROXY YUKLEME TAMAMLANDI: 44000 IP
[Z-Guard] SISTEM HAZIR
```

---

## 📋 Komut Listesi

### 🔧 SİSTEM YÖNETİMİ

| Komut | Açıklama | Örnek |
|-------|----------|-------|
| `/zg start` | Timer'ı başlat | `/zg start` |
| `/zg stop` | Timer'ı durdur | `/zg stop` |
| `/zg status` | Detaylı durum raporu | `/zg status` |
| `/zg reload` | Script'i yeniden yükle | `/zg reload` |
| `/zg clear` | Tüm verileri temizle | `/zg clear` |
| `/zg debug` | Debug modunu aç/kapa | `/zg debug` |
| `/zg autoban` | Otomatik ban'ı aç/kapa | `/zg autoban` |
| `/zg help` | Yardım menüsü | `/zg help` |

---

### 🔍 IP KONTROL

| Komut | Açıklama | Örnek |
|-------|----------|-------|
| `/zg check <IP>` | IP'yi kontrol et | `/zg check 8.8.8.8` |

**Örnek Çıktı:**
```
========================================
[Z-Guard] IP: 8.8.8.8
[Z-Guard] Ulke: United States (US)
[Z-Guard] Sehir: Mountain View
[Z-Guard] ISP: Google LLC
[Z-Guard] Sonuc: TEMIZ
========================================
```

---

### 🚫 PROXY YÖNETİMİ

#### Proxy Ekleme
```
/zg proxy add <IP>
```
**Örnek:**
```
/zg proxy add 1.2.3.4
[Z-Guard] 1.2.3.4 proxy listesine eklendi
```

#### Proxy Silme
```
/zg proxy del <IP>
```
**Örnek:**
```
/zg proxy del 1.2.3.4
[Z-Guard] 1.2.3.4 silindi (dosya guncellemesi icin /zg proxy save)
```

#### Proxy Listeleme
```
/zg proxy list           → İlk 10 IP'yi gösterir
/zg proxy list full      → Tüm listeyi gösterir
```
**Örnek Çıktı:**
```
========================================
[Z-Guard] PROXY LISTESI
[Z-Guard] Toplam: 44000 IP
========================================
[Z-Guard] Ilk 10 IP:
[Z-Guard] 1. 103.21.244.0
[Z-Guard] 2. 103.22.200.0
[Z-Guard] 3. 103.31.4.0
...
[Z-Guard] Tum listeyi gormek: /zg proxy list full
========================================
```

#### Proxy Kaydetme
```
/zg proxy save
```
Bellekteki tüm proxy'leri `proxy_list.txt` dosyasına kaydeder.

---

### 🌍 ÜLKE YÖNETİMİ

#### Yasaklı Ülke Ekleme
```
/zg country add <KOD>
```
**Örnek:**
```
/zg country add RU
[Z-Guard] Ulke eklendi: RU

/zg country add CN
[Z-Guard] Ulke eklendi: CN
```

**Ülke Kodları (ISO 3166-1 alpha-2):**
- `TR` - Türkiye
- `RU` - Rusya
- `CN` - Çin
- `US` - Amerika
- `KP` - Kuzey Kore
- `IR` - İran
- `SY` - Suriye

#### Yasaklı Ülke Silme
```
/zg country del <KOD>
```
**Örnek:**
```
/zg country del RU
[Z-Guard] Ulke silindi: RU (dosya guncellemesi: /zg country save)
```

#### Yasaklı Ülke Listeleme
```
/zg country list
```
**Örnek Çıktı:**
```
========================================
[Z-Guard] YASAKLI ULKELER
========================================
[Z-Guard] 1. RU
[Z-Guard] 2. CN
[Z-Guard] 3. KP
========================================
```

#### Yasaklı Ülke Kaydetme
```
/zg country save
```
Bellekteki tüm yasaklı ülkeleri `banned_countries.txt` dosyasına kaydeder.

---

### 🏙️ ŞEHİR YÖNETİMİ

#### Yasaklı Şehir Ekleme
```
/zg city add <şehir adı>
```
**Örnek:**
```
/zg city add moscow
[Z-Guard] Sehir eklendi: moscow

/zg city add beijing
[Z-Guard] Sehir eklendi: beijing
```

**Not:** Şehir adları küçük harf olmalı!

#### Yasaklı Şehir Silme
```
/zg city del <şehir adı>
```
**Örnek:**
```
/zg city del moscow
[Z-Guard] Sehir silindi: moscow (kaydetmek: /zg city save)
```

#### Yasaklı Şehir Listeleme
```
/zg city list
```
**Örnek Çıktı:**
```
========================================
[Z-Guard] YASAKLI SEHIRLER
========================================
[Z-Guard] 1. moscow
[Z-Guard] 2. beijing
[Z-Guard] 3. tehran
========================================
```

#### Yasaklı Şehir Kaydetme
```
/zg city save
```
Bellekteki tüm yasaklı şehirleri `banned_cities.txt` dosyasına kaydeder.

---

### 💾 CACHE YÖNETİMİ

#### Geo Cache Temizleme
```
/zg cache clear
```
**Örnek:**
```
/zg cache clear
[Z-Guard] Geo cache temizlendi (5234 kayit)
```

Bu komut sadece bellekteki cache'i temizler. Dosyayı silmez.

---

## 📊 Durum Raporu

```
/zg status
```

**Örnek Çıktı:**
```
========================================
[Z-Guard] DURUM RAPORU v3.0
========================================
Proxy IP: 44000
Geo Cache: 5234
Yasak Ulke: 3
Yasak Sehir: 5
Kuyruk: 0
Timer: ACIK
AutoBan: ACIK
Debug: ACIK
========================================
```

---

## 🎯 Kullanım Senaryoları

### Senaryo 1: Rusya'yı Yasakla
```
/zg country add RU
/zg country save
```
Artık Rusya'dan gelen tüm kullanıcılar otomatik ban alır.

### Senaryo 2: Yeni Proxy Ekle
```
/zg proxy add 185.220.101.1
/zg proxy save
```

### Senaryo 3: Belirli Şehri Yasakla
```
/zg city add tehran
/zg city save
```

### Senaryo 4: IP Kontrol Et
```
/zg check 185.220.101.1
```
**Çıktı:**
```
========================================
[Z-Guard] IP: 185.220.101.1
[Z-Guard] Sonuc: PROXY
========================================
[Z-Guard] AUTOBAN: 185.220.101.1
```

### Senaryo 5: Sistem Yeniden Yükle
```
/zg reload
```
Dosyalardaki güncel verileri yükler.

---

## 🔄 Otomatik Kontroller

### Kanal Girişlerinde
Bot, kanala her kullanıcı girdiğinde otomatik kontrol yapar:

```
[Z-Guard] JOIN: TestUser -> 185.220.101.1
[Z-Guard] 185.220.101.1 -> PROXY LISTESINDE
[Z-Guard] AUTOBAN: 185.220.101.1
```

### Geo Sorgusu
IP cache'de yoksa otomatik geo sorgusu yapılır:

```
[Z-Guard] GEO: 8.8.8.8 -> United States (US) | Mountain View
```

---

## ⚙️ Ayarlar

### Debug Modu
```
/zg debug
```
- **Açık:** Tüm detayları gösterir (JOIN, cache hit vb.)
- **Kapalı:** Sadece önemli olayları gösterir

### AutoBan
```
/zg autoban
```
- **Açık:** Tespit edilen IP'ler otomatik KLINE alır
- **Kapalı:** Sadece uyarı verir, ban atmaz

---

## 📁 Dosya Formatları

### proxy_list.txt
```
1.2.3.4
5.6.7.8:8080
9.10.11.12
```
- Her satırda bir IP
- Port opsiyonel (otomatik temizlenir)
- `#` ile başlayan satırlar yorum

### banned_countries.txt
```
# Yasakli ulkeler
RU
CN
KP
IR
```
- Her satırda bir ülke kodu
- Büyük harf

### banned_cities.txt
```
# Yasakli sehirler
moscow
beijing
tehran
```
- Her satırda bir şehir adı
- Küçük harf

### geo_cache.txt (Otomatik)
```
8.8.8.8|United States|US|Mountain View|Google LLC
1.1.1.1|Australia|AU|Sydney|Cloudflare
```
Format: `IP|Country|CountryCode|City|ISP`

---

## 🐛 Sorun Giderme

### Problem: "ERISIM ENGELLENDI"
**Çözüm:** Sadece `Zagor` veya `Shadow` nick'i ile bağlanın.

### Problem: Proxy listesi yüklenmedi
**Kontrol:**
```
//echo -a $isfile(C:\AfraN-IV\proxy_list.txt)
//echo -a $lines(C:\AfraN-IV\proxy_list.txt)
```

### Problem: KLINE çalışmıyor
**Gereksinimler:**
- IRCop yetkisi
- `/oper` ile giriş yapılmış
- Sunucuya bağlı

**Kontrol:**
```
//echo -a $server
```

### Problem: Geo sorgusu başarısız
**Kontrol:**
```
/dns ip-api.com
```
İnternet bağlantınızı kontrol edin.

---

## 📈 Performans

### Yükleme Süreleri
| Proxy Sayısı | Yükleme Süresi | Bellek |
|--------------|----------------|--------|
| 10,000       | ~2 saniye      | ~5 MB  |
| 50,000       | ~10 saniye     | ~20 MB |
| 100,000      | ~20 saniye     | ~40 MB |

### Hash Table Avantajları
- **Eski:** `/set %zg_proxy_*` → 100K'da donma
- **Yeni:** `hmake ZG_PROXY` → Anında arama

---

## 🔥 Hızlı Referans

```
# TEMEL
/zg start              → Başlat
/zg stop               → Durdur
/zg status             → Durum

# IP KONTROL
/zg check 8.8.8.8      → IP kontrol

# PROXY
/zg proxy add 1.2.3.4  → Ekle
/zg proxy del 1.2.3.4  → Sil
/zg proxy list         → Listele
/zg proxy save         → Kaydet

# ÜLKE
/zg country add RU     → Ekle
/zg country del RU     → Sil
/zg country list       → Listele
/zg country save       → Kaydet

# ŞEHİR
/zg city add moscow    → Ekle
/zg city del moscow    → Sil
/zg city list          → Listele
/zg city save          → Kaydet

# AYARLAR
/zg debug              → Debug aç/kapa
/zg autoban            → AutoBan aç/kapa
/zg reload             → Yeniden yükle
/zg clear              → Temizle
```

---

## 📞 Destek

Herhangi bir sorun için:
1. `/zg status` ile durumu kontrol edin
2. `/zg debug` ile detaylı log açın
3. Sorunu tekrar edin ve logları kaydedin

**Versiyon:** 3.0 - Oper Edition  
**Encoding:** ANSI/Windows-1254  
**Yetkililer:** Zagor, Shadow
Editor is loading...
Leave a Comment