explaingit

vickscarlet/liferestart

10,401JavaScriptAudience · generalComplexity · 2/5Setup · moderate

TLDR

A browser-based life simulation game where you replay a fictional life with different random outcomes, built in JavaScript with game content driven by editable spreadsheet data.

Mindmap

mindmap
  root((Life Restart))
    What it does
      Life simulation game
      Browser-based
      Replay life outcomes
    Setup
      pnpm install
      Spreadsheet to JSON
      Local dev server
    Also runs
      Command-line version
      Cocos port exists
    Content
      Event-driven
      Data in spreadsheets
      Chinese and English
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Play a browser-based life simulation game locally after a quick setup.

USE CASE 2

Mod the game by editing the spreadsheet data files that define life events and outcomes.

USE CASE 3

Run the game in a terminal via the command-line version without a browser.

USE CASE 4

Fork and adapt the game to another engine, as community members have already done with Cocos.

Tech stack

JavaScriptpnpm

Getting it running

Difficulty · moderate Time to first run · 30min

Requires pnpm and a manual spreadsheet-to-JSON conversion step before the game will run.

In plain English

Life Restart is a browser-based game written in JavaScript. The concept, suggested by both the repository name and the Japanese description (which translates roughly to "do it over again, and this time do it right"), is a life simulation where you can replay or restart a fictional life with different outcomes. The project was originally created in Chinese and has an English interface as well. The game runs in a web browser. To set it up locally, you clone the code, install dependencies using a package manager called pnpm, run a conversion step that processes spreadsheet data into JSON format, and then start a local development server. Once running, you open a browser and visit a local address to play. There is also a simpler command-line version that runs directly in a terminal without a browser. The README is brief and points to a separate documentation site for fuller instructions. A Discord community exists for players and contributors. At least one community-made port exists, rebulit in the Cocos game engine, suggesting the project attracted enough interest for others to adapt it to different platforms. Because the README contains very little detail about gameplay mechanics, this description is limited to what the source files and project structure reveal. The data for the game appears to be stored in spreadsheet files that get converted to JSON at build time, which is an unusual setup that suggests the game content, such as life events and outcomes, is driven by editable data rather than hardcoded logic.

Copy-paste prompts

Prompt 1
I want to run the liferestart game locally, give me the exact pnpm commands to install dependencies, convert the spreadsheet data, and start the dev server.
Prompt 2
How do I add a new life event to the liferestart game by editing the spreadsheet data files?
Prompt 3
Explain the data pipeline in liferestart: how do the spreadsheet files get converted to JSON and loaded into the game?
Prompt 4
I want to fork liferestart and change the life outcomes, which files should I edit and what format does the data use?
Open on GitHub → Explain another repo

← vickscarlet on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.