Часто задаваемые вопросы

Блок на главной странице отвечает на шесть наиболее задаваемых вопросов. Эта страница является более длинной версией: вопросы, которые возникают несколько раз в месяц, крайние случаи, вещи, которые сбивают с толку людей даже после того, как они несколько раз воспользовались генератором. Если вашего вопроса здесь нет, Discord — это самый быстрый путь к реальному ответу.

Что такое SteamTools.games в одном предложении?

Бесплатная браузерная утилита, которая создает пару манифеста и Lua SteamTools, необходима для разблокировки игры App ID. Это тонкий слой над общедоступными API Steam, который не изменяет никакие игровые файлы на вашем компьютере.

Связан ли этот сайт с SteamTools, SteamDB или Valve?

Нет. Сайт управляется членами сообщества и является независимым. Имя Steam, имя SteamTools и имя SteamDB являются собственностью соответствующих владельцев и используются здесь только в описательных целях.

Зачем существует сайт, если у SteamTools уже есть генератор?

Официальный генератор SteamTools размещен на стороннем домене, надежность которого на протяжении многих лет испытывала проблемы. SteamTools.games был создан как более устойчивая альтернатива. Оба создают эквивалентные файлы; Этот сайт стремится стать быстрее, доступнее и более прозрачным в отношении своей работы.

Как мне найти App ID для моей игры?

Три надежных способа по порядку:

1. По URL-адресу магазина: откройте страницу игры в магазине, скопируйте номер между /app/ и следующим /. Например, 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. Число в имени файла — App ID.

Полное руководство находится на отдельной странице.

Почему генератор возвращает «Приложение не найдено в магазине Steam»?

Четыре распространенные причины, в порядке частоты:

1. Неверный номер. Чаще всего это идентификатор пакета, идентификатор хранилища или идентификатор сборки, а не App ID. Подтвердите номер в каноническом хранилище URL.
2. Приложение с региональной блокировкой. В настоящее время генератор запрашивает cc=us. Если приложение продается только в определенном регионе, поиск возвращается пустым.
3. Приложение исключено из списка. SteamDB сохраняет запись, но appdetails больше не возвращает ее. SteamTools не может работать с приложениями, исключенными из списка.
4. Опечатка. Эту ошибку могут вызвать нуль в начале, пробел в конце или разделитель тысяч.

Почему генератор возвращает ошибку 429?

Генератор обеспечивает минимум 1,5 секунды между вызовами POST /api/generate для каждого IP. Если вы отправите запросы быстрее, вы получите обратно 429 с заголовком Retry-After. Собственный восходящий канал Steam также ограничивает скорость. Если вы видите это, подождите 5–10 секунд и повторите попытку.

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

Безопасна ли служба? Вы храните мои данные?

Сервис не требует учетной записи, не устанавливает файлы cookie для отслеживания и не записывает историю поиска на диск. Единственные данные, которые он обрабатывает в краткосрочной перспективе, — это строка поиска и подтвержденный вами App ID, и они используются только для одного запроса. Журналы сервера меняются каждые 14 дней. Полная информация содержится в Политике конфиденциальности.

Почему файл называется *.lua и что в нем находится?

Файл Lua представляет собой короткий скрипт, который сообщает SteamTools, какие хранилища загружать для этого приложения. Он содержит две строки: одну для регистрации App ID и его ключа дешифрования хранилища, а другую для указания SteamTools на конкретную сборку хранилища. Полная информация находится на странице файлов манифеста.

Могу ли я написать сценарий API?

Да. Две конечные точки:

• GET /api/search?query=<name-or-appid> — возвращает до 5 совпадений как JSON.
• POST /api/generate с телом JSON { "appId": "<id>", "branch": "<optional>" } — возвращает манифест URL, Lua URL, проверенное имя и изображение игры, а также краткий список инструкций.

На оба протокола распространяется ограничение скорости для каждого IP (300 мс для поиска, 1,5 с для генерации). Здесь нет ключа API, нет квоты на использование и нет ограничения для каждого IP-адреса сверх предела скорости. Пожалуйста, не пишите скрипт со скоростью выше 1 запроса в 1,5 секунды.

Могу ли я встроить генератор на свой сайт?

Конечная точка является общедоступной, без аутентификации JSON API. Вы можете использовать его из своего собственного интерфейса, если соблюдаете ограничение скорости. На сайте нет документированной политики CORS, кроме настроек по умолчанию; если у вас возникнут проблемы с CORS, оставьте заметку в Discord.

Что на самом деле делает полоса «Недавние» на главной странице?

Он считывает данные из одного ключа localStorage (steamtools.recent.v1) и отображает самые последние App ID, созданные вами за последние 30 дней. На сервер ничего не отправляется. Вы можете удалить его в любое время в настройках данных сайта вашего браузера.

Я нашел ошибку / генератор ошибается в приложении. Что мне делать?

Самый быстрый путь — Discord. Отбросьте App ID, URL, которые вы использовали, и то, что вы ожидали, и модератор направит это нужному человеку. Большинство проблем решаются в течение часа.

Есть ли способ поддержать проект?

Здесь нет ни страницы пожертвований, ни Patreon, ни товаров. Сайт финансируется из собственного кармана небольшой группой членов сообщества и намеренно остается небольшим, чтобы затраты оставались тривиальными. Если вы хотите поддержать проект, самое полезное — сообщить об ошибках в Discord и рассказать о сайте другим пользователям SteamTools.

Почему в разделе «Популярные игры» отсутствуют некоторые приложения?

Раздел «Популярные игры» курируется небольшой группой модераторов и обновляется ежемесячно. Если игры, которая, по вашему мнению, должна быть там, нет, отправьте сообщение Discord, и она, вероятно, будет добавлена ​​в следующем обновлении.

Что произойдет, если служба выйдет из строя?

Уведомление будет размещено в блоге, а баннер сначала появится на главной странице. Если служба не работает в течение длительного периода, закрепленное сообщение в Discord укажет на работающую альтернативу.

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

См. также

• Что такое файл манифеста Steam и как его использовать с SteamTools? — полное руководство по входной двери; эта страница представляет собой более глубокое погружение в одну из ее частей.