---
title: "Jak zapisać postęp gracza w grze HTML5"
description: "Zapis postępu w chmurze z zestawem klyo: jeden skrypt, klyo.save.get na starcie i klyo.save.set po zmianach, sprawdzony w podglądzie studia przed wydaniem."
url: https://games.klyo.pl/pl/wsparcie/zapis-postepu/
canonical: https://games.klyo.pl/pl/wsparcie/zapis-postepu/
type: instrukcja
language: pl
author: klyo
organization: Klyo Illia Krasnopolskyi (NIP 7822656871), Łódź, Polska
contact: kontakt@klyo.pl
updated: 2026-10-23
llms: https://games.klyo.pl/llms.txt
---

# Jak zapisać postęp gracza w grze HTML5

Dodaj zestaw klyo do pliku index.html, wywołaj klyo.save.get na starcie gry i klyo.save.set po każdej ważnej zmianie. Postęp leży na serwerze klyo, idzie za zalogowanym graczem na każde urządzenie, a przed wydaniem sprawdzisz go w podglądzie w studiu.

## Zanim zaczniesz

- Gra w przeglądarce (czysty JavaScript, Godot, Unity, GameMaker albo inny silnik z eksportem do przeglądarki) i dostęp do jej pliku index.html.
- Stan gry jako obiekt, który mieści się w 64 KB, na przykład poziom, monety i ustawienia.
- Po twojej stronie nie potrzeba serwera ani bazy danych: resztę robią zestaw i strona klyo.

## Krok po kroku

1. **Dodaj zestaw**: Wstaw tę linijkę do pliku index.html przed własnym skryptem: ``. Silnik z eksportem do przeglądarki woła te same funkcje swoim sposobem wywołania JavaScriptu z gry.
2. **Wczytaj postęp na starcie**: Wywołaj `klyo.save.get(odpowiedz)` raz, gdy gra startuje. Gdy `z.ok` jest prawdą, a `z.data` ma dane, odtwórz grę z `z.data`. `z.cloud` jest prawdą, gdy odpowiedział serwer klyo, a `z.reason` mówi, dlaczego dane są tylko z przeglądarki.
3. **Zapisuj po ważnych zmianach**: Wywołuj `klyo.save.set(stan, odpowiedz)` po poziomie, zakupie albo zmianie ustawień. Zestaw trzyma kopię w przeglądarce i łączy zapisy częstsze niż co 2 sekundy w jeden, więc nie potrzebujesz własnego licznika.
4. **Sprawdź w podglądzie w studiu**: Wgraj paczkę i zagraj w oknie podglądu. Zapis idzie do chmury podglądu, którą widzisz tylko ty, a odpowiedź ma `o.cloud` i `o.preview` równe prawdzie. Wywołaj `klyo.save.get` jeszcze raz albo otwórz podgląd ponownie: te same dane wracają z `z.source` równym "chmura".
5. **Wydaj grę**: Po wydaniu każdy gracz zapisuje we własnym miejscu: zalogowany ma postęp na każdym urządzeniu, gość w tej przeglądarce. Twój zapis z podglądu znika razem z podglądem.

## Jeśli coś nie działa

### Odpowiedź mówi, że dane są lokalne

`z.reason` mówi dlaczego. bez-strony: gra działa poza klyo (wprost z pliku albo na innej stronie), więc postęp zostaje w przeglądarce. bez-serwera: nie było połączenia, a zestaw wyśle kopię później. pusto-w-chmurze: w chmurze jeszcze nic nie było, więc gra dostała kopię z przeglądarki, a zestaw wysłał ją do chmury.

### Mój kod czeka, a potem się poddaje

Odpowiedź przychodzi zawsze, najpóźniej po 8 sekundach, a na klyo od razu. Usuń własny, krótszy limit czasu i uruchom grę z kopii w przeglądarce, zanim odpowie chmura.

### Zapis wraca z powodem rozmiar

Stan po zakodowaniu ma więcej niż 64 KB. Zapisuj tylko to, czego trzeba do odtworzenia gry, a nie całą scenę.

## Częste pytania

### Czy gracz potrzebuje konta, żeby zachować postęp?

Nie. Bez konta postęp należy do tej przeglądarki. Z kontem idzie za graczem na każde urządzenie, a kopia zapisana w tej przeglądarce przed zalogowaniem przechodzi na konto.

### Co się dzieje, gdy dwa urządzenia zapisują naraz?

Wygrywa ostatni zapis w chmurze. Kopia z przeglądarki, której serwer jeszcze nie potwierdził, idzie do chmury tylko wtedy, gdy w międzyczasie nie zapisało inne urządzenie, więc starsza kopia nigdy nie nadpisze nowszego postępu.

### Czy gracze zobaczą moje testowe zapisy z podglądu?

Nie. Podgląd ma własne miejsce, które otwierasz tylko ty i moderatorzy klyo, i znika ono razem z podglądem.

## Powiązane instrukcje

- [Jak dodać tablicę wyników do gry HTML5](https://games.klyo.pl/pl/wsparcie/tablica-wynikow/)
- [Jak wydać grę HTML5 na klyo games](https://games.klyo.pl/pl/wsparcie/jak-wydac-gre-html5/)
- [Jak wydać nową wersję gry i wrócić do poprzedniej](https://games.klyo.pl/pl/wsparcie/nowa-wersja-gry/)
- [Wszystkie instrukcje](https://games.klyo.pl/pl/wsparcie/)

Nadal coś nie działa? Napisz na [kontakt@klyo.pl](mailto:kontakt@klyo.pl) i podaj adres gry. Odpowiada człowiek, w dwa dni robocze.

---

Źródło: https://games.klyo.pl/pl/wsparcie/zapis-postepu/ · 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