Ігри та API
Опис
Посібник користувача
Підключіть API ваших ігор до свого сервера: учасники прив'язують свої акаунти, дивляться статистику, слідкують за станом серверів гри та порівнюють себе в рейтингу. 23 гри постачаються готовими до використання, і ви можете додати інші самостійно.
Що це робить
- Дозволяє кожному учаснику прив'язати свій ігровий акаунт до сервера.
- Показує статистику гравця на запит.
- Публікує стан серверів гри у повідомленні, яке підтримується в актуальному стані, і може перейменовувати голосовий канал-лічильник.
- Автоматично публікує новини гри в каналі.
- Створює рейтинг учасників, які прив'язали свої акаунти.
- Пропонує пошук у базах даних деяких ігор.
- Конструктор дозволяє підключити будь-який API, що повертає JSON, без написання коду.
Швидкий старт (Адмін)
- Відкрийте дашборд, модуль Ігри та API, вкладка Каталог.
- Знайдіть свою гру та натисніть Активувати. Налаштування гри відкриються відразу.
- Якщо гра позначена «Потрібен ключ», вставте свій ключ API в картку Ключ API. Коли з'являється позначка «Ключ TennoCore», ключ уже наданий і вам нічого не потрібно робити.
- За бажанням увімкніть автоматизації: Новини, Статус, Рейтинг — кожна вимагає каналу та інтервалу.
- Скористайтеся кнопкою Тестувати, щоб перевірити, чи API відповідає, потім натисніть Зберегти.
- Повідомте учасникам про
/game list: там вони бачать доступні ігри та прив'язують свій акаунт через/game link.
Команди
Усі команди доступні всім учасникам і відповідають приватно, коли йдеться про прив'язку акаунта.
| Команда | Опис |
|---|---|
/game list | Показує ігри, активовані на сервері, разом з можливостями кожної. |
/game link | Відкриває форму для прив'язки вашого акаунта до вибраної гри. |
/game unlink | Видаляє прив'язку вашого акаунта до цієї гри. |
/game stats | Показує статистику учасника (за замовчуванням вашу). |
/game status | Показує стан серверів гри. |
/game lookup | Шукає елемент у базі даних гри. |
/game leaderboard | Створює рейтинг учасників сервера, які прив'язали свої акаунти. |
Ігри, що постачаються з ботом
Надається 23 конектори. Кожен розкриває одну або кілька можливостей: Статистика гравця, Статус серверів, Новини, Пошук.
| Гра | Можливості | Ключ API |
|---|---|---|
| Apex Legends | Статистика гравця | Потрібен |
| Brawl Stars | Статистика гравця | Потрібен |
| Chess.com | Статистика гравця | Ні |
| Clash Royale | Статистика гравця | Потрібен |
| Destiny 2 | Статистика гравця | Потрібен |
| Epic Games – Безкоштовні ігри | Новини | Ні |
| Fortnite | Статистика гравця | Потрібен |
| Free-To-Game – Релізи F2P | Новини, Пошук | Ні |
| Genshin Impact | Статистика гравця | Ні |
| Hypixel (Minecraft) | Статистика гравця | Потрібен |
| League of Legends | Статистика гравця, Статус серверів | Потрібен |
| Lichess | Статистика гравця | Ні |
| Minecraft – Гравець | Статистика гравця | Ні |
| Minecraft – Сервер | Статус серверів | Ні |
| osu! | Статистика гравця | Потрібен |
| Pokédex (PokéAPI) | Пошук | Ні |
| RAWG – База даних ігор | Пошук, Новини | Потрібен |
| Roblox | Статистика гравця | Ні |
| Статус (загальний Statuspage) | Статус серверів | Ні |
| Steam – Новини гри | Новини | Ні |
| Steam – Профіль | Статистика гравця | Потрібен |
| Valorant | Статистика гравця | Потрібен |
| Warframe – Світ | Статус серверів, Новини | Ні |
Налаштування з дашборду
Модуль складається з п'яти вкладок.
- Каталог — усі доступні ігри з фільтрацією за категорією або назвою. Кожна картка вказує можливості гри та потребу в ключі. Кнопки Активувати, Дублювати (щоб почати з наявного конектора) і посилання на документацію API.
- Мої ігри — ігри, активовані на цьому сервері: стан, активні автоматизації, кількість прив'язаних акаунтів, походження ключа, останній зафіксований збій. Кнопка Налаштувати відкриває параметри:
- Загальне: гра активна або на паузі, і роль, що автоматично видається учаснику, який прив'язує свій акаунт.
- Ключ API: ваш ключ, що зберігається зашифрованим і ніколи не показується повторно. Залиште поле порожнім, щоб нічого не змінювати.
- Параметри конектора: специфічні для гри налаштування (ідентифікатор застосунку Steam, регіон…).
- Новини: канал, інтервал (від 5 до 1440 хвилин, за замовчуванням 30) та можлива згадка ролі.
- Статус: канал панелі, інтервал (за замовчуванням 10 хвилин) та голосовий канал-лічильник із шаблоном назви.
- Рейтинг: канал, інтервал (за замовчуванням 60 хвилин) та нагадування про базову статистику.
- Кожна автоматизація має кнопку Опублікувати зараз.
- Конструктор — створення власного конектора: загальна інформація, аутентифікація, поля, які заповнює учасник, кроки виклику та опис повідомлення, яке потрібно створити. Тестовий стенд виконує справжній виклик і показує дерево відповіді: натисніть на значення, щоб скопіювати його шлях і використати у відображенні.
- Гравці — усі прив'язані акаунти сервера з можливістю відв'язати учасника.
- Журнал — 50 останніх вихідних викликів до API з тривалістю, результатом та деталями помилки.
Корисно знати
- Гра має бути активована, щоб існувати. Автодоповнення команд пропонує лише активовані ігри, і тільки ті, що сумісні з використовуваною командою: гра, яка надає лише новини, не з'явиться в
/game stats. - Прив'язка перевіряється негайно.
/game linkвиконує справжній виклик до API: якщо акаунт не знайдено, нічого не зберігається, а учасник отримує помилку, повернуту грою. Тому прив'язаний акаунт — це завжди робочий акаунт. - Форма прив'язки обмежена 5 полями — це обмеження Discord.
- Гібридний режим ключів API: ваш ключ завжди має пріоритет; за його відсутності використовується глобальний ключ TennoCore, якщо він є. Власний ключ дає вам власну квоту. Збережений ключ ніколи не показується повторно в інтерфейсі.
- Квоти: кожен конектор визначає свій ліміт викликів (зазвичай 30 на хвилину на сервер). Понад це бот відповідає, що потрібно почекати хвилину. Відповіді кешуються на кілька хвилин, що згладжує повторні запити.
- Рейтинг: опитується щонайбільше 40 прив'язаних акаунтів, а показуються перші 20. Виклики навмисно розтягуються в часі, щоб не вичерпати квоту сервера — задавайте великий інтервал, якщо прив'язано багато учасників. Рейтинг залишається порожнім, якщо конектор не визначає базової статистики.
- Перший прохід новинного каналу: нічого не публікується, бот лише запам'ятовує наявну історію. Це зроблено навмисно, щоб не заповнити канал. Публікації починаються з наступного проходу.
- Голосовий канал-лічильник: Discord дозволяє лише 2 перейменування за кожні 10 хвилин. Занадто короткий інтервал буде тихо проігнорований Discord.
/game listпоказує щонайбільше 25 ігор, а автодоповнення — 25 пропозицій.- Вилучення гри стирає її налаштування та історію новин, але зберігає прив'язані акаунти учасників.
- Повідомлення модуля використовують новий формат відображення Discord: кожне поле займає власний рядок, стовпців немає.
- Власні конектори: адреси, до яких надсилаються виклики, мусять вести до публічного API. Будь-яка внутрішня або приватна адреса відхиляється з причин безпеки.
- Журнал викликів зберігається 7 днів.
- Модуль знаходиться в категорії «У розробці» дашборду: його інтерфейс ще може змінюватися.