chromesduzez / cis-350-project-1

Trash Pick - Up Simulator By: John Green, Zach Wilson, Lucas Johnson, Colin Gamagami, Devun Schneider

CIS-350 Project 1

About

Trash Pick - Up Simulator Made by John Green, Zach Wilson, Lucas Johnson, Colin Gamagami, Devun Schneider

Walk around a small environment and pick up trash - the trash, however, respawns at a steadily increasing rate. The only way to beat the trash torrent is to recycle/throw away what you collect in return for resources, and use those resources to make tools that will aid you to pick up the trash faster. To win, outlast the timer. If the trash consumes you and the environment - Game Over.

Installing from the GitHub Release

Choose the Release of your choosing then download the standalone build zip file for that release. They generally follow the naming scheme of "Trash_Pick-Up_Simulator-[State]-V#-#.zip". Then unzip the game folder from the zip file, and place the contents of the game in a directory of your choosing. You can send a shortcut for the Trash_Pick-Up_Simulator.exe to the desktop should you wish. All you need to do is click on the exe to launch and bob's your uncle.

Playing the Game

To get the latest version of the game, you can download/play from one of the following source(s)

• GitHub Releases
• Simmer.io
• Play the Dev Branch

Feedback

For anyone who would like to give us feedback about our game please fill out the following form...

• Google Form (aka the Unofficial Playtesting Questionnaire)

Playing the Dev Branch

To play the Dev Branch, all you need to do is follow the instructions below to clone the Repository...

• Install github desktop (which I recommend for new users).
• Either sign in with an existing github account or skip the sign-in step by supplying a username and email.
• Hit "Clone a repository from the Internet..." then Click the URL button
• Paste https://github.com/PlatFormPlayZ/CIS-350-Project-1 into the URL Bar
• Then choose the file location that you would like to have the repo cloned to (Have a specific folder for it.)

Then Once you have the Repository cloned, you need to open it in Unity...

• Install Unity HUB on your computer.
• For unity, you do have to have an account, so make sure you make on and or sign in yours. If you are making one, be sure to verify your email.
• Once you are signed in, skip the installation of the latest version of unity (you don't need it for this tutorial but you can get it if you want it).
• Click agree and get Personal Liscense.
• Now we need to install Unity 2020.1.4 (aka 2020.1.4f1) then click Install this version with Unity Hub.
• Then select the following Modules before continueing,
  • Android Build Support
  • WebGL Build Support
  • Windows Build Support (IL2CPP)
• Continue and Install 2020.1.4f1 (this is going to take some time before you can move onto the last step)
• If an installation page pops up for Visual Studio, add the module Game Development with Unity before clicking Install.

Now that we have the repo cloned, unity installed, all that is left is to open the project in unity...

• Under the Projects tab in Unity Hub click open
• Navigate to the folder which we cloned our repo to. By Default it is %UserProfile%/Documents/GitHub/CIS-350-Project-1
• Select Trash_Pick-Up_Simulator folder in the repo then click open
• Once the project has opened, you can play in the development environment. Do so by going to scenes > MainMenu then Play at the top.

If you have an error wher Unity is failing to load the project due to the layout see this article. To summarize try:

• Go to %UserProfile%/AppData/Roaming/Unity/Editor-5.x/Preferences/Layouts and delete LastLayout.dwlt
• Then go to the cloned Repo folder then ./Trash_Pick-Up_Simulator/Library/ and delete CurrentLayout-default.dwlt

cis-350-project-1's Issues

Play Environment

If the tutorial is not within an environment of its own and is an instruction screen, we will need a basic environment/level to start us off with. Does anyone have an idea of what we want this first environment to look like? Better yet does anyone have experience in level design?

Tutorial and Menu Screen

Status of the tutorial screen and menu's?
Do you need any help with it?

Difficulty picking up items

Picking up trash off the ground is not the easiest thing to do. Kinda have to be almost directly on top of the item without actually standing on it or else you are too high up.

Question 1: Would switching from a ray to a cone, like Professor Schaffer suggested fix the issue? Or would it be good to do it either way?

Question 2: Would implementing a crouching feature help this issue?

Question 3: If we stick with the ray, would there be a way to extend the "reach" of the player help mitigate this issue?

Sound Effects

Sound Effects we want to add:

• Main menu jingle
• In-Game Music
• Paper hits the ground
• Bottle hits the ground
• Throw sound affect/swoosh sound
• Made basket Paper
• Made basket Bottle
• Enemy sound
• Button click sound effect

SFX to be implemented:

• Main menu jingle
• In-Game Music
• Paper hits the ground
• Bottle hits the ground
• Throw sound affect/swoosh sound
• Made basket Paper
• Made basket Bottle
• Enemy sound
• Button click sound effect

Implement the Enemies into the level

• create a spawning mechanic for the enemies
• implement them into the level
• add info about them and how they work to the tutorial screens
• add a portion about them in the tutorial level
• #1 Make sure they are balanced properly
• Make sure they end the game when player runs into them
• Add the ability to stun the enemies

Tutorial Scale with Screen Size

Tutorial Screen gets cut off on the edges at non-standard resolutions.

Bug - Trash phasing through Trash cans

The bug I've noticed during testing is that trash will often phase through the garbage can, maybe it is just because of the angle of which we are trying to put it into the can is so close.

I suggest we look into this matter further or maybe see if just a normal drop item option along with the throw that we currently have to be able to just set items down would correct this issue for the most part.

UI Overhaul

UI Overhaul Priorities:

• Separate Tutorial Scene
• Update Tutorial and How-To Information: (See Below)
• Settings Menu for Volume
• Settings Menu for Mouse Sensitivity
• Add a Pause Menu (Issue Ported from #6)

Tutorial Information to be Updated:

• Space to Jump
• Left Shift to Sprint

Stretch Goals for the UI Overhaul:

• Settings Menu for Control Reassignment

Trash Spawning Issues

Trash does not despawn if it goes into an area inaccessable by the player. I suggest we use triggerzones outlining viable play area and if an object passes through the zones (particularly trash) it gets destroyed.

Player Movement and Interaction Changes

There were 2 ideas floating around...

• Trajectory arc for throwing
• Sprint opiton
• Crouch?

Power Bar for throwing force

Still need to implement the power bar into the UI

Stuck in Game

Need a way to pause the game so that player doesnt have to alt-f4 or win key to escape the game.

Balance Game Play

The random Trash spawner is good except for that we dont have a clever way to get valid spawning spots are for a given environment. What we have would work for a demo but I suspect once we have our first environment it wont be optimal if we want to have more than one map where the game takes place.