ManifestHub3, SteamTools.games'e Nasıl Güç Veriyor?
Ücretsiz manifest ve Lua oluşturucumuzun arkasındaki açık kaynaklı Steam depo anahtarı önbelleğinin iç yapısı ve nasıl çatallayabileceğiniz.

Manifest almak için steamtools.games adresini kullandıysanız, farkında olmasanız da zaten ManifestHub3'ü kullanmışsınız demektir. Bu yazı, oluşturucunun çalışmasını sağlayan veri katmanına perde arkasından bir bakış sunuyor.
İki depo, tek ürün
steamtools.games, birlikte çalışan iki depo (repository) olarak sunulur:
- ManifestHub3 — ham veriler. App ID'ye göre indekslenmiş, MIT lisanslı ve GitHub'da yansıtılan
depotkeys.jsonileappaccesstokens.jsondosyaları. - steamtools.games — kullanıcıya dönük oluşturucu. Verileri okuyan, arama yapan ve SteamTools'un beklediği
.manifest/.lua/key.vdfüçlüsünü sunan bir Cloudflare Worker uygulaması.
Genellikle yalnızca ikincisiyle etkileşime girersiniz. İlki ise tüm sistemin temel katmanıdır.
Depoda neler var?
Depo bilinçli olarak küçük tutulmuştur. İki JSON dosyası, bir README ve bir LICENSE içerir:
depotkeys.json— App ID ve depo ID'sine göre anahtarlanmış depo şifre çözme anahtarları.appaccesstokens.json— App ID'ye göre anahtarlanmış uygulama erişim belirteçleri (access token).og-home.png— ManifestHub3 README dosyası için paylaşım kartı görseli.
Herhangi bir derleme adımı, sunucu veya veritabanı yoktur. Depoyu git clone ile indirebilir, depotkeys.json dosyasını açabilir ve istediğiniz App ID'yi grep ile arayabilirsiniz. Tüm "veritabanı" bundan ibarettir.
Neden ayrı bir veri deposu?
Üç nedeni var:
- Denetlenebilirlik. Veritabanındaki her anahtarın bir kaynağı vardır. Bir App ID'yi aratabilir, tam olarak nelerin kayıtlı olduğunu görebilir ve önceki commit ile farkını (diff) inceleyebilirsiniz. Site sihirli bir şey yapmıyor — sizin de okuyabileceğiniz aynı JSON dosyasını okuyor.
- Kendi sunucunuzda barındırma (Self-hosting). Barındırılan site kapalıysa veya üçüncü taraf bir CDN'e güvenmiyorsanız verileri kendiniz çalıştırabilirsiniz. Depoyu klonlayın, Worker'ı kendi çatalınıza (fork) yönlendirin; artık özel oluşturucunuz hazır.
- Koruma ve arşivleme. ManifestHub3, GitHub'dan kaldırılan orijinal ManifestHub veritabanının koruma amaçlı bir yansı kopyasıdır. Veriler kaybolmadı; net bir geçmişe sahip, izin verici bir lisans altında yeni yuvasında yaşamaya devam ediyor.
Oluşturucu bu verileri nasıl kullanır?
steamtools.games üzerinde bir oyun aradığınızda istek akışı şu şekildedir:
- Worker, arama teriminizi bir App ID'ye çözümlemek için canlı Steam mağazasını sorgular. Bu işlem Steam mağaza sayfasının kullandığı aynı uç noktayı kullanır; böylece DLC'ler, oyun müzikleri (soundtrack) ve oynaması ücretsiz yapımlar da doğru şekilde çözümlenir.
- Worker, App ID'yi
depotkeys.jsonveappaccesstokens.jsondosyalarında arar. - SteamTools'un beklediği standart dosya adlarını (
{appid}_{depotid}.manifest,{appid}.lua,key.vdf) oluşturur ve bunları bir ZIP arşivi olarak sunar.
Veriler Worker'ın belleğinde önbelleğe alınabilecek kadar küçük olduğu için arama işlemi bir saniyenin altında tamamlanır. Üçüncü taraf API, hız sınırı belirteci veya kimlik doğrulama yoktur.
Nasıl katkıda bulunabilirsiniz?
Depo, MIT lisansı altında bir GitHub deposudur. Eksik bir App ID veya güncelliğini yitirmiş bir anahtar bulursanız bir pull request (çekme isteği) açabilirsiniz — veriler düz JSON formatındadır ve her değişiklik bir geliştirici tarafından incelenir. steamtools.games de aynı verileri sunduğundan, katkınız Worker'ın bir sonraki derlenmesinde doğrudan yayına alınır.
Sıradaki adımlar
- Depoya göz atın: github.com/steamtools-games/ManifestHub3
- Oluşturucuyu kullanın: steamtools.games
- Herkese açık API belgelerini okuyun: steamtools.games/tr/developers
- Discord sunucusuna katılın: discord.com/invite/FDKpJu5zgT
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.