fxmanifest'te escrow_ignore: config.lua ve dilleri açık tutun

Betikleri satarsınız ve alıcıların temel kodunuza dokunmadan yapılandırmayı, dil dosyasını veya framework köprüsünü değiştirmesi gerekir. Cfx.re varlık escrow varsayılan olarak Lua'yı şifreler, bu nedenle alıcıların düzenlemesi gereken dosyalar açık olarak işaretlenmelidir. İşte escrow_ignore ne yapar ve bu rehber bunu kullanmayı ve sonucu test etmeyi kapsamaktadır.

#Escrow'un neyi şifrelediği

Bir kaynağı escrow sistemine yükledikçinizde, istemci ve sunucu Lua betikleri şifrelenir. Alıcılar bunları çalıştırırlar, ancak okunamazlar. NUI sayfaları, görüntüler, ses, modeller ve stream/ varlıkları gibi Lua kod olmayan dosyalar olduğu gibi teslim edilir.

Alıcının yapılandırması gereken her şey okunabilir kalmalıdır. config.lua dosyasını şifrelerseniz, kimse fiyatlarınızı veya anahtarlarınızı değiştiremez. Bu nedenle escrow'dan bunu atlamasını istersiniz.

#escrow_ignore sözdizimi

fxmanifest.lua dosyasında:

fx_version 'cerulean'
game 'gta5'

shared_script 'config.lua'
client_script 'client/main.lua'
server_script 'server/main.lua'

escrow_ignore {
    'config.lua',
    'locales/*.lua',
    'bridge/*.lua',
}

Yollar kaynak klasörüne göre bağımsızdır ve * bir wildcard olarak çalışır, bu nedenle locales/*.lua locales/ içindeki her Lua dosyasını açık bırakır. Tekil dosyaları da listeleyebilirsiniz.

#Neyin okunabilir kaldığı

Açık bıraktığınız şeyin dikkatli olun. İyi adaylar:

• config.lua: fiyatlar, işler, öğe adları, anahtar tuşları, özellik göstergeler.
• Yerel dil dosyaları: alıcılar çevirisi yapabilsin diye. Bkz. çevrilebilir betikler.
• Framework köprü dosyaları: ESX, QBCore ve QBox için küçük adaptörler, alıcılar kendi framework'lerini veya özel envanterlerini bağlayabilsinler.
• İstemci taraflı bağlantılar diğer betikler için, örneğin bir bildirim veya polis uyarısı tetikleyen bir dosya.

Ürünün çekirdeği olan her şeyi kapalı tutun: mantık, doğrulama, parayı veya öğeleri kararlaştıran her şey. Açık dosyaların kopyalanmak için de açık olduğunu unutmayın: bir alıcı yapılandırmanızı veya köprünüzü başka birinin kaynağına yapıştırabilir, bu nedenle değerli mantığı bunlara koymayın.

İpucu: her açık dosya bir destek yüküdür. Kötü düzenleyen bir alıcı size yazacak, bu nedenle açık dosyaları küçük ve iyi yorumlanmış tutun.

#Cfx.re portalına yükleyin

Escrow hesabınız üzerinden çalışır:

1. Geçerli bir fxmanifest.lua dosyası olan kaynak klasörünü hazırlayın (eski bir __resource.lua değil; bkz. fxmanifest vs resource.lua).
2. Cfx.re portalında varlık bölümünü açın ve kaynağı escrow varlığı olarak yükleyin. Portal escrow_ignore içinde olmayan dosyaları şifreler ve geri kalanını okunabilir tutar.
3. Varlığı mağazanızla ilişkilendirin, böylece bir satın alma alıcıya erişim sağlar. Mağaza tarafı için FiveM betikleri satma bölümüne bakın.

Portalın menüleri zaman zaman değişir, bu nedenle tam yükleme adımları ve sınırlar için geçerli Cfx.re belgelerine uyun.

#Escrow yapıyı test edin

Sadece geliştirme klasörünüzde test ettiğiniz şeyi göndererek yayınlamayın. Yüklemeden sonra:

1. Escrow sürümünü portaldan geri indirin, alıcının aldığı şekilde.
2. Bunu, hesabınızla bağlantılı kendi lisans anahtarını kullanan temiz bir test sunucusuna koyun.
3. Başlatın ve akışta yürüyün: açık dosyalar yüklensin, konfigürasyonun değişiklikleri uygulanır, hem istemci hem de sunucu olayları tetiklensin.
4. config.lua dosyasında bir değer değiştirin ve açık dosyanın gerçekten seçildiğini onaylamak için yeniden başlatın.
5. Birden fazla framework destekliyorsanız ikinci bir framework üzerinde test edin.

Kaynak hak mesajıyla başlayamazsa, test sunucusu varlığa sahip olan hesabın anahtarını kullanmıyor demektir. Escrow hak eksikliği nedenleri listeler.

#Açık dosyalara bağlantılar

Bazı dosyalar açık ve geri kalanlar şifreli olduğunda, hala bir kaynağı paylaşırlar ve birlikte çalışmalıdırlar:

• Açık dosyalar bildirdikleri global'leri ve işlevleri kullanabilirler, normalde olduğu gibi. Sadece bir Config tablosu tanımlayan bir config.lua saklayın ve şifreli kod Config değerini okusun.
• Yükleme sırası manifest sırası olur. Yapılandırma bunu okuyan kodun öncesine gelmeli, bu nedenle yukarıdaki gibi ilk olarak bir shared_script olarak listeleyin.
• Kodunuz ile bir alıcının kendi kaynağı arasında iletişim kurmak için exports kullanın paylaşılan global'lere güvenmek yerine. Exports stabil ve belgelenir; bkz. Lua'da exports.
• Bağımlılıkları bildirin (dependency 'ox_lib') manifest'te, böylece eksik bir kitaplık açık bir hata verir.

Aynı sürümde değiştirdiğiniz şifreli bir dosyayla birlikte yalnızca çalışan bir dosyayı açmayın. Açık olanı düzenleyen alıcılar el ile birleştirmek zorunda kalacaklardır.

#Yaygın sorunlar

• Yeni bir dosya eklendi, ancak yine de şifreli: escrow_ignore tarafından eşleşmedi. Yolu ve wildcard'ı kontrol edin.
• Alıcılar yapılandırmanın okunamaz olduğunu söylüyor: dosya yükleme sırasında şifreli idi. Manifest'i düzeltin ve yeniden yükleyin.
• Sizin için çalışır, alıcı için değil: açık geliştirme kopyasını test ettiniz; indirilen escrow yapısını test edin.

#Kontrol Listesi