Hunger Games Simulator

I made a text- and image-based simulation that allows users to recreate the Hunger Games in their browser, developed with HTML, CSS, and JavaScript as languages, React as a framework, and GitHub Pages for deployment. This began as a personal project, but I decided to update and publicize it so others could try it out. Its original purpose was to entertain myself, but now others can join in on the fun.

You can visit my project here: code icon Cherrow's Hunger Games Simulator

You can view the source code for my project here: github icon Cherrow's Hunger Games Simulator Repository
It is hosted on my second GitHub account. Cherrow is one of the usernames I use to stay anonymous online.

The Hunger Games is a popular trilogy of novels written by Suzanne Collins, where contestants (tributes) fight in a large arena full of treacherous terrain until only one is left standing. Inspiration for this project began while I was playing with a Hunger Game simulator hosted at brantsteele.net. It puts 24 tributes in an arena, and they participate in randomized events until a winner is chosen. Here is a link to the original simulator created by the Brantsteele staff: Brantsteele's Hunger Games Simulator. It's one of my favorite websites, but I didn't like how some features were designed:

To solve these problems, I decided to customize and expand their simulator by recreating it from scratch. Here is what the homepage looks like:

24 tributes compete in the Hunger Games, with 2 characters in each of the 12 districts. A common misconception is that tributes in the same district are always teammates, but this isn't true because there can only be one winner. My simulator's appearance is similar to Brantsteele's style, but mine is a lot more simplistic. The middle of the website displays every tribute's name and profile picture. Users can edit these through the use of the white input boxes found at the bottom of the website. Next to the input boxes, users can read a full tutorial on how to use my website and how it works internally. Near the top left corner, there is a reset button. When pressed, all tribute names and profile pictures are reset to the default ones I have provided. Underneath the grid of tributes, there is a proceed button that begins the simulation.

Hunger Games Simulator Screenshot 1

Here is an example of what the simulation could look like:

Hunger Games Simulator Screenshot 2 Hunger Games Simulator Screenshot 3

Tributes participate in randomly chosen events until only one is left standing. A tribute is eliminated when their health drops to 0. Tributes have an attack stat, which determines how much health they can remove from others. There are many different kinds of events, and most of them will change the outcomes of future events. Some events that do nothing, increasing the randomness of the simulation. Here are some examples:

The Development Process

My website is not perfect, and there are many limitations. I didn't want to spend money on hosting my website, so I learned how to deploy it for free on GitHub Pages. However, GitHub Pages only hosts static websites for free, so I am unable to allow users to store their custom tributes' information. Users must recreate their custom tributes every time they reload or come back to my website. In addition, users aren't able to create their own events, or edit the default ones. Originally, I designed my website without the intentions of letting other people use it, so I have not implemented the ability for users to edit events without changing the source code. In the future, I might add this feature.