SteamTools Oluşturucu Hatalarını Giderme (Manifest ve Lua)

Oluşturucu, Steam'in herkese açık API'leri üzerinde çalışan ince bir katmandır; bu nedenle döndürdüğü hatalar genellikle kaynak API'den gelen hataların kısa bir çevirisidir. İşte karşılaşabileceğiniz hataların, gerçekte ne anlama geldiklerinin ve her biri için ne yapmanız gerektiğinin kısa listesi.

1. "A valid numeric App ID is required" (Geçerli bir sayısal App ID gereklidir)

Açık ara en yaygın hata budur. Genellikle üç şey buna neden olur:

• Alana bir sayı yerine oyun adı yazdınız ve açılır menü henüz sonucu çözümlemeden Oluştur (Generate) düğmesine tıkladınız. Odak dışarı çıktığında açılır menü kapanır ve boş App ID gönderilir.
• Yazdığınız App ID'de bir yazım hatası var (bir harf, başta sıfır veya boşluk).
• Alan boş — Enter tuşuna çok hızlı basarsanız form boş bir gönderime izin verebilir.

Çözüm: yalnızca rakamları yazın veya yapıştırın. Harf yok, başta sıfır yok, boşluk yok.

2. "App <id> was not found in the Steam store" (Uygulama Steam mağazasında bulunamadı)

Girdiğiniz App ID biçim olarak doğru, ancak Steam'in appdetails uç noktası onun için bir kayıt döndürmedi. Bu neredeyse her zaman şu üç durumdan biri anlamına gelir:

• Kimlik numarası bir veya iki rakam yanlıştır. Bunu doğrulamanın en hızlı yolu SteamDB'dir.
• App ID, cc=us dışında yalnızca başka bir bölgede bulunan bir uygulamaya aittir. Bazı uygulamalar tek bir mağazaya kilitlidir. Daha fazla bölge ekliyoruz; şimdilik uygulamanın var olduğunu doğrulamak için tarayıcınızda aynı ID'yi bölgesel mağaza URL'si ile deneyin.
• App ID, Steam'den tamamen kaldırılmış bir uygulamaya aittir. SteamDB kaydı tutmaya devam eder ancak appdetails artık o kaydı döndürmez.

Çözüm: App ID'yi SteamDB üzerinden doğrulayın. Orada görünüyor ancak oluşturucu hâlâ reddediyorsa Discord sunucusuna yazın, eksik bölgeyi ekleyelim.

3. "Steam search failed (429)" (Steam araması başarısız oldu - 429)

Steam'in hız sınırına (rate limit) takıldık. Oluşturucu IP başına arama için minimum 300 ms, oluşturma için 1,5 sn aralık uygular ve Steam'in kendi kaynak sunucusu da hız sınırı koyar. Bunu görürseniz yapmanız gereken en doğru şey birkaç saniye bekleyip tekrar denemektir — sınır hesap başına değil IP başınadır ve hızlıca sıfırlanır.

Çözüm: 5–10 saniye bekleyin ve yeniden deneyin. API'ye karşı betik çalıştırıyorsanız, hız sınırı üst bilgilerini (header) öğrenip düzgün şekilde geri çekilebilmek için Discord sunucumuza göz atın.

4. "App ID is too long" (App ID çok uzun)

10 basamaktan uzun bir değer yapıştırdınız. Steam App ID'leri 32 bitlik işaretsiz tamsayılardır, bu nedenle teorik üst sınır 4.294.967.295'tir — ancak pratikte gerçek hiçbir uygulama 7 basamağı aşmaz ve çoğu 4–6 basamaklıdır. "Çok uzun" hatası görüyorsanız, muhtemelen bir App ID yerine bir URL parçası veya SteamDB JSON çıktısından bir bölüm yapıştırdınız.

Çözüm: URL'yi veya JSON'u değil, yalnızca ID'nin kendisini kopyalayın.

Çoğunu çözen tek düzeltme

Aldığımız tüm destek mesajlarının yaklaşık %80'i şu sonuca varır: "yazdığınız App ID yanlış, gerçek ID şu: X". En yaygın neden ise bir SteamDB sayfasından yanlış numarayı almaktır. SteamDB her uygulama sayfasında dört farklı numara gösterir: App ID, package ID, depot ID ve build ID. Sizin istediğiniz App ID'dir. Diğer üçü farklı şeylerdir.

Hangi numaranın hangisi olduğundan emin olamadığınızda, SteamDB'deki sayfa üst bilgisi her zaman standart mağaza URL'sine (store.steampowered.com/app/<APPID>/...) geri bağlantı verir — kullanmanız gereken numara odur.

Hata mesajı bu listede yoksa

Oluşturucu bir TanStack Start sunucu rotasıdır; tam hata mesajı yanıt gövdesinde { "code": -1, "message": "..." } biçiminde döndürülür. Yukarıdaki listede yer almayan bir mesaj görürseniz dizenin tamamını kopyalayıp Discord kanalına gönderin — teşhis edilmesi genellikle bir saatten kısa sürer.

---

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 →