DEV Community πŸ‘©β€πŸ’»πŸ‘¨β€πŸ’»

Cover image for Nyan Cat or Giga Cat Epic Game
Gourav Singh Rawat
Gourav Singh Rawat

Posted on • Updated on

Nyan Cat or Giga Cat Epic Game

Nyan Cat Game

Nyan cat game is actually a music rhythm based game 🎢 I.e you start with a decent difficulty as the music in start is decent and it expect you to pass through it, after a few tries at least.
Once you pass through the first phase of the game, you'll enter a Panic event phase, where it gets real exciting 🎸. Panic event can start anytime above the score of 50 pts.

Why this?

After participating in 4 previous Hackathons (actually winning non of them :P), I decided to do something really entertaining & crazy. So I came up with this idea to make a web game using Redis as a primary database. Thanks to RedisOm it got really easy to do this.
Easy to use thanks to the documentation, it was a fun project to work on, and really think it's a Wacky Wildcard Project :P.

Submission Category:

Wacky Wildcards

Languages used:

JavaScript(Next.Js) & Css

Screenshots πŸ“·

Demo-1
Demo-2

Check out these Demo clips of the game 🀯

Img_1

Img_2

Img_3

Img_4

Overview video πŸŽ₯

Here's a short video that explains the project and how it uses Redis:

YouTube video

GitHub logo Seek4samurai / project-giga-cat

Nyan cat game with MetaMask authentication for Web 3.0 ecosystem. Made out of Next.js & Moralis. Database powered by @redis

Nyan Cat Game

Nyan cat game is actually a music rhythm based game 🎢 I.e you start with a decent difficulty as the music in start is decent and it expect you to pass through it, after a few tries at least Once you pass through the first phase of the game, you'll enter a Panic event phase, where it gets real exciting 🎸. Panic event can start anytime above the score of 50 pts.

Why this?

After participating in 4 previous Hackathons (actually winning non of them :P), I decided to do something really entertaining & crazy. So I came up with this idea to make a web game using Redis as a primary database. Thanks to RedisOm it got really easy to do this Easy to use thanks to the Redis documentation, it was a fun project to work on, and really think it's a…

How it works πŸ€”

When it comes to working of this game, it comes down to a web application. Here I've created a Next app using npx create-next-app. Metamask wallet address for user Authentication, this app uses Next.js framework with Moralis SDK and Redis for querying & storing data into Redis cloud.
Here game is rendered using HTML5 canvas.

How the data is stored: πŸ€”

In this application, I've something called Redis-om for Node.js.
Here data is stored in the form of JSON where following schema is created

class Score extends Entity {}

const schema = new Schema(
  Score,
  {
    name: { type: "string" },
    address: { type: "string" },
    score: { type: "number", sortable: true, textSearch: true },
  },
  { dataStructure: "JSON" }
);
Enter fullscreen mode Exit fullscreen mode
export const createScore = async (data) => {
  await connect();

  const repository = client?.fetchRepository(schema, client);

  const score = repository.createEntity();
  score.name = data.name;
  score.score = data.score;
  score.address = data.address;

  const id = await repository.save(score);

  const ttlInSeconds = 21600;
  await repository.expire(id, ttlInSeconds);

  await client.close();
  return id;
};
Enter fullscreen mode Exit fullscreen mode

Notice I've also declared something as const ttlInSeconds = 21600; and then used it in await repository.expire(id, ttlInSeconds); because we don't want to store any data longer than 6 hours. Yes, your scores will reset after 6 hours.
Once this is done, we can create an API route in our Next.js application.

import { createScore } from "../../lib/redis";

export default async function handler(req, res) {
  const id = await createScore(req.body);
  res.status(200).json({ id });
}
Enter fullscreen mode Exit fullscreen mode

Once we create it in our database, it will be stored in our database by giving data from our frontend, I've used javascript's fetch API for this purpose. You can check this file, where I've declared such logic.

How the data is accessed: πŸ€”

Now if you've gone through the application, there is a section of leaderboard, where we have scores and addresses or usernames of players with highest pts.
To access our database and then fetch it from our Redis database, we have couple of ways like...

In our development phase, I've used Redis Insight, importing my database using public endpoint & password.

But in our application I've used .env.local file to store all API keys.
Once that is done, in our redis.js file we create a redis instance also called Client() like:

import { Client } from "redis-om";

const client = new Client();

const connect = async () => {
  if (!client.isOpen()) {
    await client.open(process.env.NEXT_PUBLIC_REDIS_URL);
  }
};
Enter fullscreen mode Exit fullscreen mode

Now once this is setup, we use fetch API to query for data.

  const fetchScores = async () => {
    const res = await fetch("/api/search?" + query);
    const results = await res.json();
    return results["scores"];
  };
Enter fullscreen mode Exit fullscreen mode

To do this, we also need to create an index using await repository.createIndex(); and then we can create another API route to call this.

import { createIndex } from "../../lib/redis";

export default async function handler(req, res) {
  await createIndex();
  res.status(200).send("Index is created");
}
Enter fullscreen mode Exit fullscreen mode

Then we use a custom function searchScore() to get the data of top-3 players with highest scores, we used RediSearch for that purpose.

export const searchScore = async () => {
  await connect();

  const repository = client.fetchRepository(schema, client);

  const offset = 0;
  const count = 3;

  const scores = await repository
    .search()
    .sortDesc("score")
    .return.page(offset, count);

  return scores;
};
Enter fullscreen mode Exit fullscreen mode

This will get us the data we want. And we can get that data using API route as search.js

import { searchScore } from "../../lib/redis";

export default async function handler(req, res) {
  const data = req.query;
  const query = Object.keys(data)[0];

  const scores = await searchScore(query);
  res.status(200).json({ scores });
}
Enter fullscreen mode Exit fullscreen mode

You can check this file, where I've declared such logic.

One more thing is that we are also displaying the top-3 players in the Home page of the Game. Let's dig it...
So we're doing something similar to what we did above I.e.

const fetchScores = async () => {
    const res = await fetch("/api/search?" + query);
    const results = await res.json();
    return results["scores"];
};
Enter fullscreen mode Exit fullscreen mode

Fetching score as an Object. Then in our separate Marq.jsx component we are using it as:

<span>
    {score[0]?.name ? score[0]?.name : `${score[0]?.address?.slice(0,9)}...${score[0]?.address?.slice(39)}`}
</span>
Enter fullscreen mode Exit fullscreen mode

Refer to Using RediSearch.

Hope everything was clear, and if not consider checking the video. If still stuck on something feel free to contact me over my any of the social handle, I'll be happy to help you :)

How to run it locally? πŸ’»

Requirements πŸ“

  1. Node.js - Expected version ">=14.17.0". If you need help in installing on Linux like me Check out.
  2. Yarn - 1.22.19 (I used).
  3. Metamask installed on Browser - Download here

You'll need Metamask account to pass Authentication πŸ“

Demo-Image

Follow these steps to run on your device after Cloning the repository and cd project-giga-cat to enter the root project folder.

  1. First things first, use yarn install to install all the dependencies.
  2. In root directory of the repo, create a file .env.local and declare 3 env variables. But before that go to Moralis.io & Redis and create a free account over both.
  3. In Moralis dashboard, click on Create new Dapp and select the Environment Testnet and under testnets select ETH Goerli testnet. Select a region and give a cute name, finally proceed with it.
  4. Now, create a subscription in your Redis Cloud and then create a database for yourself. Make sure to save their details.
  5. In your .env.local, create 3 variables as: NEXT_PUBLIC_MORALIS_SERVER_URL NEXT_PUBLIC_MORALIS_APP_ID NEXT_PUBLIC_REDIS_URL and give them their values.
  6. For Moralis, go to settings of your Dapp, and copy the Dapp URL for SERVER_URL & Application ID for APP_ID.
  7. For Redis, go to your database and from Security section copy the user password, and also take the public endpoint from General section. Now paste them in the .env.local file, formatted as NEXT_PUBLIC_REDIS_URL=redis://default:password@endpoint:port. Note: port should be appended at the last of your public endpoint.
  8. Now run yarn run dev to run the application.
  9. Go to http://localhost:3000/ and you'll see the Connect Wallet page.
  10. Click on Connect wallet and for signing in, Metamask should've popped up. And you'll enter the dashboard.

If you've find any difficulty in this, Check my video! πŸ”₯

If you notice anything unusual try refreshing the page. If it doesn't fixes the behavior, please create a issue in Github :)

πŸ’₯ New Update : Users can now have their temporary usernames πŸ’₯

Thanks to a Redis feature -> TimeToLive or ttl, users can assign themselves a temporary username for purpose of few hours till their scores exist. Check & read docs for more information.

Deployment πŸš€

Deployment is done using Vercel.

Stuck? πŸ€”

Feel free to contact me through anywhere, LinkedIn, Gmail, or leave a create a Github issue.

MIT

Each Soundtracks completely belongs to the respective artist & I don't own them at all.

Hope you liked the project ❀️ and let's wait till the results 🀞🀞

Made with ❀️ & Redis

Top comments (7)

Collapse
seek4samurai profile image
Gourav Singh Rawat Author • Edited on

Make sure to install Metamask in your browser and create an account.
It's easy and will hardly take 2 minutes :)

Hope you liked the project ❀️ and let's wait till the results 🀞🀞
Made with ❀️ & Redis.

Collapse
anshsaini profile image
Ansh Saini

interesting

Collapse
seek4samurai profile image
Gourav Singh Rawat Author

I did a lot of experimenting with this. Thanks :)

Collapse
mahakaal060 profile image
Arjun Mishra

Worth it!!!

Collapse
seek4samurai profile image
Gourav Singh Rawat Author

Thanks bruh!

Collapse
recaptchafailed profile image
recaptcha-failed

Game's amazing.
Where can I find songs used?

Collapse
seek4samurai profile image
Gourav Singh Rawat Author • Edited on

Thanks & here are the songs used...

🌚 Friends don't let friends browse without dark mode.

Sorry, it's true.