Deadlines

Warning: There are 3 deadlines for this project, and some deadlines require you to submit multiple deliverables. Please double-check that you submitted everything!
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
To request extensions on Project 5, all group members need to submit separate extension requests on Beacon.

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:

    line-of-sight

    line-of-sight

    On the other hand, here is what an acceptable solution would look like:

    line-of-sight

    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 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    Line 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.

    encounter

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    A 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.

    undo-redo-restart

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    Undo 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.

    perspective

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    You 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.

    battle-system

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    The 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.

    explorer

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    The 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.

    wrap

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    At 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.Socket might be useful here. All players must have the ability to do interactivity (moving, save/load, etc)

    online-multiplayer

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    Multiple 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.

    npcs

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    The 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.

    levels

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    You 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.

    altered-terrain

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 2:
    2 primaries
    Group of 3:
    2 primaries + 1 secondary
    Group of 3:
    3 primaries
    The 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.

    replay

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    The 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.

    save-slots

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    A 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.

    new-world

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    You 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.

    custom-avatar

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    A 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.

    theme

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    A 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.

    language

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    A 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 secondary
    Group of 3:
    2 primaries + 1 secondary
    The 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.

    minimap

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    The 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.

    rotate

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    You 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.

    local-multiplayer

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    A 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.

    moveable-blocks

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    The 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.

    coins

    Requirement Group of 2:
    1 primary + 1 secondary
    Group of 3:
    2 primaries + 1 secondary
    The 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