Workbook :

This workbook is due on Tuesday, December 16, 2025.

This is the workbook for the group project and can be completed by 1 to 4 students (recommended group size is 2 or 3).

Content Requirements

The project should be displayed on a public GitHub Page (instructions) or a UW Madison CS Department personal webpage (instructions) in a single HTML Canvas that uses THREE.js. It can be any small video/mobile game or an interactive visualization/simulation.

There needs to be two modes of the game (either two separate pages or a button/checkbox to switch between the modes).

  • Prototype: all objects are primitive geometries with no image textures.
  • Full: allows loaded objected and textures.

For all groups,

  • The user should be able to interact using mouse and touch or keyboard: to control the movement of one or more objects in the scene (or the camera). For keyboard interactions, consider on-screen buttons or other alternatives so that the projects can be viewed on mobile devices.

For groups with three or more students,

  • Other objects in the scene should be animated, even when there is no user interaction.

For groups with four students, one of the following should be implemented.

  • Game opponents or non-playable characters that perform meaningful actions, demonstrating multiple levels of difficulty or complexity.
  • Game levels are randomized and designed with multiple levels of difficulty.
  • Auto-play options to demonstrate the solution or walk-through of the game.

Submission Requirements

Each project will be evaluated by four components.

  • Game design: the overall gameplay or story.
  • User interaction: implementation of the game mechanics.
  • Animation: character and environment animation.
  • Automation: control of non-playable characters.

There will be a separate Workbook Form link for this project. Every student should submit the Workbook Form and include the following information:

  • Your Wisc NetID.
  • Your group name and a four-digit group ID (this ID should be displayed at the top of your web page).
  • The link to your project GitHub Page (something like the Train it should not be a link to an GitHub Repository).
  • Which ones of the four components did you make the most contribution to (each component can be only claimed by one group member).
  • Notes (you can include attributions, addition updates and improvements after the presentation, etc).

Peer Evaluation

All students are encouraged to evaluate other students’ submissions, and can earn up to 5 points from submitting valid evaluations link (one submission for each group: please enter your Wisc NetID and the Four-digit Group ID for the group you are evaluating).

  • 5: Submitted at least 20 valid evaluations with 5 rated 5 in each category.
  • 4: Submitted at least 16 valid evaluations with 4 rated 5 in each category.
  • 3: Submitted at least 12 valid evaluations with 3 rated 5 in each category.
  • 2: Submitted at least 8 valid evaluations with 2 rated 5 in each category.
  • 1: Submitted at least 4 valid evaluations with 1 rated 5 in each category.

Each component of each project can be rated one of the following,

  • 5: Best in the class: requires explanation and at most one quarter of your evaluations in each category can be 5.
  • 4: Better than average.
  • 3: Average.
  • 2: Below average.
  • 1: Not applicable.

For an evaluation to be considered valid:

  • You are not evaluating your own group.
  • Correct four digit group ID (for the group you are evaluating).
  • Correct summary (1-2 sentences) of the game/visualization.
  • Components that are not implemented should receive a rating of 1.
  • Components that are implemented should not receive a rating of 1.
  • Components rated 5 should have a valid explanation.

Grading

The grade will be based on your ranking of your score in class. The score is computed as the maximum score over all components you claimed, and the component score is computed as the average of the weighted average of student evaluations and the average of the course staff evaluations.

  • Score = 0.5 average student scores + 0.5 average course staff scores.
- Ranking Grade
Top 10% 10% 10
Next 10% 20% 9
Next 10% 30% 8
Next 10% 40% 7
Next 10% 50% 6
Next 10% 60% 5
Next 10% 70% 4-5*
Next 10% 80% 3-5*
Next 10% 90% 2-5*
Next 10% 100% 1-5*

(*) The grades will be lower-bounded by the average score received.

Checklist

Workbook Rubric (8 basic + 5 advanced (5 max) = 13 total)
Box Basic Advanced Description
1 correct P3 Workbook Form submission on time
1 prototype version with only primitive geometries and no image textures
1 full version allowing loaded objects and textures
1 THREE.js library is used
1 CS559Framework is NOT used
1 page hosted on GitHub Pages or CS Department Webpages
1 four digit group ID at the top of web page
1 presentation during the lecture
1 submitted 4+ with 1+ rated 5
1 submitted 8+ with 2+ rated 5
1 submitted 12+ with 3+ rated 5
1 submitted 16+ with 4+ rated 5
1 submitted 20+ with 5+ rated 5