Plant Root Simulator

โฌ…๏ธ Back to Projects

๐Ÿ“‹ TLDR: Interactive Plant Biology Simulation

  • ๐ŸŒฑ Root Growth Control: Navigate and grow your plant root system underground
  • ๐ŸŽฏ Strategic Resource Management: Collect water and nutrients while balancing energy
  • ๐ŸŒฟ Branching Mechanics: Create strategic branches for optimal exploration
  • ๐Ÿ–ฅ๏ธ Web-Based Game: Play directly in your browser, desktop optimized
  • ๐ŸŽ“ Educational: Learn about plant biology through interactive gameplay

Key Technologies:

  • ๐ŸŽจ Three.js for 3D underground visualization
  • ๐ŸŒ Interactive root navigation and growth
  • ๐Ÿ“ฑ Desktop-focused design
  • โ™ฟ Keyboard and button controls

๐ŸŒฑ Plant Root Simulator ๆค็‰ฉๆ น็ณปๆจกๆ‹Ÿๅ™จ

๐ŸŒ Overview

Plant Root Simulator is an engaging and educational desktop webpage that puts you in control of a growing root system. Navigate through the underground environment, create branches, and strategically explore to collect nutrients and water while managing your energy.

๐Ÿšงย Currently only works on Desktop! ๐Ÿšง

๐ŸŽฎ Gameplay

In this unique simulation, you control a root system with the goal of surviving and thriving. Explore the underground world, create branches, and balance your resources carefully.

๐ŸŽฏ Key Features

  • ๐Ÿƒโ€โ™‚๏ธ Intuitive root movement
  • ๐Ÿ“Š Resource management (water and energy)
  • ๐ŸŒฟ Branch creation mechanics
  • ๐Ÿง  Challenging gameplay with strategic decision-making

๐Ÿ•น๏ธ Controls

โŒจ๏ธ Keyboard Controls

  • โฌ†๏ธโฌ‡๏ธโฌ…๏ธโžก๏ธ Arrow Keys or WASD: Move root
  • ๐Ÿ”„ Q/E: Move up/down
  • ๐ŸŒฟ Space: Create new branch
  • โธ๏ธ P: Pause/Resume
  • ๐Ÿ”„ R: Restart game

๐Ÿ“ฑ Mobile Controls

  • ๐ŸŒฟ New Branch Button: Create a new root branch
  • โธ๏ธโ–ถ๏ธ Pause/Start Button: Pause or resume the game

๐Ÿ› ๏ธ Technology

  • ๐ŸŽจ Graphics: Three.js for 3D rendering
  • ๐Ÿ’ป Language: JavaScript
  • ๐ŸŒ Platform: Web-based game

๐Ÿš€ How to Play

  1. ๐Ÿƒโ€โ™‚๏ธ Start the game by moving your root
  2. ๐Ÿ’ง Collect water and energy
  3. ๐ŸŒฟ Create branches strategically
  4. ๐ŸŒฑ Survive and grow your root system

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. ๐Ÿด Fork the repository
  2. ๐ŸŒฟ Create your feature branch (git checkout -b feature/AmazingFeature)
  3. ๐Ÿ’พ Commit your changes (git commit -m 'Add some AmazingFeature')
  4. ๐Ÿ“ค Push to the branch (git push origin feature/AmazingFeature)
  5. ๐Ÿ”„ Open a Pull Request

๐ŸŽจ Roadmap

  • ๐Ÿงช Add more complex nutrient mechanics
  • ๐Ÿ“ˆ Implement difficulty levels
  • ๐Ÿ”Š Add sound effects and background music

๐ŸŒŸ Credits

  • Inspired by the fascinating world of plants

๐Ÿ“„ License

Distributed under the GNU Affero General Public License v3.0 License. See LICENSE for more information.