Skip to content

ajdemarco95/Santas-Christmas-Cookies

Repository files navigation

Santa's (Lilly's) Christmas Cookies

About the Game

Welcome to "Santa's (Lilly's) Christmas Cookies" - an adventurous and humorous Christmas-themed game where you play as Lilly, a fun-loving dog at the North Pole. Santa has lost his Christmas cookies and needs Lilly's help to find them. However, there's a twist! Instead of returning them, Lilly ends up eating the cookies, adding a funny and unexpected element to the game.

About Lilly

Fun fact - Lilly is actually my dog in real life! She's expressed much joy this holiday season knowing us humans are playing as her in a video game!

Picture of Lilly Picture of Lilly

Built With

  • React-Three-Fiber: For rendering 3D models and animations.
  • React-Three-Drei: Provides useful helpers for React-Three-Fiber.
  • ECCTRL: A control system used for character movement.
  • Vite: Modern frontend tooling, offering fast build times.
  • Netlify: For seamless hosting and smooth gameplay experience.

Inspired by Bruno Simon's ThreeJS Journey

The development of "Santa's (Lilly's) Christmas Cookies" was heavily inspired by Bruno Simon's ThreeJS Journey course. This course provided invaluable insights and instructions on how to effectively utilize libraries such as React-Three-Fiber and React-Three-Drei. Bruno Simon's teachings have been instrumental in shaping the 3D interactions and animations that brought my game to life. For anyone looking to dive deep into the world of ThreeJS and 3D web development, I highly recommend this course.

Game Controls

  • WASD: Move Lilly around.
  • Shift: Hold to make Lilly sprint.
  • Spacebar: Press to make Lilly jump.

Gameplay

Navigate through the whimsical North Pole, exploring various locations to find the missing cookies. Be quick and agile, as Lilly loves to eat the cookies! Each cookie adds points to your score, but remember, Santa is waiting for them too!

Installation and Running the Game

# Clone the repository
git clone https://github.com/ajdemarco95/Santas-Christmas-Cookies

# Install dependencies
npm install

# Run the game
npm run dev

The game will be available on localhost:3000 (or your specified port).

Roadmap

I have some more ideas that would make "Santa's (Lilly's) Christmas Cookies" more engaging and fun. Here are some upcoming features:

  • Mobile Responsiveness: Ensuring the game is playable and looks great on various mobile devices.
  • Falling Snow: Adding a dynamic snowfall effect to enhance the wintry atmosphere of the game.
  • Night Mode: Introducing a night-time version of the game world for a different visual experience.
  • Enemy Characters: Implementing mischievous characters to add more challenges and excitement to Lilly's adventure.

Stay tuned for these updates!

Contributing

Interested in contributing to Santa's (Lilly's) Christmas Cookies? Great! We welcome contributions. Please read our contributing guidelines before submitting your pull request.

License

This project is licensed under the MIT License.

Attribution

Thank you to Poly.pizza for many of the 3D assets, as well as Sketchfab and Turbosquid. Without these assets the game would have taken 10x longer to develop!

Acknowledgments

  • Santa Claus for the inspiration!
  • All the elves at the North Pole for their support.
  • Bruno Simon for his inspirational ThreeJS Journey course.

About

Santa has lost his Christmas cookies and needs Lilly's help to find them!

Resources

Stars

Watchers

Forks

Releases

No releases published