320.18K
Category: softwaresoftware

Как пользоваться GameJolt API?

1.

Как пользоваться GameJolt API?
Гайд для чайников, как я.
Это презентация о том, как пользоваться GameJolt API, на
примере ClickTeam Fusion.
Это может помочь вам в создании игры. Здесь мы
рассмотрим:
- Как подключить GameJolt API к ClickTeam проекту.
- Какие есть команды, как их запускать, и что они выполняют.
- Таблица лёгких и сложных команд (как по мне)
Некоторых нет, ведь пока мне лень
Удачи!

2.

1.1 Как подключить проект?
Итак, вы уже знаете как подключить GameJolt API через ютуб видео,
и также вы уже сделали игру в GameJolt.
Теперь, как подключить GameJolt игру к ClickTeam проекту?
1. Зайди в настройки игры (на сайте)
2. Перейди в Game API
3. Зайди в API Settings
4. Запомни Game ID и Key, они будут нужны для использования.
Переходим в ClickTeam проект:
5. Переходим к объекту “GameJolt API”
6. В переменных есть Game ID и Game Key. Туда и вводи параметры с 4
пункта.
Готово! Если есть трудности, смотри следующий слайд,
там есть картинки с пояснением.

3.

Пояснение к 1.1

4.

1.2 Как вводить и выполнять
команды?
Перед изучением команд узнайте: как выполнять эти команды.
Сначала зайдите в редактор событий (рис.1)
Создайте любое условие
Выбирайте объект “GameJolt API” (рис.2)
В переменной строке, в переменной “Command” вводи команду. (рис.3)
Затем, также в объекте “GameJolt API”, в Подсчёт / Цикл каждому
объекту введите Start
Готово. Команда будет запущена, когда условия выполнится.
1.
2.
3.
4.
5.

5.

2.1. Команда “login”
login – Команда входа.
Без него игрок не имеет доступа к большому функционалу команд.
Структура start:
login [имя аккаунта в GameJolt] [игровой токен]
Пример:
login yourname ospd
*примечание:
Обычный текст – не обязательно нужно входить в игру.
Жёлтый текст – нужно авторизоваться, чтобы выполнить этакую команду.
Зелёный текст – желательно играть минимум, как за гостя.

6.

2.2 Команда “fetch user”
fetch user – Команда узнаватель.
Выдаёт информацию об игроке с помощью его имени или ID.
Структура:
fetch user [Никнейм игрока]
fetch user [ID игрока]
Пример:
fetch user brawler
fecth user 6324535
Данные затем сохраняются в GJ User
Скоро будут подробности…

7.

2.3 Команда “session”
session – команда «выживления»
Показывает другим, что вы играете/закончили играть в игру.
Есть 3 типа session:
1. session open – говорит, что вы играете в эту игру
2. session ping – не понятно, что имеется в виду, но скорее всего, чтобы
понять игре, что он ещё играет.
3. session close – говорит, что вы уже не играете в игру, НО вы например
всё ещё играете.
Скоро будут подробности…

8.

2.4 Команда “fetch trophies”
fetch trophies – команда узнаватель.
Получает подробные данные об трофеи(-ях)
Можно узнать: 1 достижение; Несколько через запятую; Все достижения;
Все, которые получил; Все, которые ещё не получил.
Структура:
fetch trophies [ID ачивки]
fetch trophies [ID1],[ID2],[ID3]…
fetch trophies all
fetch trophies true
fetch trophies false
Пример:
fetch 432143
fetch 134212,654732,145736
Данные сохраняются в GJ Trophy

9.

2.5 Команда “achieve”
achieve – команда выдаватель.
Выдаёт достижение игроку
Структура:
achieve [ID ачивки]
Пример:
achieve 299321

10.

2.6 Команда “scores”
scores – команда узнаватель.
Узнаёт об листе с рекордами.
Он имеет две функции:
scores all [места] - число рекордов всех людей
scores user [места]- число твоих рекордов
Пример:
scores all 100
scores user 5
Примечание: если Table ID (сам привязанный лист) будет 0, то применится
main лист.
Всё это сохраняет в GJ Scores
Скоро будут подробности…

11.

2.7 Команда “score”
score – команда записыватель.
хз что это, скорее всего что то с листами| местами.
Вот две структуры:
score add user [Счёт] [“Текст после счёта”] [“Доп. инфа”]
score add guestname [Счёт] [“Текст после счёта”] [“Доп. инфа”]
Пример (возможный):
score add user 799 “lvls” “he bad hero”
score add megcool 123 “increase” “v 1.0.6”
Примечание: где были кавычки, там нужно писать обязательно
Скоро будут подробности…

12.

2.8 Команда “tables”
tables – команда узнаватель.
Обычная команда, чтобы узнать все лидерборды.
Всё сохранят в GJ table

13.

2.9 Команда “fetch data”
fetch data – команда узнаватель.
Узнаёт глобальное кол-во или своё кол-во.
Структура:
fetch data global «Название»
fetch data user «Название»
Пример:
fetch data global INSTALLS
fetch data user DEATHS
Сохраняет в GJ data
Скоро будут подробности…

14.

2.10 Команда “dataset”
dataset – команда записыватель.
Позволяет изменять эти данные.
Структура:
dataset global [Имя переменной] [Значение]
dataset user [Имя переменной] [Значение]
Пример:
dataset global deatheblans 4
dataset user shashlik 12
Скоро будут подробности…

15.

2.11 Команда “dataupdate”
dataupdate – команда записыватель.
Что то похожее на команду dataset, но более простым режимом
математики.
Структура:
dataupdate global [Имя] [Операция] [Число/строчка]
dataupdate user [Имя] [Операция] [Число/строчка]
Операции для чисел: add - добавить, subtract - вычитать, multiply умножать, divide - делить
Операции для строк: append -> добавить к концу, prepend -> добавить к
началу.
Пример:
dataupdate global MEGA add 1
dataupdate user fun divide 0.5
Скоро будут подробности…

16.

2.12 Команда “dataremove”
dataremove – команда очиститель.
Оно полностью стирает инфу с переменной.
Пример:
dataremove global [имя переменной]
dataremove user gorila
Скоро будут подробности…

17.

3.1 Что за условия?
В игре конечно можно всё сделать по собственным условиям,
но команды не всегда быстро срабатывают и дают результат. А таймеры
ещё хуже делают.
Как быть? Есть такой объект, как “GameJolt Get”
Он помогает проверять команду, выполнена она или нет. Как его писать:
1. В условиях выбираем сам объект как “на каждом…” (рис.1)
2. Затем в названии цикла мы ставим команду, которую мы выполнили и
приписываем :true или :false (рис.2)
Готово! Вот примерно как выглядит структура:
[команда, которую хотите проверить]:[правда или ложь]
start:true
achieve:false
Если не понятно, смотри след. слайд с объяснениями.
+ GJ Get имеет доп. переменные с причинами и т.д.

18.

Пояснение к 3.1

19.

3.2 Переменные у GJ API
Какие переменные имеет GJ API?
В основном:
Game ID – ID игры
Table ID – ID таблицы (изменяемая)
Game Key – Ключ игры
Username – Текущий пользователь
User Token – Токен пользователя
Command - Команда
Остальные команды: cmdamt, objfound, gj_url, cmd_url, parsed_cmd,
cmd_name, cmd_actual, stored_info.

20.

3.3 Переменные у GJ User
Какие переменные имеет GJ User?
В основном:
User ID – ID пользователя
Username – Никнейм пользователя
User Type – Какой пользователь? (обычный, создатель, помогающий)
Avatar URL – Ссылка на картинку аватара
Signup Date – Дата регистрации
Last Login – Последний вход в GameJolt
User Status – не знаю
Dev. Name – не знаю
Dev. Website – не знаю
Dev. Desc – не знаю

21.

3.4 скоро….
позже сделаю Trophy, Score, Table, Data, Key и Get.

22.

Спс, что посмотрели мою
инструкцию
^_^
Версия 1.1.2
пропущено 1 старых версий…
1.1.0 – кастом персонализация, новые цвета, некоторые
исправления и добавления. Под конец подленился.
1.1.1 – 1. карл, я не заметил start вместо login
2. добавил цветной шрифт (показан в 2.1)
3. Чу-чуть дополнены и улучшены всякие слайды.
1.1.2 - мелкие исправления, условия, некоторые переменные
Планы:
1.1.3 – до конца добавить переменные
1.2.0 – добавить картинку/видео с работой командой. Пояснение и т.д.
1.3.0 - сделать таблицу этих команд
Не стесняйтесь мне говорить, где есть ошибка. Пиши мне в дс: @dimkain
English     Русский Rules