Skip to content
Docs

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:

WhatWho writes itWhere you see it
HistoryThe launcherOn the game card, under "Your history"
Best recordsThe game, when a match endsOn the start screen, on the end panel and on the game card
ProgressThe game, when it wants to remember something between matchesInside 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."

The history of an imported game, after winning it once

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:

WhatHow much
The data the game savesUp to 64 KB
The changes to the cube terrain: the blocks you break and place in an open-world gameUp 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%\greengames and only deletes the data of the WebView2 component from it (webview/). On Linux, instalar.sh --quitar does not touch the data folder. On macOS, moving the app to the Trash does not either.
  • Deleting everything on Linux: instalar.sh --quitar --datos removes 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.

SystemData 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.

Next#