Sık sorulan sorular

Ana sayfadaki blok en çok sorulan altı soruyu yanıtlıyor. Bu sayfanın daha uzun versiyonudur; ayda birkaç kez sorulan sorular, uç durumlar, jeneratörü birkaç kez kullandıktan sonra bile insanların kafasını karıştıran şeyler. Sorunuz burada değilse, Discord gerçek cevaba giden en hızlı yoldur.

Tek cümleyle SteamTools.games nedir?

Bildirimi ve Lua SteamTools çiftini üreten ücretsiz, tarayıcı tabanlı bir yardımcı programın, App ID ile bir oyunun kilidini açması gerekir. Steam'nin genel API'leri üzerinde ince bir katmandır ve makinenizdeki hiçbir oyun dosyasını değiştirmez.

Bu site SteamTools, SteamDB veya Valve ile bağlantılı mı?

Hayır. Site topluluk üyeleri tarafından işletilmektedir ve bağımsızdır. Steam adı, SteamTools adı ve SteamDB adı ilgili sahiplerinin mülkiyetindedir ve burada yalnızca açıklayıcı amaçlarla kullanılmıştır.

SteamTools'nin zaten bir oluşturucusu varken site neden var?

Resmi SteamTools oluşturucu, yıllar içinde güvenilirlik sorunları yaşayan bir üçüncü taraf etki alanında barındırılıyor. SteamTools.games daha dayanıklı bir alternatif olarak tasarlandı. Her ikisi de eşdeğer dosyalar üretir; Bu site daha hızlı, daha erişilebilir ve çalışma şekli konusunda daha şeffaf olmayı amaçlamaktadır.

Sahip olduğum bir oyun için App ID'yi nasıl bulabilirim?

Sırayla üç güvenilir yol:

1. Mağaza URL'sinden: oyunun mağaza sayfasını açın, /app/ ile sonraki / arasındaki numarayı kopyalayın. Örneğin, https://store.steampowered.com/app/400/Portal/ -> 400.
2. From SteamDB: search for the game, look at the canonical store URL at the top of the SteamDB app page, copy the number there.
3. From your local Steam install: every installed game has a file appmanifest_<APPID>.acf in the `steamapps' dizini. Dosya adındaki sayı App ID'dir.

Ayrı bir sayfada tam izlenecek yol bulunmaktadır.

Oluşturucu neden "Uygulama Steam mağazasında bulunamadı" ifadesini döndürüyor?

Sıklık sırasına göre dört yaygın neden:

1. Yanlış numara. Çoğu zaman bu bir App ID değil, bir paket kimliği, depo kimliği veya yapı kimliğidir. Numarayı URL standart deposuna göre doğrulayın.
2. Bölge kilitli uygulama. Oluşturucu şu anda cc=us'yi sorgulamaktadır. Uygulama yalnızca belirli bir bölgede satılıyorsa arama boş döner.
3. Listeden kaldırılan uygulama. SteamDB kaydı tutar, ancak appdetails artık kaydı döndürmez. SteamTools, listeden kaldırılan uygulamalarda çalışamaz.
4. Yazım hatası. Baştaki sıfır, sondaki boşluk veya binlik ayırıcının tümü bu hataya neden olur.

Jeneratör neden 429 hatası veriyor?

Oluşturucu, IP başına POST /api/generate çağrıları arasında minimum 1,5 saniyeyi zorlar. İstekleri bundan daha hızlı gönderirseniz Retry-After başlığına sahip 429'u geri alırsınız. Steam'nin kendi yukarı akışı da hız limitlerini belirler. Bunu görürseniz 5-10 saniye bekleyip yeniden deneyin.

API'ye karşı komut dosyası yazıyorsanız doğru model, 10 saniyelik üst sınırla üstel geri çekilmedir. "API anahtarı" veya yükseltilmiş katman yoktur; her istemci aynı hız limitini alır.

Hizmet güvenli mi? Verilerimi saklıyor musunuz?

Hizmet bir hesap gerektirmez, izleme çerezleri ayarlamaz ve arama geçmişinizi diske yazmaz. Kısa vadede işlediği tek veri, arama dizesi ve onayladığınız App ID'dir ve bu yalnızca bir istek için kullanılır. Sunucu günlükleri her 14 günde bir döndürülür. Gizlilik Politikası tüm ayrıntıları içerir.

Dosya neden *.lua olarak adlandırılıyor ve içinde ne var?

Lua dosyası, SteamTools'ye bu uygulama için hangi depoların yükleneceğini söyleyen kısa bir komut dosyasıdır. İki satır içerir: biri App ID'yi ve depo şifre çözme anahtarını kaydetmek için, diğeri ise SteamTools'yi deponun belirli yapısına yönlendirir. Tam döküm manifest dosyaları sayfasında bulunmaktadır.

API'nin komut dosyasını oluşturabilir miyim?

Evet. İki uç nokta şunlardır:

• GET /api/search?query=<name-or-appid> — en fazla 5 eşleşmeyi JSON olarak döndürür.
• { "appId": "<id>", "branch": "<optional>" }'nin JSON gövdesine sahip POST /api/generate — URL bildirimini, Lua URL'yi, doğrulanmış oyun adını ve resmini ve kısa bir talimat listesini döndürür.

Her ikisi de IP başına hız sınırına tabidir (arama için 300 ms, oluşturma için 1,5 sn). API anahtarı, kullanım kotası ve hız sınırının ötesinde IP başına sınır yoktur. Lütfen hizmete 1,5 saniyede 1 istekten daha yüksek bir hızda komut dosyası yazmayın.

Jeneratörü kendi siteme yerleştirebilir miyim?

Uç nokta, genel, kimlik doğrulaması olmayan bir JSON API'dir. Hız sınırına uyduğunuz sürece bunu kendi ön uçunuzdan kullanabilirsiniz. Sitenin varsayılanların ötesinde belgelenmiş bir CORS politikası yoktur; CORS sorunlarıyla karşılaşırsanız Discord'ye bir not bırakın.

Ana sayfadaki "En Son" şeridi gerçekte ne işe yarar?

Tek bir localStorage anahtarından (steamtools.recent.v1) okur ve son 30 gün içinde oluşturduğunuz en yeni App ID'leri işler. Sunucuya hiçbir şey gönderilmez. Tarayıcınızın site veri ayarlarından istediğiniz zaman temizleyebilirsiniz.

Bir hata buldum / oluşturucu bir uygulamayla ilgili yanlış. Ben ne yaparım?

En hızlı yol Discord yoludur. App ID'yi, kullandığınız URL'yi ve ne olmasını beklediğinizi bırakın; bir moderatör bunu doğru kişiye yönlendirecektir. Çoğu sorun bir saat içinde önceliklendiriliyor.

Projeyi desteklemenin bir yolu var mı?

Bağış sayfası yok, Patreon yok, ürün yok. Site, topluluk üyelerinden oluşan küçük bir grup tarafından cepten finanse ediliyor ve maliyetin önemsiz kalması için kasıtlı olarak küçük tutuluyor. Projeye destek olmak istiyorsanız en yararlı şey Discord'deki hataları bildirmek ve diğer SteamTools kullanıcılarına site hakkında bilgi vermektir.

"Popüler oyunlar" bölümünde neden bazı uygulamalar eksik?

Popüler Oyunlar bölümü küçük bir moderatör grubu tarafından düzenlenir ve aylık olarak güncellenir. Orada olması gerektiğini düşündüğünüz bir oyun yoksa, Discord mesajına mesaj gönderin; muhtemelen bir sonraki yenilemede eklenecektir.

Hizmet kesintiye uğrarsa ne olur?

İlk önce blog'da bir bildirim olacak ve ana sayfada bir banner yer alacak. Hizmet uzun bir süre kapalı kalırsa, Discord dosyasındaki sabitlenmiş bir mesaj, çalışan bir alternatife işaret edecektir.

Hizmet, tek bir bakımcının onu yeni bir VPS'de yaklaşık on dakika içinde yeniden konuşlandırabileceği kadar küçüktür, dolayısıyla uzun süreli kesintiler olası değildir. Çoğunlukla Steam'nin API'si kötü bir gün geçirdiğinde kısa kesintiler meydana geliyor; bunlar kendi kendine çözülür.

Ayrıca bakınız

• Steam bildirim dosyası nedir ve onu SteamTools ile nasıl kullanırsınız? — eksiksiz ön kapı kılavuzu; bu sayfa bunun bir kısmına daha derin bir bakış.