Deadlines
| Assignment | Tasks | Deliverable | Points | Due Date |
|---|---|---|---|---|
| Project 5A | - Partnerships - Setup - Design Document |
Partnership formation | 50 | Tues, Nov 10 11:59pm PT |
| Lab 12 | Fri, Nov 13 11:59pm PT |
|||
| Re-pairing requests (if needed) | — | Mon, Nov 16 11:59pm PT |
||
| Dissolution requests (if needed) | — | Wed, Nov 18 11:59pm PT |
||
| Design Document | 50 | Wed, Nov 18 11:59pm PT |
||
| Project 5B | - World Generation - Light Sources (groups of 3 only) |
Code and World Screenshots on Gradescope (optional regrade/clobber at your checkoff) |
200 | Tues, Nov 24 11:59pm PT |
| Project 5C No Extensions |
- Task 1: Main Menu - Task 2: Interactivity - Task 3: HUD - Task 4: Saving and Loading - Task 5: Toggleable Light Sources (groups of 3 only) - Task 6: Pathfinding - Task 7: Ambition Features |
Code on Gradescope and Live Checkoff with TA (Checkoffs will happen Mon Nov 30 – Fri Dec 4; Nov 30 and Dec 1 are optional early slots) |
500 | Tues, Dec 1 11:59pm PT |
Ambition Features
Beyond the base requirements of this project, we want you to polish your game and add some cool features of your choosing, which we call “ambition features”. Each feature below is either a primary feature or a secondary feature.
What you need to implement
Groups of 2 must implement one of:
- 2 primary features, OR
- 1 primary feature and 1 secondary feature.
Groups of 3 must implement one of:
- 3 primary features, OR
- 2 primary features and 1 secondary feature.
Groups of 3 must also implement Light Sources, which is required (not an ambition feature): world generation in Project 5B and toggling in Project 5C.
Points
Ambition features are graded during your live checkoff. Every option is worth 220 points in total, and what each feature is worth depends on the option you choose:
| Group size | Option | Each primary feature | Each secondary feature | Total |
|---|---|---|---|---|
| Groups of 2 | 1 primary + 1 secondary | 160 | 60 | 220 |
| Groups of 2 | 2 primaries | 110 | — | 220 |
| Groups of 3 | 2 primaries + 1 secondary | 90 | 40 | 220 |
| Groups of 3 | 3 primaries | 73.3 | — | 220 |
There is no extra credit beyond 220. If you implement more features than your option needs, tell your TA at your checkoff which features you want graded.
How features are graded
Under each feature below is a Grading Rubric table listing exactly what your TA checks at your checkoff, and how many points each item is worth. Find the column for your group size and the option you chose. Use these tables as a checklist to make sure your feature hits every item before your checkoff!
- Every feature includes an item for saving and loading: saving and loading must preserve the state of your ambition feature.
- A feature that is not implemented, or does not work at all, earns no points.
- Custom (non-listed) features are worth the same as listed features of their tier, and are graded at full, 75%, 50%, or no credit, with 10% of the feature’s points for saving and loading its state.
Your project must still meet the basic requirements described earlier in the spec! For example, if you allow the user to use mouse clicks, the project should still allow keyboard based movement!
Under the description of some primary features, we’ve provided some GIFS that would score full points on their respective ambition point items to help clear any confusions. Yours do not need to look exactly like the examples given.
If you guys want to work on different ambition features at the same time, we would like to recommend using branches to manage them! There won’t be an explicit guide here but you can checkout the relevant portion of the git guide here.
Custom Ambition Features
You are not restricted to the features we list below! We strongly encourage you to come up with your own. We have an Ed megathread (Custom Ambition Feature Request Ed thread) where you can run your ideas by us to confirm that it meets our standards.
We cannot guarantee custom ambition feature approvals after the 5A deadline, Wednesday, November 18, though we will try our best to get through every request. We will officially close responses to the thread after the 5B deadline, Tuesday, November 24.
Files
For some ambition features, you might customize your world through custom images, audios, and other assets. Make sure to upload these files into your project and organize them accordingly.
In addition, use relative file paths instead of absolute file paths. For instance, if you have your music file menu_music.wav under a separate package called music underneath src, you can reference it as music/menu_music.wav.
Doing both of these steps will allow anyone who has your project on their laptop to be able to view and use your files.
Primary Features
-
Line of Sight: Create a system so that the tile renderer only displays tiles on the screen that are within the line of sight of the avatar. The line of sight must be able to be toggled on and off with a keypress. Note the line of sight should NOT go through walls although it is fine to be able to wrap around walls/corners. This also means that the line of sight must be long enough such that we can tell if it goes through a wall or not. Here are two examples of line of sight features that we will NOT accept:
On the other hand, here is what an acceptable solution would look like:
Note how the correct one isn’t based on any certain shape (the example is a diamond but a width by height box also will not be allowed) but rather “moves” along with how the character moves. Solutions that are based on showing a box/diamond centered on the character will not be allowed/given full credit.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesLine of sight does not go through walls, and its range is large enough that we can tell (wrapping around walls/corners is fine). 88 60.5 49.5 40.3 Line of sight can be toggled on and off with a keypress. 56 38.5 31.5 25.7 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Encounters: Create a system for “encounters”, where a new interface appears when the avatar interacts with entities in the world, returning the avatar to the original interface when the encounter ends (e.g. Pokémon). Note that the world must be in the same state it was before the encounter, after the encounter ends. It’s okay if save/load is not available during encounters.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesA new interface appears when the avatar interacts with an entity in the world. 56 38.5 31.5 25.7 When the encounter ends, the avatar is returned to the original interface. 56 38.5 31.5 25.7 After the encounter, the world is in the same state as before (not a different random world). 32 22 18 14.6 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Undo, Redo and Restart: Add the ability to undo moves, redo moves, and reset your world using three different keypresses. The redo key should do nothing if the most recent action was not an undo.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesUndo works for any number of moves the player has made. 56 38.5 31.5 25.7 Redo works for any number of undone moves. 56 38.5 31.5 25.7 Redo does nothing (and doesn’t break) when the most recent action was not an undo. 16 11 9 7.3 Restart resets the world. 16 11 9 7.3 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Perspective: Add the ability for the user to change the perspective of their view (first-person, isometric 2.5D, 3D, etc.) (We’ve never seen anyone do isometric 2.5D or full 3D before! The Nintendo 64 game ‘Kirby 64 - The Crystal Shards’ is an example of what an isometric 2.5D world looks like). One particularly interesting example is Dorottya Urmossy and David Yang’s Fall 2022 submission, which is a 2.5D first-person view, i.e. the world is 3D but the entities are 2D.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesYou can switch from the 2D view to an alternative perspective (first-person, isometric, 2.5D, or full 3D). 120 82.5 67.5 55 You can switch from the alternative view back to the original perspective. 24 16.5 13.5 11 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Battle System: Implement a battle system that allows players to interact with moving enemies and obstacles. Assign the player a health value, place collectibles that restore health around the map, and create randomly-moving enemies/objects that inflict damage on and receive damage from the player.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesThe player has a health value. 24 16.5 13.5 11 Health-restoring collectibles are placed around the map (the avatar must interact with them). 24 16.5 13.5 11 Interacting with a collectible actually increases health. 16 11 9 7.3 Moving enemies/objects damage the player (their movement may be deterministic). 48 33 27 22 Enemies/objects can take damage from the player. 32 22 18 14.7 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Explorer: Make your world larger than the preset display size such that the player can “explore” beyond the starting world. The rendered world should move with the player beyond a certain point and be scrollable.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesThe world is larger than the preset display size. 72 49.5 40.5 33 The rest of the world is reachable by scrolling as the player moves. 72 49.5 40.5 33 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Wrap: Make your world “wrap” around the border of the rendered world, where the player should be able to enter from one side of the screen and exit from the opposite side interchangeably. In order to wrap, you must have rooms on the edge of the world that clip off such that the opposite side also has a room that is clipped off, allowing the player to continue traveling on the floor tiles. The world should still follow the World Requirements from Part B excluding requirement #10.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesAt least one side of the screen wraps (the avatar exits one side and enters the opposite side). 64 44 36 29.3 Wrapping works in both directions (the avatar can wrap back). 40 27.5 22.5 18.4 Wrapping happens through rooms that clip off the edge of the world (no wall on the edge) with a matching clipped room on the opposite side, so the avatar never passes through walls. 40 27.5 22.5 18.3 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Online Multiplayer: Add online multiplayer where other users can join and leave the current game.
java.net.Socketmight be useful here. All players must have the ability to do interactivity (moving, save/load, etc)Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesMultiple players can actually be in the game at the same time (a socket that doesn’t produce working multiplayer is not enough). 88 60.5 49.5 40.3 All players have the same controls (movement, interaction, saving and loading, etc.). 56 38.5 31.5 25.7 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
NPCs: Add NPC interaction and dialogue with the player. Allow the player to choose different response options depending on the NPC and/or game state. Let us know if you do any cool realtime API calls to an LLM service.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesThe NPC is interactive: the player can prompt it (e.g. with a key) and respond back. 56 38.5 31.5 25.7 The NPC has dialogue. 56 38.5 31.5 25.7 The player has multiple response options depending on the NPC and/or game state (one option per NPC is fine; one option across all NPCs is not). 32 22 18 14.6 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Levels: Implement elevators/navigable floors with a toggleable multi-floor view or with a significantly different interface with the ability to go back to the main world.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesYou can switch from the main view to at least one other view (a different floor layout or a significantly different interface). 64 44 36 29.3 You can switch from the other view back to the main view. 40 27.5 22.5 18.4 Different levels have different layouts. 40 27.5 22.5 18.3 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3 -
Altered Terrain: Implement the ability for the avatar to significantly alter the landscape of the world, e.g. digging, triggering traps that cause parts of the world to become dangerous or impassible, solving puzzles that make some rooms accessible only after fulfilling some objective.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 2:
2 primariesGroup of 3:
2 primaries + 1 secondaryGroup of 3:
3 primariesThe avatar can alter the landscape of the world (e.g. digging, traps, puzzles that unlock rooms). 72 49.5 40.5 33 The alteration affects more than a small, room-level piece of the world. 72 49.5 40.5 33 Saving and loading preserves the feature’s state. 16 11 9 7.3 Total 160 110 90 73.3
Secondary Features
-
Replay: Add the ability for the user to “replay” their most recent save, visually displaying all the actions taken since the last time a new world was created. This must result in the same final state as would occur if the user had loaded the most recent save. This means that the game should be playable once the replay is complete.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryThe user controls when a replay happens (it isn’t automatic or random). 15 10 The replay ends in the same state as loading the most recent save. 18 12 The game is playable once the replay is complete. 21 14 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Save Slots: Add multiple save slots that can be accessed with a new menu option, and a new keyboard shortcut to save to a slot other than slot 1. You should be careful to still support the default behavior of saving and loading in order to be consistent with the replay string requirements.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryA new menu option accesses the additional save slot(s). 18 12 A new keyboard shortcut saves to a slot other than slot 1. 18 12 Default saving and loading still work alongside the extra slots. 18 12 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
New World: Add the ability to create a new world without closing and reopening the project, either as a special option you can press while exploring, or when you reach a “game over” state if you’ve turned your world into a game.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryYou can create a new world without closing and reopening the program (while exploring, or after a game-over state). 27 18 The new world keeps full functionality (movement, other ambition features, saving and loading). 27 18 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Custom Avatar: Make your engine render images instead of unicode characters, and add a menu option to change your avatar’s appearance to a custom image created by you.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryA menu option changes the avatar to a custom image. 27 18 The custom avatar is rendered as an image, not a unicode character. 27 18 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Theme: Make your engine render images instead of unicode characters, and add a menu option to select the environment/theme of the world will be.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryA menu option selects the theme (or the program picks one randomly). 24 16 The chosen theme is the one that appears (or, if the theme is random, each theme is equally likely). 18 12 Themes look substantially different (more than one tile type changing color). 12 8 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Language: Add a menu option to change all text in the interface to a different language. English should be the default and there should be a way to switch it back to English.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryA menu option changes the language. 18 12 The new language is used beyond the menu (throughout the interface). 18 12 There is a way to switch back to English. 18 12 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Audio: Add cool music to both your menu and exploration interface, as well as sound effects for interactions the avatar makes with the world.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryThe menu has music. 12 8 The exploration interface has music. 12 8 Sound effects play for at least two avatar interactions with the world. 15 10 Sound effects are deterministic, i.e. tied to the avatar’s interactions rather than random. 15 10 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Minimap: Add a minimap somewhere which shows the entire map and the current avatar location. This feature is a lot more interesting if you also implement a map which is larger than the screen so that you are unable to see the entire map normally.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryThe minimap shows the entire map (if the map is larger than the minimap, the user can scroll it to show all of it). 12 8 The minimap shows the avatar’s location. 12 8 The avatar’s location on the minimap updates live as the avatar moves. 12 8 The minimap doesn’t interfere with gameplay (it can be closed, and the player can still move). 18 12 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Rotate: Add ability to rotate the world, i.e. turn the board 90 degrees and adjust movement keys accordingly.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryYou can rotate the world. 27 18 Movement keys adjust to match the rotation. 27 18 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Local Multiplayer: Add support for 2 users to interact at the same time. This will require that you have two avatars on screen which can move around, and they should have separate control schemes.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryA second user can play with their own avatar. 21 14 The second avatar has its own, separate control scheme. 15 10 Both players can act at the same time (not just one player per turn). 12 8 The two avatars are visually distinguishable. 6 4 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Moveable Blocks: Add ability for the player to place and remove blocks based on a sequence of keypresses.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryThe player can place blocks. 21 14 The player can remove blocks. 21 14 Placing and removing are done through a sequence of keypresses. 12 8 Saving and loading preserves the feature’s state. 6 4 Total 60 40 -
Coins: Add the ability for the user to collect coins. Once all coins are collected, the user should be returned to the main menu, where they are given the option to either start a new game, load a previous world, or quit.
Requirement Group of 2:
1 primary + 1 secondaryGroup of 3:
2 primaries + 1 secondaryThe user can collect coins. 18 12 The game tracks how many coins have been collected. 12 8 Collecting all coins triggers an end state. 12 8 The end state returns the user to the main menu (new game / load / quit). 12 8 Saving and loading preserves the feature’s state. 6 4 Total 60 40






















