---
title: "Як додати таблицю рекордів до гри HTML5"
description: "Додай таблицю рекордів до браузерної гри з SDK klyo: один тег скрипта і три виклики дають таблиці дня, тижня й усіх часів та місце в центрі рекордів."
url: https://games.klyo.pl/uk/support/add-leaderboard/
canonical: https://games.klyo.pl/uk/support/add-leaderboard/
type: instrukcja
language: uk
author: klyo
organization: Klyo Illia Krasnopolskyi (NIP 7822656871), Łódź, Polska
contact: kontakt@klyo.pl
updated: 2026-10-20
llms: https://games.klyo.pl/llms.txt
---

# Як додати таблицю рекордів до гри HTML5

Додай скрипт SDK klyo до index.html, виклич klyo.ready(), коли гра готова, klyo.progress() під час партії і klyo.score() наприкінці. Задай у студії найвищий можливий результат, і гра отримає таблиці дня, тижня й усіх часів.

## Перш ніж почати

- Гра, опублікована на klyo games або готова до завантаження.
- Доступ до файлу index.html гри. З твого боку не потрібні ні сервер, ні база даних, ні акаунти.
- Або ШІ-асистент, підключений через MCP: скажи йому додати до гри таблицю рекордів klyo.

## Крок за кроком

1. **Додай SDK**: Встав цей рядок у index.html перед власним скриптом: ``. Якщо відкрити гру поза klyo, вона й далі працює, а результати просто лишаються в браузері.
2. **Повідом сторінці, що гра готова**: Виклич `klyo.ready()`, коли гра завантажилася й у неї можна грати. Тоді сторінка ховає заставку завантаження.
3. **Надсилай прогрес під час партії**: Викликай `klyo.progress(points)` щоразу, коли змінюється рахунок. SDK надсилає щонайбільше чотири оновлення на секунду, а сторінка показує гравцеві під грою мету, наприклад 14-те місце і скільки очок бракує, щоб обійти наступного гравця.
4. **Надішли фінальний результат**: Наприкінці партії виклич `klyo.score(points, callback)`. Відповідь містить місце за день, тиждень і всі часи, а також гравця просто над тобою, готові для фінального екрана. Зараховується один найкращий результат з пристрою на день.
5. **Задай ліміт результату**: У студії, коли описуєш гру, заповни поле «Найвищий можливий результат за одну партію». Результати понад нього відхиляються одразу, а плитка гри в центрі рекордів отримує позначку ліміту. Без ліміту результат, у десять разів вищий за наступний, чекає на перевірку.
6. **Покажи таблицю в самій грі (необов'язково)**: `klyo.leaderboard.get("day", callback)` повертає 20 найкращих результатів за день, тиждень або всі часи, з тими самими іменами гравців, що й у спільноті.

## Якщо щось не працює

### Результати не з'являються

Результат зараховується лише після партії тривалістю щонайменше 3 секунди і лише тоді, коли гра працює на klyo. Перевір, що SDK завантажується перед твоїм скриптом і що ти викликаєш klyo.ready().

### Результат відхилено

Він вищий за встановлений ліміт або надійшов надто швидко після попереднього результату з того самого пристрою.

### Гравці питають, де таблиця

Вона сама з'являється на сторінці гри і в центрі рекордів. У самій грі ти показуєш її, лише якщо викличеш klyo.leaderboard.get.

## Часті запитання

### Чи потрібен гравцеві акаунт для таблиці рекордів?

Ні. Результат належить пристрою; з акаунтом у таблиці стоїть ім'я гравця, а результат переходить за ним на інші його пристрої.

### Чи можна обдурити таблицю рекордів через консоль браузера?

Ні. Результат приймається лише з токеном, який сервер підписує на старті партії, після щонайменше 3 секунд гри і нижче за твій ліміт, тож вписати число в консолі не вийде.

## Пов’язані інструкції

- [Як опублікувати гру HTML5 на klyo games](https://games.klyo.pl/uk/support/publish-html5-game/)
- [Як випустити нову версію гри й повернутися до попередньої](https://games.klyo.pl/uk/support/release-new-version/)
- [Гра показує білий екран: як це виправити](https://games.klyo.pl/uk/support/white-screen/)
- [Усі інструкції](https://games.klyo.pl/uk/support/)

Досі щось не працює? Напиши на [kontakt@klyo.pl](mailto:kontakt@klyo.pl) і вкажи адресу гри. Відповідає людина, протягом двох робочих днів.

---

Źródło: https://games.klyo.pl/uk/support/add-leaderboard/ · Autor: klyo, polska firma technologiczna (Łódź, klienci w całej Polsce) · Kontakt: kontakt@klyo.pl · Indeks dla modeli językowych: https://games.klyo.pl/llms.txt