Repolode
Submit
setube

setube/taoyuan

A text-based farming and life sim set in a Chinese-style village, inspired by Stardew Valley, built with Vue 3 and TypeScript for the browser.

Open-source alternative to:Stardew Valley

View on GitHubWebsite
Stars
586
Forks
86
Open issues
0
Last commit
8 days ago

What is it?

Taoyuan Village (桃源乡) is a browser-based farming simulation game in which the player inherits a plot of land from a late grandfather and works to revive a remote mountain village. It combines crop rotation across four seasons, animal husbandry, fishing, mining with turn-based battles, cooking, crafting machines, breeding, and a museum collection, alongside a roster of villagers who can be befriended and married.

The game uses a text-driven interface with pixel-style visuals and a Chinese-inspired palette. Its music is synthesized in real time with Tone.js, using a pentatonic scale, and weather and time of day change the sound. Saves are stored in localStorage with AES encryption, with import/export and optional WebDAV sync.

The codebase is written in TypeScript with Vue 3, Pinia for state, TailwindCSS for styling, and Vite for builds. It can be run locally with Bun, deployed as a Docker image, or packaged as an Electron desktop client.

Key features

  • 01Four-season farming with 38 crops, greenhouse planting and fruit trees
  • 02Fishing mini-game across six fishing spots with 60 fish species
  • 03Turn-based mining through 120 floors with boss battles every 20 floors
  • 04Villager relationships, gift giving, marriage and hidden immortal NPCs
  • 05Cooking with 113 recipes and processing machines for crafting
  • 06Real-time procedural soundtrack built with Tone.js

Use cases

  • Playing a relaxed farming sim directly in the browser without installation
  • Studying a Vue 3 and Pinia project with a large, data-driven game structure
  • Running a self-hosted copy of the game with Docker
  • Packaging the game as a desktop app with Electron

Quick start

  1. 1

    Install dependencies

    bun install
  2. 2

    Start the dev server

    bun dev
  3. 3

    Build for production

    bun run build

Things to know

  • Licensed CC BY-NC 4.0, so commercial use requires the author's written permission.
  • The license metadata reads NOASSERTION, so the README license is the authoritative source.

Topics

#browser-game#farming-simulation#text-game#pixel-art#vue3#typescript#indie-game#chinese-style#pinia#stardew-valley

FAQ

What is taoyuan?
A text-based farming and life sim set in a Chinese-style village, inspired by Stardew Valley, built with Vue 3 and TypeScript for the browser. Taoyuan Village (桃源乡) is a browser-based farming simulation game in which the player inherits a plot of land from a late grandfather and works to revive a remote mountain village. It combines crop rotation across four seasons, animal husbandry, fishing, mining with turn-based battles, cooking, crafting machines, breeding, and a museum collection, alongside a roster of villagers who can be befriended and married.
Is taoyuan free to use? What license does it have?
taoyuan is open source under the Other license. Check the license terms before using it in commercial products.
Is taoyuan still maintained?
Actively maintained. The last commit to taoyuan was on Oct 12, 2026.
What can I use taoyuan for?
Playing a relaxed farming sim directly in the browser without installation Studying a Vue 3 and Pinia project with a large, data-driven game structure Running a self-hosted copy of the game with Docker Packaging the game as a desktop app with Electron
How do I install taoyuan?
Install dependencies: bun install Start the dev server: bun dev Build for production: bun run build
Where can I get taoyuan?
The source code and installation instructions are on GitHub: https://github.com/setube/taoyuan

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects