Difference between revisions of "Project1S21"

From Immersive Visualization Lab Wiki
Jump to: navigation, search
(Extra Credit (Max. 10 Points))
(Submission Instructions)
Line 74: Line 74:
 
** Example 4: The base project is complete and I did '''z''' for extra credit.
 
** Example 4: The base project is complete and I did '''z''' for extra credit.
  
/**
+
<!--
 
* '''Executable:''' Build your Unity project into an Android .apk, Windows .exe file or the Mac equivalent and upload it to Canvas as zip file.
 
* '''Executable:''' Build your Unity project into an Android .apk, Windows .exe file or the Mac equivalent and upload it to Canvas as zip file.
 
* '''Source code:''' Upload your Unity project to GitHub: either use the Unity repository initialized from [https://classroom.github.com/a/nQ0xrvht GitHub Classroom] or any GitHub repository that you might set up on your own. Make sure you use the [[Media: UnityGitignore(Unzipped_it_into_root_of_unity_project).zip | .gitignore]] file for Unity that is included in the repo so that only project sources are uploaded (the .gitignore file goes in the root folder of your project). Then submit the GitHub link to [https://www.gradescope.com/courses/227179 Gradescope] by using 'Submission Method: GitHub', along with your Repository link and the respective GitHub branch. ('''Note''': GitHub Classroom is only for starter code distribution, not for grading. Since we don't have any starter code for HW1, you can set up your '''own''' repo with Unity .gitignore file we provided and submit to Gradescope too.)
 
* '''Source code:''' Upload your Unity project to GitHub: either use the Unity repository initialized from [https://classroom.github.com/a/nQ0xrvht GitHub Classroom] or any GitHub repository that you might set up on your own. Make sure you use the [[Media: UnityGitignore(Unzipped_it_into_root_of_unity_project).zip | .gitignore]] file for Unity that is included in the repo so that only project sources are uploaded (the .gitignore file goes in the root folder of your project). Then submit the GitHub link to [https://www.gradescope.com/courses/227179 Gradescope] by using 'Submission Method: GitHub', along with your Repository link and the respective GitHub branch. ('''Note''': GitHub Classroom is only for starter code distribution, not for grading. Since we don't have any starter code for HW1, you can set up your '''own''' repo with Unity .gitignore file we provided and submit to Gradescope too.)
  
 
In Summary, submit to Canvas with 1. Video and 2. Zipped Executable files (.exe, .dll, .apk, etc.), and submit to Gradescope with 3. Source Code.
 
In Summary, submit to Canvas with 1. Video and 2. Zipped Executable files (.exe, .dll, .apk, etc.), and submit to Gradescope with 3. Source Code.
**/
+
-->

Revision as of 09:03, 14 April 2021

Contents

Whack-a-Mutant

As if the original 2019 Coronavirus was not bad enough, there are now a number of mutated variants of it which are spreading among the world's population. One of the most concerning is the British B.1.1.7. Mutations develop randomly and in unforeseeable locations. Which makes for a great game concept!

In this first programming project you need to create a simple game in Unity that resembles Whack-a-Mole, except you're whacking Coronavirus mutants. The game will exist in a 3D world, even though we're only going to use it with mouse and keyboard on a desktop or laptop computer (exception: extra credit option).

The idea of the game is to find the mutated viruses among an array of original Coronaviruses, and eliminate them. The player has a limited amount of time to eliminate as many mutants as possible.

The project is due Sunday, April 18th at 11:59pm PT.

Project (100 Points)

Download Unity and do a Unity tutorial. Unity's own tutorials are great, but might also like the tutorial from edX course CSE190x.

Learn how to make Unity apps and get an app working in Unity (any app). (5 points)

Use Unity to create a Coronavirus game for your Windows or Mac computer. The game does not need to run in VR, but there is an extra credit option for it.

Here are step by step instructions:

  • Create a thin box that you use as a wall as the backdrop of your application. The wall's height should be approximately equal to your vertical field of view. (10 points)
  • Using a photo camera or your phone, take a picture of your surroundings (indoor or outdoor), or some other location near you that Coronaviruses can live in, with your smartphone and import it into Unity as a texture asset. You are allowed to edit the image as much as you'd like. (10 points)
  • Paste the picture onto the wall so that it faces the user. (5 points)
  • Create and place an array of 5x5 = 25 Coronaviruses between the player and the wall. Each virus should be roughly the size of a tennis ball (0.07 meters diameter), and the virus center points should be 0.14 meters apart from each other (horizontally and vertically). (15 points)
  • Create C# code to highlight a random virus with a method of your choice (eg, change its color, let it pulsate, frame it, etc). (5 points)
  • Create a cursor (e.g., a line, small sphere snapping to closest object, etc.) to allow the user to select a virus by pointing at it with the mouse. (10 points)
  • Start the game when the user pushes the mouse button. This should start a 30 second timer, which needs to be displayed as text somewhere on the screen. Only display whole seconds, no fractions. (5 points)
  • Display a counter in a different part of the screen. This should be a number that can be up to 3 digits long. It starts with zero and counts the number of whacked mutants. (5 points)
  • When the user clicks the mouse button, check if they hit the mutant and if so increase the sphere counter. (10 points)
  • Every second the mutant should degenerate back to a regular Coronavirus, and a different virus should mutate. (5 points)
  • If the user clicks on a virus other than a mutant, the click should be ignored. (5 points)
  • Repeat the above until the timer is up. Then display a message such as "The time is up". (5 points)

Here's a mock-up of what the game could look like:

S21-project1-mockup.jpg

You can use this Coronavirus model (source: Sketchfab)

Record a video off the screen while you play the game from start to finish. Make sure you include a shot of your final score. Upload the video to Canvas by the deadline. Also, add a comment stating which parts of the project you got done or didn't get done.

To create the video you don't need to use video editing software, but you should use software to capture your screen to a video file. To record off your desktop computer, we recommend OBS Studio, which is available free of charge for Windows and Mac.

Extra Credit (Max. 10 Points)

Options for extra credit are:

  • Add sound effects to your game. At a minimum, you need to have distinct effects for: whack and miss, whack and hit, time expired. (5 points)
  • To make the game more difficult, make the viruses move left/right and up/down a little bit in a randomized way. Each virus needs to move independently from the others. Tweak the motion parameters so that the game gets harder than without motion, but not too hard to be frustrating. (5 point)
  • Get your game working on your VR headset, or on your smartphone with a VR viewer (such as Google Cardboard). The video recording of a run of the game is still required and needs to be recorded off your VR device (or a streamed version of the video signal on your PC). (10 points)

Submission Instructions

Once you are done implementing the project, record a video demonstrating all the functionality you have implemented.

The video should be no longer than 5 minutes, and can be substantially shorter. The video format should ideally be MP4, but any other format the graders can view will also work.

While recording the video, record your voice explaining what aspects of the project requirements are covered. Record the video off the screen if you use a VR headset.

To create the video you don't need to use video editing software.

Components of your submission:

  • Video: Upload the video at the Assignment link on Canvas. Also add a text comment stating which functionality you have or have not implemented and what extra credit you have implemented. If you couldn't implement something in its entirety, please state which parts you did implement and expect to get points for.
    • Example 1: I've done the base project with no issues. No extra credit.
    • Example 2: Everything works except an issue with x: I couldn't get y to work properly.
    • Example 3: Sections 1, 2 and 4 are fully implemented.
    • Example 4: The base project is complete and I did z for extra credit.