/gastropoda

Game for the Fall 2022 semester of PantherDev game club at GSU

Primary LanguageC#

๐ŸŒ Gastropoda

Welcome to Gastropoda's ๐ŸฑGitHub page!

Stars Badge GitHub contributors Pull Requests Badge Issues	 Badge Hits Badge Repo Size Badge

๐Ÿ”ฝ Download

To download the latest version of Gastropoda, go here and unzip the folder (Windows, Mac, or Linux) after downloading.

๐ŸŽฎ Game Description:

Gastropoda is a 2D platform game that challenges players to overcome obstacles as the misunderstood Snail hunts the lab experiment down. Our hero will be challenged to climb up and down walls, run in dark environments, and use special abilities such as power-ups and weapons across maps. The player's goal is to outpace the Snail and other enemies while reaching for the time-traveling spears that reset the clock for the hero to return to their universe. Although the Snail is slow, it can be challenging to achieve its death.

๐Ÿ“– Backstory:

With the pandemic nearing an end, money and greedy actors are determined to descend the world into chaos. Massive corporations such as the World Health Organization and other medical institutions raced to administer the first vaccine into the global fight against the deadly virus; the winner would be rewarded a fortune; unfortunately gullible citizens across the globe voluntarily took part in a series of test trials run by American Aid Organization A.A.O, a wealthy private, clinically approved institution based in Atlanta, Ga, designed by the wealthy to control the distribution of vaccines. A.A.O recognized and contained a gifted volunteer equipped with a special telepathic connection to wildlife. In a desperate attempt to beat W.H.O of the first vaccine, A.A.O scientists conducted unethical biological experiments to unveil the linked powers to the vaccine. During a test that goes wrong where the telepathic connection to animals takes a turn as they become hostile toward everyone. The Volunteers flee to escape the lab. In addition, he discovers that he has extra powers. One of the powers he finds is the ability to tear open a portal across timelines leading him to activate strange abilities out of random; however, the Volunteer learns that the power can guide him to safety. Far away from the failed mutated experiment via time-traveling channels. The Volunteer will end up in a timeline 15 years in the future where A.A.O bested the race appearing as a dominant force in the future. At the same time, the Snail lurks not far behind.

๐Ÿ•น๏ธ Gameplay System:

Player spawns on the map via bifrost and is given a grace period of 10 seconds before the Snail spawns. There will be no obstacles at spawn. The main threat would be the Snails ability to level up speed every 60 seconds. Obstacles stopping the player are walls, water, locked doors, wired traps, and switch handles, debris. The winning condition is to move onto the next round of maps.

๐Ÿ“œ Rules:

  1. Players aren't allowed to travel outside of maps, penalty will result in immediate death.
  2. Players can die from fall damage.
  3. Players are only given a 12 second grace period from spawn before the snail spawns in game.
  4. Players are given a maximum of 2 weapons in the (laboratory level 1) and ancient egypt level. This rule is subject to change
  5. players are given a maximum of 4 weapons on the WW2 (Theme 3). This rule is subject to change
  6. players are given a maximum of 12 weapons on the (theme 4). This rule is subject to change
  7. Every 60 seconds the snail increases speed by 2x with an additional 20 health points to the health bar.
  8. Guns have a limited amo, and swords have limited hit uses
  9. No in game currency
  10. Player can only gain health by obsobering the mini hearts, big hearts
  11. Player can only throw swords
  12. Power-ups are limited to 10 seconds max. This rule is subject to change
  13. Invisibility power-up: invisible to enemies but can still take damage works like a token
  14. Shield power-up: activates when present in the inventory by a hit or potential death sequence. can also activate whenever player wants.
  15. Time power-up: Freezes everything, time motion, enemies, objects within scene except the player. The entire screen should have a hue/chromatic/Ambit effect to indicate its activation.
  16. Rules may continue to be added as the game progress.

๐ŸŽฏ Core Mechanics:

  1. ๐ŸŒ Snail

    a. Moving up, Down, Side

    b. Travel via pipeps

    c. Special slime attack: shooting slime at player before death.

    d. Special range attack: shooting a continues slime across map before death.

    e. jumping

  2. ๐ŸŒ๐ŸŒ๐ŸŒ Mini Snails

    a. Moveโ€™s in a single direction

    b. low view range

  3. ๐ŸŒ๐ŸŒ Middle Snail

    a. Moves in a single direction with more health points and is faster than mini snails. 4. Player a. (WASD)

    b. Running, walking, jumping, sliding, climbing

    c. Equip items into inventory

    d. Use power-ups

    e. Throwing

    f. Placing/ toggling interactive world objects

    g. Double jump: allows the player to slightly glide

  4. ๐Ÿ„ Power-Ups

    a. Invisibility power-up: invisible to enemies, but can still take damage, last 10sec.

    b. Shield power-up: activates when present in the inventory by a hit or potential death sequence. can also activate whenever player wants, last 10 sec.

    c. Time power-up: Freezes everything, time motion, enemies, objects within scene except the player. The entire screen should have a hue/chromatic/Ambit effect to indicate its activation, last 10 sec.

๐ŸŽฌ Key Animations

Features

๐Ÿ’ก running animation, Climbing animation, shooting animation, grabbing animation, sliding animation, falling animation, falling death animation, jumping animation, Hero's signature landing stance ๐Ÿ’ก power up activation, bifrost animation, double jump, snail slime attack, snail range attack.

๐Ÿ—บ๏ธ Level Design

  1. 2D side view
  2. Four levels with multiple themes from Modern day Laboratory, Ancient Egyptian, WW2 trench, Cyberpunk balcony.
  3. The levels will be your basic platformer similar to fallout shelter, celeste
  4. The main purpose of the game is to have the player try to overcome obstacles fast enough to not be caught by the ever-approaching snail, so the levels will be built with that in mind.
  5. The levels will progress throughout history, as the main character tries to live for eternity. The theming and design of the levels will mirror the time period. For example:
  6. First theme will be in the collapsing Laboratory.
  7. Ancient egyptian theme will be in a pyramid indiana jones style.
  8. A WW2 theme will be centered around the debris of live fire in the trenches.
  9. Final level will be cyberpunk theme on a balcony.
  10. Each level will have familiar obstacles but the same simple platformer layout that relies on the playerโ€™s movement abilities to keep going. Think like geometry dash meets celeste.

๐ŸŽจ Art Style

Character will mumble like legos, no talking Character will look like fallout shelter with slight more detail

๐ŸŒ† Levels

  1. ๐ŸฅผLaboratory
  2. ๐Ÿ‡ช๐Ÿ‡ฌ ๐Ÿซ Ancient Egyptian
  3. ๐Ÿšฆ๐Ÿงช๐Ÿ‘น Cyberpunk

๐Ÿ‘ฅ Meet The Team!

๐Ÿ‘จโ€โ€โœˆ๏ธ๐Ÿ‘ฉโ€โ€โœˆ๏ธ Coordination:

  • Brandon - Lead || 2D || Art || Artist || College || Music
  • Laura - Co-Lead || Artist || College || Developer

๐Ÿ‘จโ€๐Ÿ’ป๐Ÿ‘ฉโ€๐Ÿ’ป Programmers:

  • Jimmy - College || Developer || Programmer ||
  • Quang - Developer || Programmer
  • Tony - Developer || Programmer
  • Sagar - Developer || Programmer
  • Avvai - Developer || Programmer
  • Shana - Developer || Programmer
  • Sanat - College || Developer || Programmer
  • Sara - Programmer
  • Marc - Programmer
  • Unnamed - College || Developer || Programmer

๐Ÿ‘ทโ€โ€โ™‚๏ธ๐Ÿ‘ทโ€โ€โ™€๏ธ Audio:

  • Vaughn - Artist || Music
  • Sriram Mohan - 2D || Artist || College || asset || lead
  • Caleb - Artist || Audio || College || sound effects

๐Ÿ‘จโ€๐ŸŽจ๐Ÿ‘ฉโ€๐ŸŽจ 2D Artists:

  • Sidney - 2D || Artist || Lead
  • Oliva - 2D || Artist
  • Yuna - 2D || Art || Artist
  • Janice - 2D || Artist
  • Audrey - 2D || Art || Artist || College
  • Nicolette - Artist || College || ui || ux
  • Unnamed - 2D || Animation || Art || Artist
  • Unnamed - 2D || Animation || Art || Artist
  • Unnamed - 2D || Art || Artist
  • Unnamed - 2D || Architect || Art || Artist

๐Ÿ’ป (Programmers) How to contribute

  • Programmers meet in the library from 12:30pm to ~2:00pm on Wednesday every week.
  • We also meet on Fridays in the CMII building before the weekly PantherDev meeting, but it's not required.

๐Ÿ‘พ Install Unity Hub And Unity Editor

  1. Sign up for Unity Student Edition: https://api.unity.com/v1/oauth2/authorize/student?student_type=university

  2. Download and install Unity Hub: https://public-cdn.cloud.unity3d.com/hub/prod/UnityHubSetup.exe

  3. Open Unity Hub. Log in. Click โ€œinstall Unity Editorโ€ when it asks:

    A3

  4. Click the โ€œprojectsโ€ tab on the left. Then click โ€œnew projectโ€

    A4

  5. Click All Templates > 2D

    A5

  6. Find the project we just created, click the 3 dots on the right, click โ€œShow in Explorerโ€

    A6

  7. Open the project file, keep this open for later

    A7

๐Ÿฑ Set Up Github Desktop

  1. Download: https://desktop.github.com/

  2. Create a github account: https://github.com/join

  3. Open GitHub Desktop and log in. Go to File > Clone Repository > URL

    B3

  4. Enter the URL: https://github.com/aimbesi1/gastropoda

    B4

  5. Now click Repository > Pull

    B5

  6. Now click Repository > Show in Explorer

    B6

  7. Now, we need to copy the assets folder from the GitHub folder into the Unity Project folder

    B7

  8. Click โ€œReplace the files in the destinationโ€

    B8

๐Ÿ‘พ Opening The Project

  1. Click the project file

    C1

๐Ÿ“‹ How To See Your Tasks With Asana

  1. Sign up for Asana: https://asana.com/create-account

    a. Use your GSU email to create the account D1

  2. Message Brandon to get invited to the project

    a. You can try this link: https://app.asana.com/0/1202908827085557/1203075958094008

  3. Check your assigned tasks

    D4

  4. You must complete the tasks in the Unity Editor and then mark them as complete in Asana

๐Ÿฑ How to push your changes to GitHub

(Section will be updated with photo guides soon) ๐Ÿ†˜ Note: If you are new, ask one of the other programmers for assistance if this is not clear

  1. Open GitHub Desktop

  2. Open the file in File Explorer

  3. Delete the old โ€˜Assetsโ€™ folder

  4. Open Unity Hub and open your project folder in File Explorer

  5. Copy the โ€˜Assetsโ€™ folder from the Unity project, paste it into the GitHub folder

  6. Push your code as a new branch, or push your changes to a currently existing branch