Rehbere geç

Dokümantasyon 9.6.24

Lisans ve güncelleme

Sunucu lisansını gizli tutun. Ekran görüntülerinden lisans ve token değerlerini kaldırın.

Kimlik bilgileri sunucuda kalsın#

Lisansı ve uzun ömürlü panel anahtarlarını yalnız sunucuda tutun: server.cfg içindeki set ayarları veya configs/anticheat_server.lua. Shared configs/anticheat_config.lua içindeki ts.webPanelKey, ts.Central.token ve ts.licenseLock.licenseKey boş kalır. NUI, istemci olayları ve açık depolar gizli değerler için uygun değildir. Kısa ömürlü ekran görüntüsü/video tokenları yalnız yetkili kanıt yüklemesi içindir; lisans veya paket indirme yetkisi sağlamaz.

Resmî Cfx rehberini okuyun

Eski sürümü güncelleyin ve anahtarları yenileyin#

Eski kaynak dosyalarını 9.6.24 paketiyle değiştirip bakım sırasında güncellenen kaynakları yeniden başlatın. Eski sürümler uzun ömürlü panel anahtarlarını istemcilere aktarmış olabilir. Tüm eski örnekler durduktan sonra ilgili lisansı ve eski panel/API anahtarlarını yöneticiyle birlikte yenileyin; sunucu ayarlarını güncelleyip bağlantıyı doğrulayın. Yalnızca güncellemeyi kurmak geçmişte açığa çıkan anahtarları iptal etmez.

Lisans anahtarı zorunludur#

7 Ekim 2026'dan itibaren indirilen paketlerde anticheat, bu sunucunun lisans anahtarı girilmeden çalışmaz. Anahtar yoksa veya başka bir sunucunun anahtarı girilmişse sunucu oyuncu kabul etmez, çevrimiçi oyuncular düşürülür ve konsolda sebebi yazar.

Anahtarı panelde Sunucular sayfasından alın ve server.cfg içinde ensure satırlarından önce yazın: set tosun_ac_license "SUNUCU_LISANSI". configs/anticheat_server.lua içindeki licenseKey alanı da kullanılabilir. Anahtar sonradan girilirse (geç gelen bir server.cfg satırı veya konsolda set) sunucu yeniden başlatmadan oyunculara açılır.

Lisansı panelde yenilediyseniz eski paket yeni anahtarla eşleşmez; paketi yeniden indirip kurun.

İşleme uygun kimlik bilgisini seçin#

Tosun sunucu lisansı kayıtlı sunucuyu tanımlar; FiveM için kullanılan sv_licenseKey ile aynı değildir. Bileşen API kimlik bilgilerinin kendi yetki kapsamı bulunabilir. Kanıt yükleme kimlik bilgileri kısa ömürlüdür ve yükleme bağlamına bağlıdır. Hepsine anahtar denmesi onları birbirinin yerine kullanılabilir yapmaz; yükleme token’ı panel yönetimi veya veritabanı köprüsü yetkisi vermez.

Sunucular bölümünde ilgili sunucuyu seçip mevcut lisansı server.cfg içine set ile ekleyin. Yer tutucuyu kendi değerinizle değiştirin; örnek metni olduğu gibi bırakmayın. Değeri yalnız sunucuda tutun; NUI, shared/client Lua ve herkese açık depolara koymayın. Köprü aynı sunucu lisansını kullanır; panel işlemleri ayrıca hesabın yetkisini kontrol eder.

set tosun_ac_license "YOUR_SERVER_LICENSE"

Dosyaları güncelleyip çalışan kurulumu doğrulayın#

Güncellemeden önce çalışan resource’u ve düzenlenebilir ayarları saklayın. Doğru sunucunun paketini indirin, entegrasyon notlarını karşılaştırın ve planlı bakımda doğru kurulumu değiştirin. Tek bir etkin kopya bulunduğunu kontrol edin. Yeni dosyalar başka klasörde dururken eski resource’un çalışmaya devam etmesi eski davranışı koruyabilir.

Yerel lisans biçimi veya license-lock kontrolü, aboneliğin ödendiğini gösteren makbuz değildir. API abonelik pasif veya sunucu askıda diyorsa hesabın gerçek durumunu inceleyin. Kimlik doğrulama hatasını korumayı kapatarak gizlemeyin.

  1. Çalışan manifest sürümünü ve başlangıç çıktısını indirdiğiniz paketle karşılaştırın.
  2. Desteklenen ayar değişikliklerinizi taşıyın; özel ışınlama, envanter ve yetkili entegrasyonlarını kontrol edin.
  3. 9.6.14 sürümünden itibaren panel bağlantısı ve çevrimiçi bakiye düzenleme varsayılan olarak açıktır. Eski set tosun_db_bridge_enabled ve set tosun_db_bridge_money_write satırları yok sayılır ve silinebilir; 9.6.14’ten eski paketlerde bu satırlar hâlâ gerekir. Daha önce bağlantıyı veya bakiye düzenlemeyi kapalı tuttuysanız sunucunun Tosun Connect kartındaki “Bağlantıyı kapat” düğmesini ya da server.cfg değerlerinin eskisi gibi uygulandığı manuel modu (set tosun_db_bridge_manual "1") kullanın. Bağlantıyı küçük bir okumayla doğrulayın; personel bakiye düzenlemeden önce normal oyunu test edin.

Sızmış anahtarı eski kopya bırakmadan yenileyin#

Lisans yayımlandıysa veya eski entegrasyon uzun ömürlü anahtarı istemcilere gönderdiyse yalnız yeni dosya yüklemek o değeri iptal etmez. Sunucular bölümündeki lisansı yenilemek eski değeri değiştirir; korunan sunucu ayarını güncelleyip bağlantıyı doğrulayın. Ayrı panel/API anahtarlarının yenilenmesini yöneticiyle birlikte yapın.

Ödeme gecikmişse Faturalandırma bölümünde açık faturayı ve güncel ödeme işlemini inceleyin. Anahtar yenilemek ödeme sorununu çözmez. Sağlayıcı sonucu belirsizse tekrar ödeme yapmadan önce faturanın durumunu doğrulayın. Destek talebine lisans yerine fatura referansını, sunucu kimliğini ve gizli değerlerden temizlenmiş hata mesajını yazın; aynı işlem için art arda yeni anahtar oluşturmayın.

  • Aynı anahtarı kullanan tüm çalışan kopyaları ve entegrasyonları belirleyin; yenilemeden önce eski kopyaları durdurun.
  • Mümkün olduğunca depo geçmişindeki, ekran görüntülerindeki, açık yedeklerdeki ve destek eklerindeki gizli değerleri kaldırın.
  • Güncel anahtarı yalnız gerekli sunucu ayarına koyun; başkalarına göndereceğiniz tanı komutuna eklemeyin.
  • Bağlantı kurulamazsa sunucu ID, saat ve anahtarsız hata kaydı tutun. Yeni anahtar istemeden doğru sunucuyu ve ücretli abonelik durumunu kontrol edin.

Bakım sırasında anahtar yenileme sırası#

Anahtar değişimini küçük bir bakım işlemi gibi yönetin. Önce panelde seçili sunucunun adını ve kimliğini çalışan kurulumla eşleştirin. Konsol hatasının başladığı zamanı not alın, mevcut çalışan dosya sürümünü kaydedin ve erişimi olan kişileri belirleyin. Gecikmiş abonelik, yanlış sunucu seçimi ve dış bağlantı sorunu farklı nedenlerdir; yalnız bağlantı hatası görmek anahtarın sızdığını kanıtlamaz.

Yenileme gerektiğinde Sunucular içindeki seçili kaydın lisans yenileme işlemini kullanın. Aynı sunucu kaydının anahtarı değişir; yeni sunucu ekleyerek kota tüketmeniz gerekmez. Eski değeri kullanan resource ve özel sunucu entegrasyonlarını durdurun, yeni değeri korunan server.cfg içine yazın ve bakım planına göre yeniden başlatın. Uzun ömürlü değeri tarayıcı koduna kopyalamayın.

Yeniden kurulumda doğru sunucuyu koruyun#

Resource’u yeniden yüklemek ile panelde sunucu kaydını silmek aynı işlem değildir. Dosyalar bozulduğunda doğru kaydın paketini yeniden indirin; düzenlenebilir ayarların yedeğini ayrı tutun. Eski klasörü etkin resource yolunun dışında saklayın. İki farklı klasörde aynı resource’u başlatmak hangi ayarın kullanıldığını belirsizleştirir ve tanıyı zorlaştırır.

Yeni paketin manifest sürümünü, bağımlılık sırasını ve yerel ayarlarını karşılaştırın. İlk bağlantıdan sonra seçili sunucunun panel durumunu kontrol edin. Köprü açıksa tek bir küçük okuma isteğiyle yetkiyi doğrulayın; bu kontrol için para düzenlemeyin. Başarılı yeniden kurulum ölçütü doğru kayıt, tek etkin kopya, beklenen sürüm ve normal oyun senaryolarının tamamlanmasıdır.

Gizli değer içermeyen bağlantı arıza kaydı#

Destek için sunucu kimliği, resource sürümü, ilk hata zamanı, son başarılı bağlantı ve değişiklik sırasını birlikte kaydedin. Yetkisiz bağlantı mesajı ile ağ erişim hatasını ayrı aktarın. Konsol çıktısını paylaşmadan lisans, Authorization başlığı, bağlantı dizesi ve kişisel bilgileri temizleyin. Parolalı yedek yerine gerekli kısa hata parçasını gönderin.

Yenilenen anahtarı geri alarak eski sızmış değeri tekrar kullanmayın. Dosya geri dönüşü gerekiyorsa mevcut geçerli anahtarı geri yüklenen ayara taşıyın. Sızıntının kaynağını da düzeltin; yalnız anahtar değiştirip açık depoyu bırakmak aynı sorunu tekrar oluşturur. Bakım sonunda bağlantının kurulduğunu, eski kopyaların çalışmadığını ve gereksiz erişimlerin kaldırıldığını tarihli bir notla doğrulayın.

Makine taşıma sırasında lisans oturumunu okuyun#

Sunucuyu başka makineye taşırken önce eski çalışan kopyayı durdurun. İndirme sayfasındaki lisans oturumlarında parmak izi, son IP, sürüm ve son görülme bilgisini kendi taşıma kaydınızla karşılaştırın. Bu ekran oyuncuların hesap oturumunu değil, lisansın sunucu kurulum oturumlarını gösterir. Yanlış satırı serbest bırakmak başka aktif kurulumu etkileyebilir; sırf tabloda birden fazla kayıt var diye hepsini temizlemeyin. Aynı topluluk için yeni panel sunucusu oluşturmak, eski lisans oturumunu yönetmenin yerine geçmez ve ayrı kota konusu doğurabilir.

Eski makine durduktan sonra ona ait oturumu paneldeki serbest bırakma işlemiyle kaldırabilirsiniz. Çalışan eski kopya sonraki kontrolde yeniden kayıt açabileceğinden önce durdurma adımı önemlidir. Mevcut politikada bağlantı kurmayan aktif oturumlar yaklaşık yirmi dakika sonra yer açabilir; açıkça iptal edilmiş oturumlar otomatik sona ermiş sayılmaz. seat_taken hatasında kalan kullanım ve doğru satırı inceleyin, license_rotated veya abonelik hatasını aynı sorun sanmayın. Yeni makine kabulünü başlangıç çıktısı, yeni oturum ve normal bağlantıyla ayrı doğrulayın.

7 Ekim 2026'dan önce indirilen paketler her lisans kontrolünde farklı bir sunucu parmak izi gönderebiliyordu. Sunucu kendi oturumunu ikinci bir sunucu sanıyor, seat_taken alıyor ve her açılıştan birkaç dakika sonra oyuncu kabul etmeyi bırakıyordu ("Lisans dogrulanamadi"). Lisans servisi bu paketleri 5 Kasım 2026'ya kadar yeniden kabul ediyor: kaynağı bir kez yeniden başlatın, ardından bu tarihten önce düzeltilmiş lisans istemcisi için paketi yeniden indirin.

Build ID ve license_rotated sonucunu birlikte değerlendirin#

İndirme geçmişindeki Build ID dağıtılan paket kaydını bulur; lisans anahtarının kendisi değildir. Dosya adındaki sürüm ve Build ID önekini geçmişteki kayıtla eşleştirin. Farklı bir sunucunun paketi, benzer adla kaydedilmiş olsa da doğru paket olmaz. unknown_build, revoked, license_mismatch ve license_rotated gibi sonuçlar farklı bağ denetimlerini ifade eder; hepsi için tekrar yeni anahtar üretmek tanıyı zorlaştırır. Raporunuzda sonucu aynen saklayın, özel lisansı veya paket içindeki kimlik bilgilerini paylaşmayın.

Önemli örnek: Sunucular ekranında anahtar yenilendiyse önceden dağıtılan paket eski lisans özetiyle bağlı kalır. Yalnız server.cfg değerini değiştirmek bu paket bağını yenilemez; aynı doğru sunucu kaydından güncel paket indirin ve korunan ayarı güncelleyin. Geri dönüşte de eski anahtara bağlı paketi doğrudan çalışır varsaymayın. Build geçmişi izlenebilirlik sağlar, kopyayı şahsen kimin paylaştığını kanıtlamaz. Kabul için doğru yeni paket, mevcut anahtar ve başarılı lisans sonucu birlikte kontrol edilmelidir; ödeme durumunu ayrıca doğrulayın.

Koruma katmanlarının neyi sağladığını bilin#

Tosun paketi için Tebex veya Asset Escrow hesabı gerekmez. FiveM sunucusunun normal Cfx.re sunucu lisansı ayrı bir gereksinimdir. İmza, şifreli saklama ve Lua kodunu okunması zor hale getirme aynı işi yapmaz; hiçbirini kırılamaz kaynak gizliliği olarak değerlendirmeyin.

Sunucudaki AES-256-GCM şifreli paket saklama, depodaki ZIP dosyasını korur. Yetkili kullanıcıya indirilen ve oyun sunucusunda çalıştırılan kaynakların sahibinden gizlenmesini sağlamaz.

Ed25519, lisans yanıtının yetkili sunucudan geldiğini ve doğru istek/paket bağlamına ait olduğunu doğrular. Özel imza anahtarı dağıtılan pakete konmaz. Dosya SHA-256 özetleri değiştirilmiş çekirdek dosyaları tespit etmek içindir; dosyanın içeriğini şifrelemez.

Lua karartması okumayı ve basit kopyalamayı zorlaştırabilir; tersine çevrilebilir. Kendi oyun sunucusunu yöneten kişi yerel dosyaları okuyabilir veya değiştirebilir. Güvenilir yetkilendirme kararlarını sunucu tarafında tutun; paketi veya lisansı paylaşmayın.

Build ID, dağıtım kaydını incelemeye yardımcı olur; bir sızıntıyı kimin yaptığına tek başına kanıt değildir. Ağ kesintisi veya doğrulanmamış cevap, imzalı lisans reddiyle aynı sonuç değildir. Sorun kaydında bu ayrımı koruyun.

Güncellemeyi ve geri dönüşü kontrollü yapın#

İndirme yeni bir paket sağlar; kurulu FiveM kaynağı kendiliğinden güncellenmez. Paket sürümünü, Build ID bilgisini ve seçili sunucu bağını bakım öncesinde kaydedin. Sürüm etiketi aynı kalmış olsa da kaynak içeriği yenilenmiş olabilir; yalnız dosya adına bakarak iki paketi eşit kabul etmeyin.

Güncel paketi aynı sunucu kaydından alın. Geçerli bir önbellek paketi kullanıldığında Build ID değişmeyebilir. İndirme işlemi aboneliği yenilemez ve lisansı otomatik döndürmez.

Korunan çekirdek dosyaları düzenlemek bütünlük kontrolünü bozabilir. Özel entegrasyonlar için paketteki editable alanlarını ve desteklenen export/bridge noktalarını kullanın; imza doğrulayıcısını veya lisans kodunu kapatmayı çözüm saymayın.

Anahtar döndürüldüyse eski anahtara bağlı paketi yalnız yeni server.cfg değeriyle kullanmak yeterli olmayabilir. Geri dönüş planında paket, mevcut lisans bağı ve ayarlar birlikte değerlendirilir.

  1. Mevcut kaynakları, configs, admins, editable, bridge ve kendi dil dosyalarınızı yedekleyin; gizli yedekleri açık web dizinine koymayın.
  2. Bakım penceresinde doğru yeni paketi çıkarın. Eski shared config dosyasını bütünüyle yenisinin üstüne kopyalamayın; normal ayarları karşılaştırarak taşıyın.
  3. Sunucuya özel anahtarları özel ayarda tutun, shared alanların boşluğunu kontrol edin ve bağımlılık sırasını koruyun.
  4. Önce açılışı, sonra normal oyuncu girişini, yetkili menüsünü ve küçük panel okumasını doğrulayın. Test amacıyla gerçek para veya ban işlemi yapmayın.
  5. Başarısızlıkta ilk hata kodunu ve saati kaydedin. license_rotated, revoked, seat_taken ve ağ hatalarını tek bir lisans sorunu gibi değerlendirmeyin.

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"