Background games redeemer ru RU

Фоновая активация ключей

Фоновая активация ключей - встроенная в ASF функция, позволяющая ввести определённый набор ключей Steam (вместе с их именами) для активации в фоновом режиме. Эта функция особенно полезна в связке с множеством ключей, которые нужно активировать, когда Вы гарантировано получите статус RateLimited до того, как вы закончите активацию всего набора.

Фоновая активация ключей нацелена на использование для одного бота, что означает, что функция не использует RedeemingPreferences. Данную функцию можно использовать вместе с (или вместо) командой redeem, если нужно.

Импорт

Импортировать возможно с помощью двух способов - используя файлы или IPC.

Файл

ASF увидит в папке config файл с названием BotName.keys, где BotName - имя бота. У файла есть определённая структура в виде названия игры и ключа от неё, отделённые символом табуляции и заканчивающаяся новой строкой. Если используется несколько символов табуляции, к примеру, в названии игры, то считается только последний, при этом предыдущие считаются как часть названия игры, и конвертируются в пробелы. Например:

POSTAL 2    ABCDE-EFGHJ-IJKLM
Domino Craft VR 12345-67890-ZXCVB
A Week of Circus Terror POIUY-KJHGD-QWERT

ASF импортирует данный файл, при запуске бота или позже при выполнении. После успешного считывания вашего файла и пропуска неправильных записей, все правильно распознанные игры будут добавлены в очередь и BotName.keys будет удалён из директории config.

IPC

Помимо использования файла с ключами, ASF также предлагает метод API GamesToRedeemInBackground, который может быть вызван любым инструментом для работы с IPC, включая наш IPC GUI. Способ с IPC может быть более функциональным, так как Вы можете настроить считывание под себя, например, использовать свой разграничитель вместо символа табуляции.

Очередь

Когда игра успешно импортирована, она добавляется в очередь. ASF автоматически проходит очередь в фоне, пока бот подключен к сети Steam и очередь не пуста. Ключ, к которому была применена попытка активации, которая дала результат, отличный от RateLimited, удаляется из очереди, а его статус пишется в файл в директории config - BotName.keys.used, если ключ был в итоге использован (к примеру, NoDetail, BadActivationCode, DuplicateActivationCode) или BotName.keys.unused в ином случае. ASF будет использовать имя данное вами название игры, так как ключ может не иметь корректного названия игры, которое отдаётся сетью Steam - таким образом вы можете помечать ключи своими именами, если необходимо.

Если во время процесса аккаунт получает статус RateLimited, очередь будет временно приостановлена на час для исчезновения кулдауна. После ожидания процесс продолжится с места, где он остановился, пока очередь не исчезнет.

Пример

Предположим, у вас есть список со 100 ключами. Для начала, вам нужно создать новый файл BotName.keys.new в директории config ASF. Расширение .new добавляется для того, чтобы ASF не импортировал данный файл сразу после создания (так как это пустой, не готовый для импорта, файл).

Теперь вы можете открыть новый файл и вставить список из 100 ключей, при необходимости, исправляя формат. После правок файл BotName.keys.new будет иметь ровно 100 (или 101, с переходом на новую строку в конце) строк, имея структуру в виде GameName\tcd-key\n, где \t - это символ табуляции, а \n - новая строка.

Теперь можно сменить имя файла с BotName.keys.new на BotName.keys для импорта в ASF. Сразу после того как Вы это сделали, ASF начнёт автоматически импортировать файл(без перезагрузки) и потом удалит его, подтверждая то, что все наши игры были считаны и добавлены в очередь.

Вместо использования BotName.keys файла,вы можете использовать IPC API или даже комбинировать оба метода,если хотите.

После некоторого времени,файлы BotName.keys.used и BotName.keys.unused могут сгенерироваться. Эти файлы содержат результат нашего процесса активации ключей. Например,вы можете переименовать файл BotName.keys.unused в BotName2.keys,следовательно,передать наши неиспользованные ключи другому боту,так как предыдущий бот не использовал эти ключи для себя. Или просто копипастнуть неиспользованные ключи в какой-то другой файл и придержать его до следующей активации. Помните, что ASF проходит очередь, новые попытки активации будут добавлены к нашим выходным used и unused файлам, по этому рекомендуется подождать окончания очереди, перед тем как добавлять новые ключи. Если вам крайне необходимо активировать новые файлы, прежде чем очередь закончилась, сначала следует перенести выходной файл, который Вы хотите использовать, в другую директорию и после этого считать его. Потому что ASF может добавить новые результаты в то время,когда Вы создаёте новый файл,и это может привести к потере ключей,например если Вы считали файл,который содержит 3 ключа внутри,потом удалили его,Вы упускаете тот факт,что в это время ASF добавил 4 ключа в ваш удалённый файл. Если вы хотите получить доступ к этих файлам, убедитесь что они перемещены с ASF config директории, перед тем как считать их, например переименованием.

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

Примечания

У фоновой активации ключей "под капотом" используется OrderedDictionary, а это значит что порядок ключей будет сохраняться таким, каким вы его задали в текстовом файле (или вызове IPC API). Это значит что вы можете (и даже должны) составлять список так, чтобы ключи, активация которых зависит от активации других ключей, должны быть ниже по списку чем те ключи, от которых они зависят. Например, это означает что если у вас есть DLC D которое для активации требует, чтобы сначала была активирована игра G, то ключ для игры G должен всегда стоять в списке раньше, чем ключ для DLC D. Аналогично, если DLC D зависит от активации A, B и C, то все 3 они должны стоять в списке раньше него (в любом порядке, если конечно они не зависят в свою очередь друг от друга).

Если вы не будете соблюдать схему описанную выше, ваше DLC не будет активировано с сообщением DoesNotOwnRequiredApp, даже если его можно будет активировать на ваш аккаунт после того как будет активирована вся очередь ключей. Чтобы избежать этого, следите чтобы DLC всегда был в очереди после базовой игры.