Kurulum

1. Sunucuyu hazırlayın#

Desteklenen FiveM artifact sürümünü kullanın ve sunucunuzun OneSync gereksinimlerini inceleyin. Çalışan oxmysql bağlantısını koruyun. tosun-ac klasörünü adını değiştirmeden resources altına çıkarın. Framework ve gerekli bağımlılıkları önce başlatın. Anticheat ilk açılışta kendi tablolarını oluşturmak için yerel veritabanı yetkisine ihtiyaç duyar. Bridge için ayrıca SQL aktarımı gerekmez; eksik tablo sorunu varsa paketteki kurulum SQL dosyasını yalnız yedek aldıktan sonra kullanın.

2. Yalnız sunucuya ait ayarları ekleyin#

Sunucular bölümünden doğru sunucunun lisansını alın. server.cfg içinde kaynaklar başlamadan önce set tosun_ac_license kullanın; zorunlu olan tek satır budur. set tosun_ac_panel_key ve set tosun_ac_central_token isteğe bağlıdır; yalnız bu anahtarları elle belirlemek istiyorsanız ekleyin. setr veya sets kullanmayın. Alternatif sunucu dosyası configs/anticheat_server.lua içindeki credentials tablosudur. Shared/client dosyalarındaki anahtar alanları boş kalmalıdır. Ayrıntılı geçiş ve indirme adımları aşağıdadır. Panel veri bağlantısı (bridge) varsayılan olarak açıktır, bu yüzden örnekte bridge satırı yoktur; eski tosun_db_bridge_enabled ve tosun_db_bridge_money_write satırları yok sayılır, silebilirsiniz.

set tosun_ac_license "YOUR_SERVER_LICENSE"
ensure oxmysql
ensure tosun_render
ensure tosun-ac
ensure tosun-ac-guardian

3. Başlatın ve doğrulayın#

Planlı bakım sırasında oxmysql’i tosun-ac’den önce başlatın. Kaynak sürümünü ve konsoldaki bağımlılık/yetkilendirme hatalarını kontrol edin. Bridge varsayılan olarak açık başlar ve server.cfg içinde ek satır gerektirmez; durumunu aşağıdaki komutla sunucu konsolunda kontrol edin. Destek talebine gerçek anahtar yapıştırmayın. Bridge okuma sonucunu ayrıca doğrulayın: query_timeout SQL’in iptal edildiğini, query_busy ise yeni bir sorgu başlatıldığını göstermez. Veritabanı rehberindeki süre ve kapsam adımlarını izleyin.

tosunac_db_status

Geri dönebileceğiniz bir kurulum hazırlayın#

Çalışan sunucuda değişiklik yapmadan önce artifact sürümünü, framework ve envanter resource adlarını kaydedin. Paketi Sunucular bölümünde doğru sunucuyu seçerek indirin; başka sunucunun paketi veya lisansı yanlış bağlantı kurulmasına yol açabilir. Ücretli aboneliğinizi ve hesabınızın sunucu yönetim yetkisini kontrol edin. İndirdiğiniz ZIP dosyasını herkese açık bir dosya sitesine yüklemeyin.

1. Mevcut tosun-ac klasörünü, düzenlenebilir ayarları ve oyun veritabanını yedekleyin. Değiştirmeden önce yedeğe erişebildiğinizi doğrulayın.
2. Yeni paketi ayrı bir klasöre açın. fxmanifest.lua doğrudan tosun-ac içinde bulunmalı; iç içe ikinci bir tosun-ac klasörü oluşmamalı.
3. Düzenlediğiniz ayarları yeni varsayılanlarla karşılaştırın. Bilinçli değişiklikleri ve entegrasyonları taşıyın; yeni ayar dosyasının tamamını eski dosyayla değiştirmeyin.

• Lisans ve güncelleme

Bağımlılıkları ve gizli ayarları düzenleyin#

oxmysql ile çalışan mevcut oyun veritabanı bağlantınızı koruyun. Panel veritabanı köprüsü ve çevrimiçi bakiye düzenleme varsayılan olarak açıktır; bu yüzden örnekte köprü satırı yoktur. Eski tosun_db_bridge_enabled ve tosun_db_bridge_money_write satırları yok sayılır, silebilirsiniz. Framework ve envanterinizin mevcut başlatma satırlarını kendi bağımlılık sıralarında ekleyin. Bir örneği uygulamak için aynı anda çakışan framework sürümlerini başlatmayın. Lisans için set kullanılır; setr değeri istemcilere aktarır, sets sunucu bilgisi olarak yayımlar.

Resource kendi tabloları için veritabanı erişimine ihtiyaç duyar. İlk çalıştırmadaki tablo hazırlığı köprüden ayrı bir iştir. Köprüyü bir sunucu için kapatmak isterseniz Panel → Sunucular → sunucu → Tosun Connect → Bağlantıyı kapat yolunu kullanın. Elle yönetmek için set tosun_db_bridge_manual "1" ekleyin; bu durumda tosun_db_bridge_enabled ve tosun_db_bridge_money_write server.cfg dosyasından okunur ve her biri "1" yapılmadıkça kapalıdır. Dolu veritabanına kontrol etmeden SQL aktarmayın. Veritabanı parolasını veya Tosun lisansını shared/client Lua dosyasına koymayın. Planlı bakım zamanı kullanın: ensure komutu zaten çalışan resource’u yeniden başlatabilir.

set tosun_ac_license "YOUR_SERVER_LICENSE"

ensure oxmysql
# Mevcut framework ve envanterinizi burada başlatın.
ensure tosun-ac

• Resmî sunucu komutları
• Veritabanı köprüsü

Sunucuyu açmadan normal oyunu doğrulayın#

Resource’un çalışıyor olması bütün entegrasyonların doğru olduğunu tek başına göstermez. Manifest sürümünü, başlangıç çıktısını ve bağlantı durumunu inceleyin; ardından test hesabıyla bağlanın. Aşağıdaki tanı komutlarını sunucu konsolunda çalıştırın. Köprü varsayılan olarak açıktır; disabled durumu yalnız tosun_db_bridge_enabled "1" olmadan elle yönetim modunda veya eski panel aynalaması açıkken beklenir. Ayar doktoru, ayarlar uygulandıktan sonra riskli değerleri bildirir; ayarları kendisi değiştirmez.

Kısa bir kabul kaydı tutun: paket sürümü, test saati, kontrol eden yönetici ve denenen oyun akışları. Yalnız özel bir script hata veriyorsa aynı işlemi test oyuncusuyla tekrar üretin ve resource adını kaydedin. Bütün oyunculara geniş muafiyet vermeden veya sunucu genelindeki cezaları artırmadan önce ilgili entegrasyonu inceleyin.

• Karakter seçimi, doğma, hastanede canlandırma, ev girişi ve garaj çıkışı beklenmeyen ceza üretmeden çalışmalı.
• Envanterdeki normal silah, polis ekipmanı ve arena silahı uygun kontrol veya dar kapsamlı izinle çalışmalı.
• Emote objeleri, telefon menüleri ve yetkili işlemleri sorunsuz kullanılmalı; kayıtlarda entegrasyon isteyen resource ayırt edilmeli.
• Başlangıç başarısızsa ilk ilgili hatayı ve kurulu sürümü kaydedin. Gerekirse yedek resource’a dönün; destek için paylaşmadan önce anahtarları silin.

tosunac_integration
tosunac_doctor
tosunac_db_status

• Özel script entegrasyonu
• Ayarlar ve performans

İki paketi karıştırmadan tek resource güncelleyin#

Güncellemeyi, öncesi ve sonrası belli olan küçük bir değişiklik olarak ele alın. Mevcut export çağrıları ve yardımcı dosya yolları aynı resource’a ulaşsın diye klasör adı tosun-ac olarak kalsın. configs/anticheat_config.lua, configs/anticheat_webhooks.lua ve düzenlenebilir entegrasyonlarınızı yeni paketle karşılaştırıp yalnız bilinçli ayarlarınızı taşıyın. Sunucuya özel convar’ları ve incelenmiş güven listesi kayıtlarını koruyun. 9.6.14’ten itibaren server.cfg içindeki tosun_db_bridge_enabled ve tosun_db_bridge_money_write satırları yok sayılır; güncellemeden sonra köprü ve yönetici ile sahip rolündeki panel kullanıcıları için çevrimiçi bakiye düzenleme açık olur. Köprünün kapalı kalmasını istiyorsanız sunucunun Tosun Connect kartında Bağlantıyı kapat düğmesini kullanın veya set tosun_db_bridge_manual "1" ekleyin; bu durumda o satırlar yeniden geçerli olur ve her biri "1" yapılmadıkça kapalıdır. Eski ayar dosyasında yeni varsayılanlar eksik olabilir; eski klasörün tamamını kopyalamak ise eski modülleri yeni dosyaların yanında bırakabilir. Başlatma sırası hâlâ oxmysql ve ilgili core’u tosun-ac’den önce, export kullanan entegrasyonları da ondan sonra yüklemelidir.

1. Planlanan değişiklik sırasında yeni girişleri kapatın; ilk başlatma çıktısını, kurulu sürümü ve değiştirdiğiniz ayarları kaydedin.
2. Tek etkin tosun-ac klasörü kullanın; yedeği yanlışlıkla başlatmamak için etkin resources ağacının dışında tutun.
3. Yeniden başlatmadan sonra normal test oyuncusunu tekrar bağlayın; önceki oturumu sürdüren istemci temiz bir kabul testi sayılmaz.

Belirtiye göre doğru teşhis yolunu seçin#

Birkaç korumayı birlikte değiştirmek yerine ilk somut hatadan başlayın. Resource hiç başlamıyorsa klasör yapısını, manifest’i ve eksik bağımlılık hatasını inceleyin. Başlıyor fakat panele bağlanamıyorsa oyun içi bir kuralı araştırmadan önce seçilen sunucuyu, lisansı ve bağlantı durumunu kontrol edin. Launcher’ın giriş reddi ayrı bir kapıdır; kendi durum kaydı üzerinden araştırılmalıdır. Yalnız bir ev, arena veya kıyafet script’i sorun çıkarıyorsa resource adını ve yapılan işlemi kaydedip entegrasyon reddi çıktısını inceleyin. Yetkili hesap muaf olabilir; o hesapla başarılı test yapılması, normal oyuncunun da doğru işlendiğini göstermez.

1. En küçük başarısız işlemi normal bir test karakteriyle bir kez tekrarlayıp konsol veya panel sonucunu aynen not edin.
2. Aynı işlemi son çalışan ayarla karşılaştırın; sorumlu bağımlılık ya da entegrasyonu düzeltip yalnız bu testi yeniden uygulayın.
3. Raporu özel anahtarlardan arındırın. Tek belirtiyi yok etmek için güven denetimini veya bütün tespitleri kapatmayın.

Bilinen çalışan duruma dönüp yeniden doğrulayın#

Geri dönüşü güncelleme penceresinden önce planlayın. Eşleşen resource ve ayar yedeğini, eski başlatma sırasını ve bilinçli convar değişikliklerinin kaydını saklayın. Yeni sürüm normal bağlantıyı veya gerekli bir iş akışını engelliyorsa bakım sırasında bilinen pakete dönüp onu yeniden doğrulayın. Lua dosyalarını geri almak para değişikliğini geri çevirmez, panel işini silmez veya veritabanını eski hâline getirmez. Kurulum onarımı amacıyla AC tablolarını düşürmeyin; ban ve tespit geçmişini temizlemeyin. Veritabanında değişiklik varsa, yedekten sonra oluşan kayıtları da hesaba katan ayrı geri yükleme planını veritabanı sorumlusu değerlendirmelidir.

1. Önce yalnız etkilenen resource ve ayarları geri yükleyin; başlangıcı, normal oyuncu girişini ve önce başarısız olan işlemi kontrol edin.
2. Bakiye düzenleme varsayılan olarak açıktır. Geri dönen kurulum ve sonucu belirsiz bakiye işlemleri incelenene kadar sunucunun Tosun Connect kartından bağlantıyı kapatın; bir düzenlemeyi yeniden göndermeden önce oyun içindeki bakiyeyi kontrol edin. İnceleme bitince aynı karttan Bağlantıyı aç ile yeniden açın. 9.6.14’ten eski bir pakete dönerseniz eski davranış geçerlidir: server.cfg satırları yoksa köprü kapalı kalır.
3. Neyi neden geri aldığınızı kaydedin; sonraki güncelleme aynı geniş değişiklikleri tekrarlamak yerine yeniden üretilebilen sebebi çözsün.

ZIP açıldığında dosya yerleşimini denetleyin#

İndirilen arşivi önce ayrı bir çalışma klasöründe açın. İç içe tosun-ac/tosun-ac gibi iki seviye oluşmadığını, resource kökünde fxmanifest.lua bulunduğunu ve paketin varsa ayrı tosun-ac-guardian klasörünü koruduğunu kontrol edin. Dosyaları yalnız uzantısına göre düz bir klasöre taşımayın: manifest client, shared, configs, editable, server ve html yollarına göre yükler. Bir yapılandırma dosyası sunucuya kopyalanmış olsa bile beklenen yolunda değilse çalışma sırasında kullanılmayabilir. Sunucuyu yeniden başlatmadan önce bu farkı bulmak daha kolaydır.

Örneğin @oxmysql/lib/MySQL.lua hatası, lisans değiştirme gerekçesi değil bağımlılık kontrolüdür. Eksik html/index.html hatasında NUI dosyalarını ve dizin yapısını inceleyin. Hangi dosyanın eksik olduğunu kaydedip doğru paketten tamamlayın; başka sürümün tek modülünü rastgele eklemeyin. İsteğe bağlı INSTALL.sql varsa mevcut şemayla inceleyin ve yedek olmadan uygulamayın. Test için çalıştıracağınız dizini açıkça seçin; indirdiğiniz ZIP, hazırladığınız klasör ve etkin resource aynı kurulum zincirini göstermelidir. Başlangıç çıktısındaki ilk hata, sonraki birikmiş mesajlardan daha yararlı olabilir.

Sırların hangi tarafta yüklendiğini kontrol edin#

Dosya adı tek başına hangi bilgilerin oyuncuya ulaşacağını göstermez. Manifestte shared_scripts altında bulunan configs/anticheat_config.lua hem sunucu hem istemci tarafında yüklenir. Bu nedenle lisansı, özel API anahtarını veya veritabanı parolasını kolay görünsün diye bu tabloya eklemeyin. client dosyaları ve html/NUI içeriği de gizli saklama alanı değildir. Yapılandırmanın kaynak kodu okunabilir bırakılmış olması, bütün ayarların içine sır konabileceği anlamına gelmez; düzenlenebilir ayarlar ile sunucuya özel kimlik bilgilerini ayrı değerlendirin.

Kurulum sonrası kendi değiştirdiğiniz dosyalarda sırların konumunu inceleyin. Lisans yalnız korunan server.cfg içinde sunucuya özel set ile tutulmalıdır; setr ve sets kullanmayın. Webhook için paketin sunucu tarafındaki configs/anticheat_webhooks.lua yolunu kullanın, ancak ekran görüntüsünde adresi maskeleyin. Bir değer yanlışlıkla public/client alana girdiyse yalnız dosyadan silinmiş olması önceki dağıtımı geri çekmez; ilgili kimlik bilgisini yenileme gereğini değerlendirin. Kabul notuna gerçek değeri değil, doğru dosya ve yükleme tarafının kontrol edildiğini yazın.

Açılışı küçük kabul kapılarıyla ilerletin#

Bakım oturumunu dört aşamada ilerletin: mevcut veritabanı bağlantısı ve core, AC başlangıcı, normal oyuncu akışı, varsayılan olarak açık olan panel köprüsü. Her aşamanın sonucu görülmeden bir sonrakini açmayın. İlk aşamada zaten çalışan framework ve envanterin kendi normal işlevini kontrol edin; başka bir core ekleyerek sorunu gizlemeyin. İkinci aşamada aktif tosun-ac çıktısı ile kurulu paketi eşleştirin. Üçüncü aşamada yetkili hesabın muafiyetinden etkilenmeyen normal test karakteri kullanın. Yönetici ve sahip rolündeki panel kullanıcıları için çevrimiçi bakiye düzenleme de varsayılan olarak açıktır; köprüyü bir okumayla denemek için bakiye değiştirmeniz gerekmez.

Her kapı için saat, beklenen sonuç ve gözlenen sonucu tek satırda kaydedin. Örneğin karakter seçimi başarılı, garaj çıkışı başarısızsa bütün kurulumu tekrar indirmek yerine ilk bozulan akışa dönün. Oyunun normal çalışması ile köprü üzerinden bir okumanın tamamlanması ayrı kabul sonuçlarıdır. Bir mesajı geçici bastırmak, önceki kapıyı başarılı yapmaz. Gerekli bağımlılık hazır değilse bakım ilerlemesini durdurup ilgili sorunu çözün; bütün kapılar doğrulanınca normal kullanıma geçin. Böylece hangi adımın çalıştığı ve hangisinin hâlâ beklediği belli kalır.

Konsol mesajını sonucu ile birlikte yorumlayın#

Başlangıçta her renkli mesaj aynı anlama gelmez. Silah/envanter kontrolünün desteklenen envanter yok diye beklemesi, oyuncunun hile yaptığına dair tespit değildir; ilgili provider ve core durumunu araştırın. GetSelectedPedWeapon yok mesajı eldeki silahı inceleyen döngünün gerekli native olmadan başlayamadığını söyler, diğer modüllerin de kapalı olduğunu göstermez. Integration çıktısındaki enforce ve trusted bilgileri çağıran politikasını tanımlar; tek başına bir oyun akışının doğru olduğunu kanıtlamaz. İncelemeye mesajın tam metniyle başlayın, yalnız rengine güvenmeyin.

Köprüde Connected mesajı sağlık bağlantısını bildirir; karakter sorgusunun tamamlandığı ayrıca görülmelidir. Waiting: oxmysql_unavailable bağımlılık kontrolüne, Panel unavailable or not authorized ise bağlantı veya yetkilendirme araştırmasına yönlendirir. Bu son mesajdan kesin olarak lisansın bozuk olduğu sonucunu çıkarmayın. Köprü varsayılan olarak açıktır; durum komutundaki enabled=false yalnız tosun_db_bridge_enabled "1" olmadan elle yönetim modunda veya eski panel aynalaması açıkken beklenir. Bağlantı Tosun Connect kartından kapatıldıysa durum komutu yine enabled=true gösterir ve panel sunucunun isteklerini reddeder; son panel durumunda yalnız Panel unavailable or not authorized görünebilir. Bu mesajı görürseniz önce sunucunun Tosun Connect kartında bağlantının açık olduğunu, ardından lisansı ve ağ bağlantısını kontrol edin. Destek notunda mesajın öncesindeki ilk hata, resource adı, saat ve o anda yaptığınız işlemi birlikte saklayın. Bir başlangıç uyarısını oyuncu banı gibi raporlamamak teşhisi daha anlaşılır kılar.

Doğru sunucu için oturumla paket indirin#

İndirme, ücretli planın indirme hakkı ve seçili sunucuyu yönetme yetkisi bulunan panel hesabınızla yapılır. Sunucunun adı, lisansı ve paket kaydı birbirinden farklı bilgiler olduğu için önce doğru kaydı seçin. Bir bağlantıyı veya lisans anahtarını paylaşmak başka kişiye güvenli indirme yetkisi vermez.

Panelde hesabınıza giriş yapın ve hesabınızda gerekiyorsa iki aşamalı doğrulamayı tamamlayın. Sunucular ve İndirmeler ekranlarında aynı sunucuyu seçtiğinizi kontrol edin. Ücretli hizmetin açık olması, başka bir sunucunun paketini kullanabileceğiniz anlamına gelmez.

İndir düğmesi oturum, kullanıcı, kuruluş ve seçili sunucuya bağlı 90 saniyelik tek kullanımlık bilet oluşturur. Bilet bir kez kullanıldıktan sonra aynı POST tekrar indirme yapmaz. Bilet hazır olduktan sonra sunucu lisansı, paket kaynakları veya dağıtım koşulları değişirse yeni bir bilet alın.

ZIP dosyasını önce kendi bilgisayarınıza indirin ve kontrollü biçimde oyun sunucusuna aktarın. Paketi indirmek, çalışan FiveM kaynağını otomatik değiştirmez. JavaScript kapalıysa formun açtığı sayfadaki Paketi indir düğmesini kullanın; eski formu yeniden gönderme uyarısını onaylamak yerine İndirmeler ekranına dönün.

1. İndirmeler ekranını açın; doğru sunucu kaydını ve indirme hakkını doğrulayın.
2. İndir düğmesine bir kez basın ve oluşan ZIP dosyasının tamamlandığını kontrol edin.
3. Süresi dolmuş veya kullanılmış bilette sayfayı yenileyip yeni bilet oluşturun; bilet veya oturum çerezini bir kurulum betiğine kaydetmeyin.
4. Giriş/yetki hatasında önce panel oturumunu ve sunucu yönetme iznini kontrol edin. Dağıtım geçici olarak hazır değilse aynı isteği otomatik döngüde tekrarlamayın.
5. Lisans anahtarı URL, Bearer veya X-License-Key ile paket indirme yetkisi sağlamaz. Panel parolasını otomatik güncelleme betiğine yazmayın.
6. Dosya adı, kaynak sürümü ve Build ID kaydını bakım notuna ekleyin; ZIP dosyasını veya içindeki kimlik bilgilerini destek mesajına eklemeyin.

Shared ayarlardan sunucuya özel kimlik bilgilerine geçiş#

Genel panel adresi ve normal oyun ayarları shared config içinde kalabilir; uzun ömürlü anahtarlar kalmamalıdır. Yeni pakette sunucuya özel configs/anticheat_server.lua dosyası, anahtarları sunucu tarafında yükler. Anahtarları server.cfg içindeki set ayarlarıyla veya bu dosyanın credentials tablosunda tutun. Aynı değeri birden fazla yere yazmak, ileride hangi değerin kullanıldığını karıştırır.

Öncelik, boş olmayan sunucu convar değeri, sunucu dosyasındaki değer ve geçici eski shared değerdir. Eski shared alanlar yalnız sunucu tarafındaki geçiş uyumluluğu içindir; onları doldurmak yeni kurulum yolu değildir. Geçiş uyarısı görülüyorsa anahtarı sunucu ayarına taşıyıp shared alanı boşaltın.

configs/anticheat_server.lua içindeki credentials.panelKey, credentials.centralToken ve credentials.licenseKey alanları düzenlenebilir. Panel bağlantınızın kullandığı anahtarı girin; kullanmadığınız merkezi bağlantıyı boş bırakın. Sunucu convar değerini de girerseniz boş olmayan convar dosyadaki değerin önüne geçer.

Önceden oyunculara veya açık bir depoya gönderilmiş anahtar, dosyadan silindiğinde kendiliğinden iptal olmaz. Eski kopyaları durdurun, ilgili anahtarı yetkili panel ekranında yenileyin ve yeni değeri yalnız sunucuya yerleştirin. Sunucu dosyalarını yedeklerken özel erişim izinlerini koruyun.

1. Anahtarları yerleştirmeden önce server.cfg ve düzenlenebilir ayarların özel yedeğini alın.
2. Aşağıdaki örnekteki yer tutucuları kendi değerlerinizle değiştirin; setr ve sets gizli değerler için kullanılmaz.
3. ts.webPanelKey, ts.Central.token ve ts.licenseLock.licenseKey shared dosyada boş kalsın. İstemciye özel kopya oluşturmayın.
4. Bakım sırasında kaynakları yeniden başlatın; doğru sürüm, lisans sonucu ve panel bağlantısını ayrı ayrı kontrol edin.
5. Destek kaydına gizli değer yerine saat, kaynak sürümü, Build ID ve anahtar içermeyen hata kodunu yazın.

set tosun_ac_license "YOUR_SERVER_LICENSE"
set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
# Optional: only configure a central connection you use.
set tosun_ac_central_token "YOUR_FIVEM_CENTRAL_TOKEN"
ensure oxmysql
ensure tosun_render
ensure tosun-ac
ensure tosun-ac-guardian

Guardian başlangıç ve durdurma teşhisi#

txAdmin sunucu konsolunda önce tosunac_doctor, ardından tosunac_guardian_status çalıştırın. ready hedef kaynağın başladığını; waiting_dependency bağımlılığın eksik olduğunu; transition başlama/durma işleminin sürdüğünü; held bilinçli geçici beklemeyi gösterir. Bunlar oyun içi korumaların veya SQL şemasının başarıyla test edildiği anlamına gelmez.

Önce oxmysql ve tosun_render çalışmalı; sonra tosun-ac, son olarak tosun-ac-guardian başlatılmalıdır. Lisans veya sürüm kaynaklı durdurmada nedeni düzeltip resume kullanın. Pause en fazla 30 dakika sürer ve yalnız konsoldan verilir. Guardian eksik/başlayan/duran kaynaklara sürekli ensure göndermez; başarısız girişimleri artan beklemeyle sınırlar.

# txAdmin server console:
tosunac_doctor
tosunac_guardian_status

# Pause only during planned maintenance; repair the reported cause first:
tosunac_guardian_pause 300
tosunac_guardian_resume

Bağımlılıklardan sonra event keşfini kontrol edin#

EventScanner varsayılan olarak 30 saniye sonra başlar, saatte bir çalışır; sunucu konsolundan tosunac_eventscan ile elle başlatılır. tosunac_setup ayrı bir bakım işlemidir: tamamlanmış backdoor ve imza denetimlerini, aynı güncel dosya parmak izini bekleyip uygun temiz ve çalışan resource’ları baseline’a alır. Sunucuda hiç backdoor bulunmadığının belgesi değildir. İncelenmiş kurulumda, yedekle çalışın. Event keşfi izin doğrulayıcısı kaydetmez, ham handler’ı değiştirmez veya oyuncuya yetki vermez.

# txAdmin server console: event discovery only
tosunac_eventscan

Değişmeyen tarama önbelleği neleri atlar?#

Resource ve analiz politikası değişmediyse önceki analiz sonucu kullanılır; dosyaların içerik parmak izi yine kontrol edilir. Bu, sıfır disk işlemi demek değildir. İçerik veya politika değişince sonuç yeniden analiz edilir. Backdoor denetimi 25 saniye sonra başlayıp 30 dakikada bir, resource denetimi 20 saniye sonra başlayıp 90 saniyede bir, event keşfi 30 saniye sonra başlayıp saatte bir çalışır. signatureScanFirstRun açıksa eski ilk-çalışma işareti olan kurulumda da başlangıç kontrolü yapılır. Kısmi, okunamayan, desteklenmeyen glob veya yalnız escrow içeren tarama tam temiz sonuç değildir; otomatik baseline onayı için kullanılamaz.

-- Edit the existing configs/anticheat_config.lua tables.
ts.EnforceExportCallerWhitelist = true
ts.EventScanner.autoProtect = false
-- 0 disables only the periodic event scan, not initial/manual discovery.
-- ts.EventScanner.scanIntervalMs = 0

Entegrasyonu normal oyuncuyla kabul edin#

Personel veya oyuncu-whitelist muafiyeti olmayan hesapla test edin. Karakter seçimi, görünüm değiştirme, revive, doğrulanmış ev ışınlaması, garaj çıkışı ve özel ödülü bir kez deneyin. Sonra iptal, bağlantı kesilmesi, AC yeniden başlatma ve yetkisiz isteğin reddini kontrol edin. Export dönüşünü ve uygulamanın işlem makbuzunu ayrı inceleyin. Meşru kamera/hareket geçişinin silah veya event denetimini kapatmadığını doğrulayın. Hassas sunucu işleri güvenilir export kullanmalıdır; yerel istemci geçişi bütün doğrudan imzalı tespitlerin duracağı sözü değildir. Sürüm, resource adı, beklenen ve görülen sonucu anahtar/şifre olmadan kaydedin.

Lisansı panelden alıp doğru sunucuya yerleştirin#

TosunDev hesabınızda Sunucular bölümünü açın, kuracağınız FiveM sunucusunu seçin ve bu kaydın Tosun AC lisansını kopyalayın. tac_live_ ile başlayan Tosun lisansı; Cfx.re server license, sv_licenseKey, Discord bot tokeni veya web panel API anahtarı değildir. Başka sunucunun anahtarını kullanmayın.

1. server.cfg dosyasında tosun_ac_license satırının tırnakları arasına kendi Tosun lisansınızı yazın; YOUR_SERVER_LICENSE metnini olduğu gibi bırakmayın.
2. Satırı ensure tosun-ac satırından önce koyun. Yalnız set kullanın; setr ve sets kullanmayın.
3. Dosyayla yapılandırıyorsanız yalnız configs/anticheat_server.lua içindeki credentials.licenseKey alanını doldurun. Boş olmayan server.cfg değeri dosyadaki değerin önüne geçer.
4. Lisansı bir ekran görüntüsünde, Discord mesajında veya oyunculara giden shared config içinde paylaşmayın. Panel anahtarı ve merkezi token varsa kendi ayrı alanlarına yazılır.

set tosun_ac_license "YOUR_SERVER_LICENSE"
# Alternative: configs/anticheat_server.lua
# credentials.licenseKey = "YOUR_SERVER_LICENSE"

ZIP dosyasından txAdmin başlangıcına#

Arşivdeki tosun-ac, tosun-ac-guardian ve tosun_render klasörlerini resources içindeki aynı seviyeye taşıyın. Her klasörün kökünde kendi fxmanifest.lua dosyası bulunur. discord-bot klasörü FiveM resource değildir; ensure discord-bot yazılmaz. Yeni paket Render için yalnız gta5 oyun tanımı kullanır; eski common + gta5 manifestini yeni pakete taşımayın.

1. Oyun veritabanının çalışan mysql_connection_string satırını koruyun. oxmysql, mevcut framework ve envanter önce; tosun_render, tosun-ac ve guardian sonra başlatılır.
2. txAdmin konsolunda refresh çalıştırın, ardından aşağıdaki sıralamayı uygulayın. tosun-render takma adı desteklense de klasör ve belgelerdeki kanonik ad tosun_render olarak kalır.
3. tosun_render_status komutu started ve mevcut dosya durumunu göstermelidir. Bu sonuç oyun içi video çekiminin testi yerine geçmez; bir test oyuncusuyla görüntüyü ayrıca kontrol edin.
4. İlk hata satırını okuyun: missing dependency için bağımlılığı, could not find resource için klasörü, lisans hatası için seçili sunucuyu kontrol edin. Her hatayı lisans değiştirerek çözmeye çalışmayın.

set tosun_ac_license "YOUR_SERVER_LICENSE"

ensure oxmysql
# Start your existing framework/inventory here.
ensure tosun_render
ensure tosun-ac
ensure tosun-ac-guardian

# txAdmin console:
tosun_render_status
tosunac_doctor
tosunac_db_check
tosunac_db_status

Yeniden başlatmada gereksiz taramayı azaltma#

Her açılışta kaynakların içerik SHA256 özeti kontrol edilir. Dosyası ve tarama politikası değişmeyen kaynaklarda pahalı imza ve olay analizi yeniden yapılmaz; sunucu KVP alanındaki doğrulanmış önbellek kullanılır. Dosya, istisna veya tarama kuralı değişirse ilgili analiz yenilenir. Bu kontrol sıfır disk erişimi veya sabit bir resmon değeri vaat etmez.

1. KVP önbelleğini normal güncellemede silmeyin; bozulmuş veya doğrulanamayan kayıt yeniden analiz edilir.
2. Başlangıç kataloğu Lua/JS dosyalarındaki açıkça yazılmış olay adlarını toplar; dinamik olaylar, okunamayan/escrow dosyaları ve DLL dosyaları tam taranmış sayılmaz.
3. Manuel otomatik kurulum güvenlik analizinin tamamlanmasını bekler. Eksik, şüpheli, değişmiş veya zaman aşımına uğramış kaynak kendiliğinden onaylanmaz.
4. Güncellemeden sonra önce test sunucusunda bir oyuncuyla giriş, normal oyun ve yönetici işlemlerini kontrol edin; resmon ölçümünü oyuncu sayısı ve framework yüküyle birlikte değerlendirin.