HellGuard AntiCheat – Minecraft 1.21.x ve 26.2 Türkçe Anti Hile Eklentisi

Minecraft survival sunucularında oyuncu deneyimini bozan en önemli sorunlardan biri hile kullanan oyunculardır. Fly, KillAura, Speed, XRay, Scaffold, Nuker ve TriggerBot gibi hileler yalnızca adil rekabeti ortadan kaldırmaz; aynı zamanda sunucudaki güven ortamına ve oyuncu kitlesine de ciddi zarar verir.

HellGuard AntiCheat, Minecraft sunucularında yaygın olarak kullanılan hileleri tespit etmek, engellemek ve yöneticilere bildirmek amacıyla geliştirilmiş, kolay yönetilebilir ve optimize edilmiş bir anti hile eklentisidir.

Eklenti; karmaşık menüler, zor anlaşılır ayarlar ve çok sayıda zorunlu bağımlılık yerine sade bir yapı sunar. Türkçe ve İngilizce dil desteğine sahip olan HellGuard, hem yeni sunucu kuranlar hem de mevcut sunucusuna hafif bir koruma katmanı eklemek isteyen yöneticiler için hazırlanmıştır.

HellGuard AntiCheat Nedir?

HellGuard, oyuncuların hareketlerini, saldırılarını, blok kırma ve yerleştirme davranışlarını, envanter işlemlerini ve madencilik alışkanlıklarını analiz eden bir Minecraft anti hile eklentisidir.

Tek bir şüpheli hareket nedeniyle doğrudan ceza vermek yerine çoğu kontrolde birden fazla kanıt toplar. Böylece normal oyuncuların internet gecikmesi, düşük TPS, iksir etkileri, buz üzerinde hareket, knockback veya benzeri doğal oyun mekanikleri nedeniyle yanlışlıkla cezalandırılması azaltılmaya çalışılır.

Eklenti yalnızca hileyi raporlamakla kalmaz. Yapılandırmaya bağlı olarak:

• Şüpheli işlemi iptal edebilir.
• Oyuncuyu son güvenli konumuna geri gönderebilir.
• Yöneticiye anlık uyarı gönderebilir.
• Hile şüphesi bulunan oyuncuyu bilgilendirebilir.
• Belirlenen ihlal seviyesinde oyuncuyu sunucudan atabilir.
• İhlalleri optimize edilmiş log sistemine kaydedebilir.

Her kontrolün uyarı, engelleme ve otomatik atma ayarı ayrı ayrı yönetilebilir.

Desteklenen Hile Kontrolleri

HellGuard, hareketten savaşa, madencilikten envanter kullanımına kadar farklı alanlarda kontroller sunar.

Fly Koruması

Fly kontrolü, oyuncunun normal Minecraft fiziğine uymayan şekilde yükselmesini, havada asılı kalmasını veya düşmeden ilerlemesini analiz eder.

Kesinleşmiş bir uçuş hareketinde oyuncunun ikinci kez hile kullanması beklenmez. Yapılandırmada etkinleştirildiğinde oyuncu doğrudan son güvenli konumuna gönderilir.

Creative, Spectator, uçuş izni, Elytra, Levitation, Slow Falling, araç kullanımı ve benzeri geçerli durumlar kontrol dışında bırakılır.

Speed ve Timer Kontrolü

Speed sistemi yalnızca oyuncunun tek bir hareket mesafesine bakmaz. Sprint, sprint-zıplama, iksir etkisi, buz, slime, knockback, ping ve sunucu TPS değeri gibi etkenleri hesaba katar.

Timer kontrolü ise istemcinin sunucuya normalden daha hızlı hareket verisi göndermeye çalışıp çalışmadığını inceler. Paket sıklığı, zaman bakiyesi ve hareket aralıkları birlikte değerlendirilir.

Bu iki kontrol birbirinden bağımsız çalışır. Timer ihlali doğrudan Speed puanını yükseltmez.

KillAura ve MultiAura

KillAura kontrolü hem oyunculara hem de yaratıklara yapılan saldırıları analiz eder.

İncelenen davranışlar arasında şunlar bulunur:

• Bakış açısı dışında saldırı
• Duvar arkasındaki hedefe vurma
• İnsan dışı hızda hedef değiştirme
• Çok kısa sürede birden fazla hedefe saldırma
• Fare hareketi olmadan farklı hedeflere geçme
• Swing davranışıyla uyuşmayan saldırılar
• Hedefe kilitlenir kilitlenmez saldırma
• Normalin üzerindeki saldırı mesafesi

Normal bir vuruşun KillAura olarak değerlendirilmesini engellemek için birden fazla bağımsız kanıt aranır.

Aimbot Kontrolü

Aimbot sistemi oyuncunun dönüş hareketlerini ve hedefe kilitlenme biçimini inceler.

Ani ve kusursuz hedef kilitleri, robotik dönüş aralıkları, farklı hedeflerde tekrar eden benzer dönüş hareketleri ve insan davranışıyla uyuşmayan nişan değişimleri değerlendirilir.

Tek başına hızlı fare hareketi Aimbot sayılmaz. İhlalin tekrar eden bir davranış oluşturması gerekir.

TriggerBot

TriggerBot kullanan istemciler, nişangâh hedefin üzerine geldiği anda otomatik saldırı yapabilir.

HellGuard bu davranışı tespit etmek için:

• Hedefe girildikten sonraki tepki süresini
• Swing ve gerçek saldırı oranını
• Iskalama yüzdesini
• Tekrar eden hızlı tepki örneklerini
• Saldırı aralıklarındaki düzenliliği

analiz eder.

AutoClicker

AutoClicker kontrolü yalnızca yüksek CPS değerine bakmaz. Tıklamalar arasındaki sürelerin aşırı düzenli olup olmadığını ve bu davranışın ne kadar süre devam ettiğini de inceler.

Böylece kısa süreli hızlı tıklama ile otomatik tıklama yazılımları birbirinden ayrılmaya çalışılır.

Scaffold Walk

Scaffold kontrolü, oyuncunun yürürken veya koşarken otomatik şekilde ayak altına blok yerleştirmesini engellemek için geliştirilmiştir.

Sistem şu verileri birlikte değerlendirir:

• Yerleştirilen bloğun oyuncunun ayak altındaki konumu
• Oyuncunun hareket edip etmediği
• Oyuncunun eğilip eğilmediği
• Blok yerleştirme açısı
• Yerleştirmeler arasındaki süre
• Ardışık blok yerleştirme zinciri

Normal şekilde aşağı bakarak ve eğilerek köprü kuran oyuncuların doğrudan ihlal alması önlenmeye çalışılır.

FastPlace

FastPlace kontrolü kısa süre içinde insan davranışının üzerinde blok yerleştirilmesini analiz eder.

Saniyelik yerleştirme sayısının yanında 250 milisaniyelik ani yoğunluk, yerleştirilen blokların mesafesi ve işlemler arasındaki zaman farkı da değerlendirilir.

FastBreak

FastBreak kontrolü, oyuncunun bir bloğu olması gerekenden daha kısa sürede kırmasını tespit eder.

Kontrol sırasında:

• Kırılan blok
• Kullanılan alet
• Aletin özellikleri
• Haste ve Mining Fatigue etkileri
• Oyuncunun bulunduğu ortam
• Blok kırma süresi

hesaba katılır.

FastBreak sistemi sabit bir süre kullanmak yerine mümkün olduğu durumlarda oyuncuya özel gerçek blok kırma hızından yararlanır.

AutoMine

AutoMine, oyuncunun bakmadığı veya normal erişim mesafesinin dışında bulunan blokları otomatik olarak kazmasını analiz eder.

Çok kısa sürede farklı bloklara geçme, görüş açısıyla uyuşmayan kırma işlemleri ve insan dışı hedef değiştirme hareketleri kontrol edilir.

Nuker

Nuker kontrolü, kısa sürede geniş bir alandaki çok sayıda bloğun otomatik olarak kırılmasını engellemeyi amaçlar.

Normal düz tünel kazmak tek başına Nuker ihlali oluşturmaz. Yüksek blok sayısı, geniş kırma alanı, görüş dışındaki bloklar ve hızlı hedef değişimleri birlikte değerlendirilir.

BoatFly

BoatFly kullanan oyuncular tekneleri normal Minecraft fiziğine aykırı biçimde uçurabilir veya havada ilerletebilir.

HellGuard:

• Teknenin havada yükselmesini
• Havada uzun süre asılı kalmasını
• Olağan dışı yatay hızını
• Normal araç fiziğiyle uyuşmayan hareketleri

analiz eder.

AutoArmor

AutoArmor kontrolü, oyuncunun envanterindeki zırhları insan dışı hızda otomatik olarak kuşanmasını tespit etmeye çalışır.

Normal bir shift-click işlemi doğrudan hile sayılmaz. Aynı tick içinde birden fazla zırh işlemi, aşırı kısa işlem aralıkları ve savaş sırasında yapılan seri zırh değişimleri birlikte analiz edilir.

InventoryMove

InventoryMove, sandık, market veya benzeri bir envanter ekranı açıkken oyuncunun normal olmayan biçimde hareket etmeye devam etmesini kontrol eder.

Sunucuda özel menü kullanan eklentiler bulunuyorsa bu kontrol config üzerinden kapatılabilir veya toleranslı hâle getirilebilir.

AutoFish

AutoFish kontrolü balığın oltayı ısırdığı an ile oyuncunun oltayı çektiği an arasındaki süreyi ölçer.

Tek bir hızlı tepki nedeniyle ceza verilmez. İnsan davranışıyla uyuşmayan hızlı tepki örneklerinin tekrar etmesi ve oltanın aşırı hızlı yeniden atılması değerlendirilir.

NoFall, Jesus ve Phase

HellGuard ayrıca şu hareket hilelerine karşı kontroller içerir:

• NoFall: Yüksekten düşüp hasar almama
• Jesus: Su veya lav yüzeyinde normal olmayan hareket
• Phase: Tam blokların içerisine girme veya blok içinden geçme

Reach

Reach kontrolü oyuncunun saldırdığı hedefin gerçek hitbox mesafesini hesaplamaya çalışır.

Ping ve oyuncu hareketi için tolerans uygulanır. Belirlenen sınırın üzerindeki tekrar eden saldırılar ihlal olarak kaydedilir.

AntiKnockback

AntiKnockback kontrolü oyuncunun aldığı geri tepkiye olağan dışı biçimde direnmesini analiz eder.

Özel PvP, knockback veya savaş eklentileriyle çakışma ihtimali bulunduğu için varsayılan olarak isteğe bağlı kullanılabilir.

XRay Koruması Nasıl Çalışıyor?

HellGuard’ın XRay sistemi tek bir yönteme bağlı değildir.

Kullanılabilen Anti-Xray modları:

anti-xray:
  mode: auto

• auto: Sunucuya uygun motoru otomatik seçer.
• native: Paper ailesinin yerleşik Anti-Xray sistemini kullanır.
• portable: HellGuard’ın oyuncuya özel cevher maskelemesini kullanır.
• hybrid: Native ve portable korumayı birlikte çalıştırır.
• behavior-only: Yalnızca madencilik davranışını analiz eder.

Paper ve Purpur Sunucuları

Paper, Purpur ve Paper tabanlı sunucularda yerleşik Anti-Xray motoru kullanılabilir.

HellGuard aşağıdaki komutla önerilen ayarları oluşturabilir:

/hellguard antixray install balanced

Daha sert bir yapı için:

/hellguard antixray install strict

Yapılandırma değiştirilmeden önce mevcut dosyalar yedeklenir.

Spigot ve Diğer Sunucular

Yerleşik Anti-Xray motoru bulunmayan sunucularda portable maskeleme kullanılabilir.

Bu sistem:

• Yeni chunk yüklemez.
• Yalnızca yüklü chunkları inceler.
• Chunk verilerini sınırlı bir kuyrukta işler.
• Uzak ve gizli cevherleri oyuncuya taş benzeri bloklar olarak gösterir.
• Oyuncu yaklaştığında gerçek cevheri yeniden gösterir.
• Gerçek dünya bloklarını değiştirmez.

Portable koruma, Paper’ın paket gönderilmeden önce çalışan yerleşik Anti-Xray sistemi kadar güçlü değildir. Ancak davranış analiziyle birlikte Spigot tabanlı sunucular için ek bir koruma katmanı sunar.

Chest ESP Koruması

Sunucu, bir oyuncunun istemcisinde Chest ESP özelliğinin açık olup olmadığını doğrudan öğrenemez. Bu nedenle HellGuard konteyner bloklarını oyuncuya özel olarak maskeleyebilir.

Desteklenen bloklardan bazıları:

• Sandık
• Tuzaklı sandık
• Ender sandığı
• Varil
• Shulker kutuları
• Spawner
• Trial Spawner
• Vault

Balanced profil yalnızca gizli konteynerleri maskelemeye odaklanır. Strict profil ise belirlenen mesafenin dışındaki görünür konteynerleri de gizleyebilir.

Yönetici GUI’si

HellGuard, oyun içerisinden kullanılabilen bir yönetim paneline sahiptir.

/hellguard gui

GUI üzerinden:

• Kontroller açılıp kapatılabilir.
• Kontrolün eylemi iptal edip etmeyeceği seçilebilir.
• Oyuncuya uyarı gönderme değiştirilebilir.
• Otomatik kick açılıp kapatılabilir.
• Son kritik ihlaller görüntülenebilir.
• Şüpheli oyuncuların ihlal seviyeleri incelenebilir.
• Anti-Xray motorunun durumu görülebilir.
• Log sistemi yönetilebilir.
• Balanced ve Strict profiller arasında geçiş yapılabilir.

GUI izni:

hellguard.gui

Kontrol Bazında Kick Sistemi

Her hile kontrolü için otomatik kick ayrı ayrı ayarlanabilir.

Örnek:

checks:
  fly:
    enabled: true
    cancel: true
    warn-player: true
    kick-enabled: true
    kick-vl: 14.0

Komutla değiştirmek için:

/hellguard kick fly on
/hellguard kick speed off
/hellguard kick killaura on
/hellguard kick scaffold on

Bütün otomatik kickleri kapatmak için:

actions:
  kick-enabled: false

Kick kapatıldığında hile engelleme, setback, yönetici uyarısı ve loglama çalışmaya devam eder.

Oyuncuya Hile Uyarısı Gönderme

HellGuard, şüpheli davranış tespit edilen oyuncuya da uyarı gönderebilir.

Açmak için:

/hellguard playerwarnings on

Kapatmak için:

/hellguard playerwarnings off

Her kontrolün oyuncu uyarısı ayrı ayrı değiştirilebilir:

checks:
  speed:
    warn-player: false

Oyuncunun yalnızca eylemi gerçekten engellendiğinde mesaj görmesi de sağlanabilir:

player-warnings:
  only-when-action-blocked: true

Optimize Edilmiş Log Sistemi

HellGuard log sisteminin kontrolsüz biçimde yüzlerce dosya oluşturmasını önlemek için rotasyon ve otomatik temizlik özellikleri kullanır.

Log sistemi:

• Kayıtları arka planda yazar.
• Ana sunucu thread’ini dosya yazımı için bekletmez.
• Kuyruğa alınan verileri toplu olarak kaydeder.
• Dosya boyutuna ve güne göre rotasyon yapar.
• Eski logları GZIP formatında sıkıştırabilir.
• Belirlenen günden eski kayıtları temizleyebilir.
• Maksimum arşiv sayısı belirlenebilir.
• Sunucu açılışında otomatik temizlik yapabilir.

Önerilen ayarlar:

logging:
  enabled: true
  queue-capacity: 4096
  batch-size: 64
  flush-interval-seconds: 2
  max-file-size-mb: 8
  retention-days: 14
  max-archives: 30
  compress-rotated: true
  cleanup-on-start: true

Log komutları:

/hellguard logs status
/hellguard logs clean expired
/hellguard logs clean all

Bütün logları silme işleminde GUI üzerinden ek onay ekranı gösterilir.

Türkçe ve İngilizce Dil Desteği

Varsayılan dil Türkçedir:

language: tr

İngilizce kullanmak için:

language: en

Dil dosyaları:

plugins/HellGuard/lang/tr.yml
plugins/HellGuard/lang/en.yml

Yönetici uyarıları, oyuncu mesajları, komut açıklamaları ve kontrol adları düzenlenebilir.

Balanced ve Strict Profiller

HellGuard iki hazır kullanım profiline sahiptir.

Balanced

Normal survival sunucuları için önerilir.

• Daha yüksek tolerans
• Daha düşük yanlış tespit riski
• Normal sprint, PvP ve blok yerleştirme için dengeli eşikler
• İlk kurulum ve genel kullanım için uygun

/hellguard profile balanced

Strict

Rekabetçi veya yüksek güvenlik isteyen sunucular için hazırlanmıştır.

• Daha hızlı müdahale
• Daha düşük ihlal eşikleri
• Sert Scaffold ve combat analizi
• Daha güçlü konteyner ve cevher maskeleme

/hellguard profile strict

Strict profil kullanılmadan önce sunucunun kopyasında test yapılması önerilir.

Temel Komutlar

/hellguard help
/hellguard gui
/hellguard alerts
/hellguard status <oyuncu>
/hellguard reset <oyuncu>
/hellguard exempt <oyuncu> <saniye>
/hellguard checks
/hellguard profile balanced
/hellguard profile strict
/hellguard playerwarnings on
/hellguard playerwarnings off
/hellguard kick <kontrol> <on|off>
/hellguard logs status
/hellguard logs clean expired
/hellguard logs clean all
/hellguard antixray status
/hellguard antixray install balanced
/hellguard antixray install strict
/hellguard config regenerate
/hellguard reload

Yetkiler

hellguard.admin
hellguard.alerts
hellguard.gui
hellguard.bypass
hellguard.containeresp.bypass

hellguard.bypass izni oyuncuyu kontrollerden tamamen muaf tutar. Bu nedenle yalnızca gerçekten gerekli yönetici veya test gruplarına verilmelidir.

Kurulum

1. Sunucuyu tamamen kapatın.
2. HellGuard-AntiCheat-1.4.0.jar dosyasını plugins klasörüne yükleyin.
3. Sunucuyu başlatın.
4. Config ve dil dosyalarının oluşmasını bekleyin.
5. İlk kurulum için şu komutu kullanın:

/hellguard profile balanced

6. Oyuncu uyarılarını açmak isterseniz:

/hellguard playerwarnings on

7. Paper veya Purpur kullanıyorsanız Anti-Xray profilini kurun:

/hellguard antixray install balanced

8. Anti-Xray yapılandırmasından sonra sunucuyu tamamen yeniden başlatın.

Eklenti güncellenirken /reload, PlugMan veya benzeri sıcak yeniden yükleme araçlarının kullanılması önerilmez.

Sistem Gereksinimleri

• Minecraft 1.21.x
• Paper, Purpur, Spigot veya uyumlu sunucu yazılımları
• 1.21.x sunucular için Java 21
• Yeni nesil 26.x sunucular için sunucu yazılımının gerektirdiği güncel Java sürümü

HellGuard sürüme özel NMS veya CraftBukkit sınıflarına bağlı değildir. Bu yapı farklı 1.21.x sürümleri ve güncel sunucu çatalları arasındaki uyumluluğu artırır.

HellGuard Sunucuya Yük Bindirir mi?

HellGuard’ın kontrolleri sürekli bütün dünyayı veya bütün entity’leri tarayacak şekilde tasarlanmamıştır.

Optimizasyon özellikleri:

• Olay tabanlı kontrol sistemi
• Oyuncu başına sınırlı veri saklama
• Düşük TPS sırasında hassas kontrolleri bekletme
• Asenkron ve toplu log yazımı
• Sınırlı Anti-Xray tarama kuyruğu
• Yeni chunk yüklemeyen maskeleme sistemi
• Kontrol bazında açma ve kapatma
• İhlal puanlarının zamanla düşmesi
• Gereksiz tekrar bildirimlerini önleyen cooldown sistemi

Gerçek kaynak tüketimi oyuncu sayısına, aktif kontrol sayısına, Anti-Xray moduna ve sunucudaki diğer eklentilere göre değişebilir.