Описание
Расчёт игровых ситуаций, хода компьютера и прочие игровые скрипты. На основе данного сервиса созданы игры "Быки и коровы", "Цифровые войны" и "Сапёр" в боте @PaperGames_bot.
Вы отправляете данные об игре, а мы рассчитаем что нужно.
Последние новости
- 11 августа 2021 г. -
- Исправлен недочёт, из-за которого игровое поле не генерировалось, и выдавалась ошибка о неверно указанных размерах.
- Ограничены максимальные размеры игрового поля: теперь максимальный размер 2500 ячеек.
"Сапёр":
Состав API:
-
"Быки и коровы"
Сопоставление числа игрока и загаданного числа; проверка чисел на соответствие правилам.
Правила игры: компьютер задумывает последовательность из разных 4 цифр (0 может стоять впереди). Цель игрока — отгадать эту последовательность. Каждый ход игрок называет последовательность из 4 разных цифр. Если угадана цифра, но не её расположение, то эта ситуация называется "корова". Если угадана цифра и её расположение, то такая ситуация называется "бык". Количество "коров" и "быков" зависит от количества совпавших цифр для каждого случая. Например, если компьютер задумал 6 1 0 9, а игрок назвал 0 1 9 3 , то компьютер скажет: "1б и 2к", где 1б - цифра 1, совпавшая по положению в числе, 2к - цифры 0 и 9, не совпавшие по положению, но имеющиеся в загаданном числе.
-
"Цифровые войны"
Проверка выбранной игроком цифры на существование в списке; использование искусственного интеллекта для хода компьютера.
Правила игры: пишется ряд цифр от 0 до 9 в любой последовательности, в любых комбинациях и любой длины. Своим ходом игрок может сделать одно из двух возможных в игре действий: уменьшить на 1 одну из цифр, максимум до 0; стереть любой ноль и все цифры справа от него, сократив таким образом длину ряда. Проигрывает тот, кому остался 0.
-
"Сапёр"
Создание игрового поля; вычисление состояния игрового поля после открытия ячейки игроком.
Игровое поле (обычно квадратное) разделено на ячейки, некоторые из которых заминированы. Целью игры является открытие всех ячеек, не содержащих мины. Игрок открывает ячейки, стараясь не открыть ячейку с миной. После открытия ячейки в ней может оказаться либо число, либо мина: число указывает на количество мин, находящихся в смежных к открытой ячейке клетках; наличие мины означает проигрыш. Игрок может пометить клетку с возможной миной флажком, чтобы не потерять её из виду или не забыть про неё. Игра считается выигранной, если все клетки, в которых нет мин, открыты.
Использование сервиса
Взаимодействие с API:
Полная ссылка:
Зеркало:
"Быки и коровы"
Параметры запроса
Параметр | Описание |
typestring | Название API. Установить равным "bulls_n_cows". |
numstring | Названное игроком число. |
guessedstring | Загаданное компьютером число. |
apikeystring |
API-ключ.
Отсутствие параметра не вносит ограничений. Баланс не изменяется. |
Структура ответа
Поле | Описание |
okboolean | Результат выполнения запроса. |
datavariant |
Вернётobject BnC-Data
при успешном выполнении запроса или число, не
соответствующее правилам игрыstring,
в случае неудачи.
В случае отсутствия необходимых параметров (или при их ошибочных значениях) может быть возвращено значение "null". |
infostring |
Важная информация о запросе, на которую следует обратить внимание
(например, информация об использовании устаревшего параметра).
Поле может отсутствовать. |
amountfloat |
Баланс API-ключа.
Если параметр "apikey" не был указан, вернёт "-1". |
BnC-Data
Поле | Описание |
bullsinteger |
Количество "быков".
Если количество "быков" равняется 4, число считается угаданным. |
cowsinteger | Количество "коров". |
"Цифровые войны"
Параметры запроса
Параметр | Описание |
typestring | Название API. Установить равным "digital_wars". |
numsstring | Список цифр (текущее игровое состояние до хода игрока). |
indexinteger | Порядковый номер цифры (нумерация начинается с 1), выбранной игроком из списка, указанного в параметре "nums". |
apikeystring |
API-ключ.
Отсутствие параметра не вносит ограничений. Баланс не изменяется. |
Структура ответа
Поле | Описание |
okboolean | Результат выполнения запроса. |
datastring |
При успешном выполнении запроса вернёт одно из следующих значений:
В случае отсутствия необходимых параметров (или при их ошибочных значениях) может быть возвращено значение "null". |
infostring |
Важная информация о запросе, на которую следует обратить внимание
(например, информация об использовании устаревшего параметра).
Поле может отсутствовать. |
amountfloat |
Баланс API-ключа.
Если параметр "apikey" не был указан, вернёт "-1". |
"Сапёр"
Обратите внимание: максимальный размер игрового поля 2500 ячеек.
Параметры запроса
Параметр | Описание | |||||||||||||||
typestring | Название API. Установить равным "minesweeper". | |||||||||||||||
newboolean |
Значение не требуется. Укажите этот параметр для генерации поля игры.
Обязателен с параметром "field_size". |
|||||||||||||||
field_sizelist of integer |
Желаемый размер поля для генерации. Указывается в формате "cols,rows",
где "cols" - количество столбцов, а "rows" - количество строк.
Используется только при наличии параметра "new". |
|||||||||||||||
minesinteger |
Желаемое количество мин.
Не должно быть меньше 1 или больше общего количества ячеек (см. параметр "field_size").
Если параметр не указан, количество мин рассчитывается по следующей формуле: Используется только при наличии параметра "new". |
|||||||||||||||
fieldlist of string |
Текущее состояние поля (до хода игрока). Указывается в виде перечисления состояний ячеек через запятую. Значения состояний:
Для следующего поля:
Обязателен с параметрами "cell" и "action". |
|||||||||||||||
cellinteger |
Номер ячейки, выбранной игроком, для выполнения действия, указанного в параметре "action". Нумерация ячеек начинается от 1 с левого верхнего угла. Например, для поля 3х5 номер ячейки в первом столбце второй строки будет равен 4. Значение параметра не должно быть меньше 1 или больше общего количества ячеек (см. параметр "field"). Используется только при наличии параметра "field". |
|||||||||||||||
actionstring |
Действие для выбранной ячейки (см. параметр "cell"). Укажите значение "explore" для открытия ячейки. Укажите значение "flag" для установки/снятия флага. Будьте внимательны: в случае открытия ячейки с флагом, наличие флага в ячейке игнорируется, ячейка будет открыта. Также, в случае открытия уже открытой ячейки запрос будет считаться выполненным (в случае использования API-ключа баланс будет изменён). Используется только при наличии параметра "field". |
|||||||||||||||
apikeystring |
API-ключ.
Если этот параметр не указан, максимальный размер поля будет ограничен размером 9x9, и использование параметра "mines" не допускается. |
Структура ответа
Поле | Описание |
okboolean | Результат выполнения запроса. |
datavariant | Вернётobject FieldData при успешном выполнении запроса или текст ошибкиstring в случае неудачи. |
infostring |
Важная информация о запросе, на которую следует обратить внимание
(например, информация об использовании устаревшего параметра).
Поле может отсутствовать. |
amountfloat |
Баланс API-ключа.
Если параметр "apikey" не был указан, вернёт "-1". |
FieldData
Поле | Описание |
statusstring |
Состояние игры. Возможные значения:
1 Вам следует отображать игровое состояние следующим образом:
(см. параметр "field"). |
fieldstring | Состояние поля после выполнения запроса (см. параметр "field"). |