Skip to content

README.md

Latest commit

 

History

History
59 lines (39 loc) · 1.5 KB

README.md

File metadata and controls

59 lines (39 loc) · 1.5 KB

Animal Farm Simulator — Group 26

UTS 2025-01 Graphic Design · Assignment 2

Three.js React License: MIT

A browser-based 3D farm simulator built with Three.js and React. You can place animals, buildings, and props on a grid, and switch between seasons and weather in real time.

Hero Screenshot

Features

  • Seasons — Spring petals, Summer fireflies, Autumn leaves, Winter aurora (GLSL shader)
  • Weather — Sunny, Cloudy, Rain, Snow, Storm with lightning
  • Night mode — Moon orbit + Aurora Borealis (winter only)
  • Object placement — Click to place/delete models on a snapping grid
  • Terrain expansion — Grow the map with Space

Getting Started

cd Projects
npm install
npm run dev   # → http://localhost:5173

Controls

Key Action
1 2 3 4 Spring / Summer / Autumn / Winter
Q W E R T Sunny / Cloudy / Rain / Snow / Storm
N / D Night / Day
Space Expand terrain

Stack

Three.js r182 · React 19 · TypeScript 5 · Vite 7 · Custom GLSL shaders

Environment (optional)

# Projects/.env
VITE_OPENWEATHER_KEY=your_key

Enables live weather sync via OpenWeatherMap. Works fine without it.