Решение ошибок генератора SteamTools (манифесты и Lua)

Наш генератор представляет собой тонкую прослойку поверх публичных API Steam, поэтому возвращаемые им ошибки обычно напрямую отражают ответы от серверов Steam. Ниже приведен краткий список того, с чем вы можете столкнуться, что эти сообщения означают на самом деле и как исправить каждую ситуацию.

1. «A valid numeric App ID is required» (Требуется корректный числовой App ID)

Самая частая ошибка с большим отрывом. Обычно ее вызывают три причины:

• Вы ввели в поле название игры, а не число, и нажали кнопку создания до того, как выпадающий список успел подобрать App ID. При потере фокуса список закрывается, и форма отправляется с пустым App ID.
• В введенном App ID есть опечатка (буква, ведущий ноль или лишний пробел).
• Поле оказалось пустым — форма позволяет отправить пустой запрос, если очень быстро нажать Enter.

Решение: введите или вставьте только цифры. Никаких букв, нулей в начале и пробелов.

2. «App <id> was not found in the Steam store» (Приложение <id> не найдено в магазине Steam)

Вы ввели корректно отформатированный App ID, но эндпоинт appdetails в Steam не вернул по нему запись. Почти всегда это означает одну из трех вещей:

• Идентификатор ошибочен на одну-две цифры. Быстрее всего перепроверить его через SteamDB.
• Этот ID принадлежит приложению, которое доступно только в другом регионе, отличном от cc=us. Некоторые игры привязаны к конкретному региональному магазину. Мы постепенно добавляем поддержку новых регионов; а пока попробуйте открыть этот же ID в браузере с региональной ссылкой магазина, чтобы убедиться, что приложение существует.
• Этот ID принадлежит приложению, которое полностью удалено из Steam. В SteamDB запись о нем сохраняется, но appdetails ее больше не возвращает.

Решение: проверьте идентификатор на SteamDB. Если там игра находится, но генератор все равно ее отклоняет, напишите нам в Discord — мы добавим недостающий регион.

3. «Steam search failed (429)» (Сбой поиска Steam: ошибка 429)

Мы уперлись в ограничение частоты запросов (rate limit) со стороны Steam. Сам генератор устанавливает минимальный интервал 300 мс на один IP для поиска и 1,5 секунды для генерации, но серверы Steam также применяют собственные лимиты. Если вы видите это сообщение, правильнее всего подождать несколько секунд и повторить попытку — ограничение привязано к IP, а не к аккаунту, и сбрасывается очень быстро.

Решение: подождите 5–10 секунд и попробуйте снова. Если вы обращаетесь к API с помощью скриптов, загляните в Discord, чтобы узнать заголовки лимитирования и настроить корректную паузу (backoff).

4. «App ID is too long» (App ID слишком длинный)

Вы вставили значение длиннее 10 цифр. Steam App ID являются 32-битными беззнаковыми целыми числами, поэтому их теоретический максимум — 4 294 967 295, однако на практике реальные ID редко превышают 7 цифр, а у большинства игр их от 4 до 6. Если вы видите сообщение о слишком длинном ID, скорее всего, в буфере оказался кусок URL или фрагмент JSON со SteamDB вместо самого идентификатора.

Решение: скопируйте именно числовой ID, без адреса ссылки и постороннего JSON-кода.

Одно решение, которое устраняет большинство проблем

Около 80% всех обращений в поддержку сводятся к одному: «вы ввели неверный App ID, на самом деле правильный ID — X». Чаще всего это происходит, когда пользователь копирует не то число со страницы SteamDB. На странице каждой игры SteamDB показывает сразу четыре номера: App ID, package ID, depot ID и build ID. Вам нужен именно App ID. Остальные три обозначают совершенно другие сущности.

Если вы сомневаетесь, какой именно номер нужен, заголовок страницы на SteamDB всегда содержит ссылку на канонический URL магазина (store.steampowered.com/app/<APPID>/...) — берите число именно оттуда.

Если вашей ошибки нет в этом списке

Генератор реализован как серверный маршрут TanStack Start; полный текст ошибки возвращается в теле ответа в формате { "code": -1, "message": "..." }. Если вы столкнулись с сообщением, которого нет в списке выше, скопируйте строку целиком и отправьте ее в Discord — обычно на диагностику уходит меньше часа.

---

Источник данных: ManifestHub3 — открытый кэш ключей депо Steam под лицензией MIT, на котором работает этот генератор. Изучайте его, делайте форки или запускайте собственное зеркало.

Попробовать генератор →