History and progress
What the launcher records about your matches, how best records work, what games save and what happens to all of it when you uninstall.
DescribesLauncher 0.4.0 For everyone
On this page
The launcher keeps three things for each game, all on your computer:
| What | Who writes it | Where you see it |
|---|---|---|
| History | The launcher | On the game card, under "Your history" |
| Best records | The game, when a match ends | On the start screen, on the end panel and on the game card |
| Progress | The game, when it wants to remember something between matches | Inside the game itself |
Your history#
Open a game card. The Your history section shows:
- Games finished: how many reached the end.
- Wins.
- Time played: it also adds the time of the matches you left halfway.
- Last played: date and time of the last time you played.
- Best records, per table and difficulty.
- Latest games, each with its date, its difficulty and its result: Win, Loss or Finished.
If you have not played, it says "You have not played yet. Your records will show up here."
Time played also adds up the matches you leave halfway; games finished and wins only count the ones that reach the end. That is why there can be time played with zero games finished: in an open world such as Open Valley that is the normal case. Best records and latest games appear once you finish at least one.
Best records#
Each game declares its tables: by points (the highest wins) or by time (the lowest wins). A game can have more than one.
- Each difficulty has its own list, of ten marks.
- When a match ends, the end panel says New record or "Rank N on your board" if the mark got in.
- The mark is saved under the name you have in Settings, in "Your name on the tables".
The tables are local: they only hold matches played on this computer. There are no global leaderboards.
Game progress#
A game can save data between matches: for example, how far you got. Each game decides that, and each one has its own space. A game cannot read what another game saved.
A game's space holds up to 384 KB of progress:
| What | How much |
|---|---|
| The data the game saves | Up to 64 KB |
| The changes to the cube terrain: the blocks you break and place in an open-world game | Up to 320 KB |
That way, an Open Valley world you save is still there the next time you open the launcher.
Everything is local#
None of this leaves your computer: the launcher has no accounts and no telemetry. For the same reason, your records do not sync with the portal or with another computer.
Everything lives in the launcher's data folder, in one folder per game. To take it to another computer or back it up, copy that folder: Settings.
When you uninstall#
- Uninstalling a game removes the game. The progress, the records (
guardado.json) and the history (historial.json) survive, and they also survive an update of the game. To delete them, check Also delete my progress and history in the notice that appears when you uninstall. - Uninstalling the launcher does not delete your games or your progress. On Windows, the uninstaller keeps
%AppData%\greengamesand only deletes the data of the WebView2 component from it (webview/). On Linux,instalar.sh --quitardoes not touch the data folder. On macOS, moving the app to the Trash does not either. - Deleting everything on Linux:
instalar.sh --quitar --datosremoves the whole data folder. It cannot be undone.
When you update the launcher#
Up to version 0.2.0 the data folder had a different name. Since 0.3.0, the first time you open the launcher, if that earlier folder exists and the new one does not exist yet, the launcher adopts it: your settings, your installed games, your history and your progress are still there. You do not have to do anything. This was tested on Linux and on Windows.
| System | Data folder from 0.3.0 on |
|---|---|
| Linux | ~/.config/greengames |
| Windows | %AppData%\greengames |
| macOS | ~/Library/Application Support/greengames |
A game you installed with an earlier version keeps its package under the name juego.gbx until the game is updated or you reinstall it. It plays just the same.
On Windows, a 0.2.0 installed with its installer is not removed automatically: Download and install.