Skip to main content
Bloga geri dön

Steam Manifest ve Lua Dosyaları Nedir?

Steam .manifest ve Lua dosyalarının ne içerdiği, SteamTools'un neden ikisine de ihtiyaç duyduğu ve ücretsiz oluşturucunun bu çifti nasıl ürettiği.

17 Ağu 2026SteamTools Team
Steam Manifest ve Lua Dosyaları Nedir?

.manifest dosyası, Steam ekosisteminin en az belgelenmiş parçalarından biridir. Steam istemcisinin bir parçası değildir, oyunla birlikte indirilmez ve onu Steam arayüzünde hiçbir zaman görmezsiniz. Ancak SteamTools için vazgeçilmezdir. Bu yazı, bu dosyanın içinde gerçekte ne olduğunun kısa bir özetidir.

Manifest ne işe yarar?

Manifest, Steam'de bir oyunu oluşturan her depoyu (depot) ve SteamTools'un o depo için Steam'in CDN'iyle iletişim kurarken ihtiyaç duyduğu şifrelenmiş anahtarı listeleyen küçücük (genellikle 1–4 KB) bir metin dosyasıdır.

Tek depolu bir uygulama için gerçek bir örnek (alıntı):

"appbuild"
{
  "appid"  "400"
  "name"   "Portal"
  "buildid"  "1234567"
  "depots"
  {
    "400"
    {
      "manifest"  "1234567890abcdef..."
      "size"  "9876543210"
    }
  }
}

Uzun onaltılık (hex) dize depo şifre çözme anahtarıdır. Bu anahtar olmadan SteamTools oyunun hangi parçalarını isteyeceğini bilemez ve Steam'in CDN'i isteği reddeder.

Dosya adı neden önemlidir?

SteamTools, kendi depotcache klasöründe tam olarak <AppID>_<branch>.manifest biçiminde adlandırılmış dosyalar arar. Çalışan bir manifesti 400_public.manifest adından 400-beta.manifest adına değiştirip yanlış dal klasörüne koyarsanız SteamTools kurulumu reddeder — çünkü indeks doğrudan dosya adıdır.

Oluşturucumuzun her zaman dosya adında dal bilgisini içeren bir çift döndürmesinin nedeni budur. Yalnızca varsayılan public dalına ihtiyacınız varsa bu alanı boş bırakın; özellikle beta veya experimental istiyorsanız oluştur düğmesine tıklamadan önce dal adını yazın.

Manifest neden her uygulama ve her dal için ayrıdır?

Her Steam dalı (public, beta, experimental, internal, …) kendi buildid değerini ve kendi şifre çözme anahtarlarını alır. Aynı App ID, etkin her dal için bir tane olmak üzere yarım düzine farklı manifeste sahip olabilir. Yerel olarak birden fazla manifest mevcut olduğunda SteamTools'a hangi dalı tercih edeceğini söyleyen şey Lua betiğidir.

Manifestler ne zaman güncelliğini yitirir?

Manifestler belirli bir derlemeye (build) bağlıdır. Bir oyun güncellendiği anda eski manifest işe yaramaz hale gelir — yeni derlemede yeni dosya parçaları, yeni boyutlar ve (çoğunlukla) yeni anahtarlar vardır. Eski bir manifest ile oyun kurmaya çalışırsanız SteamTools ya yanlış dosyaları indirir ya da işlem ortasında hata verir.

Popüler oyunlar listesinin her beş dakikada bir yenilenmesinin nedeni de budur: oyunlar sürekli yama alır ve çalışan bir kurulumu bozma ihtimali en yüksek olan şey bir hafta öncesinden kalma bir manifest kullanmaktır.

Oluşturucu bir manifest bulamadığında

Üç yaygın nedeni vardır:

  1. App ID yanlıştır. Doğrulamanın en hızlı yolu SteamDB'dir.
  2. Uygulama bölge kilitlidir. Bazı yayıncılar manifestleri belirli mağaza bölgeleriyle sınırlar. Şu anda cc=us&l=english kullanıyoruz; yol haritasında daha fazla bölge ekliyoruz.
  3. Uygulama Steam'den tamamen kaldırılmıştır. Valve zaman zaman bir uygulamayı emekliye ayırır ve depo verilerini siler. App ID hâlâ çözümlenir, ancak indirilecek bir şey kalmamıştır.

Oluşturucu bir hata döndürürse, mesaj genellikle bu üç durumdan hangisiyle karşılaştığınızı söyler. En yaygın hata mesajları için SSS sayfasında bir kontrol listesi bulunmaktadır.


Veri kaynağı: ManifestHub3 — bu oluşturucunun üzerinde çalıştığı açık kaynaklı, MIT lisanslı Steam depo anahtarı önbelleği. İnceleyin, çatallayın veya kendi yansınızı çalıştırın.

Oluşturucuyu deneyin →