COMP(1511|1911) Assignment 1: CS Moonlander

2024-10-22 Admin 写评论

Hello, if you have any need, please feel free to consult us, this is my wechat: wx91due

Getting Started

  1. Create a new folder for your assignment. Here is an example: 
mkdir ass1cd ass1
  1. Fetch the starter code using the command below. Alternatively download the starter code here. 
1511 fetch-activity cs_moonlander
  1. Check that everything works by running the autotest. 
1511 autotest cs_moonlander

(These should fail initially. If you want to exit running the autotest midway, press [ctrl-c])

Initial Code and Data Structures

The starter code for this assignment includes some functions and defined types:

  • A print_board() function:
    • This prints out the current state of the board, which ensures that your board printing matches the autotest exactly for a given board.
  • An init_board() function:
    • This stores a default value in each of the tiles in the provided board.
  • A struct tile struct:
    • Each square of the board (i.e. the 2D array) holds a struct tile, containing the information about what that tile contains.
    • The player's row and col values are stored seperately to the contents of the board
  • An enum entity enum:
    • This is used in the struct tile struct to represent what is on each tile.

Let us look at an example output from the print_board() function. 

+---+---+---+---+---+---+---+---+---+---+
|       C S   M O O N L A N D E R       |
+---+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |   |
+---+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |   |
+---+---+---+---+---+---+---+---+---+---+
|   |   |/|\|   |^^^|   |<(]| | | | +---+---+---+---+---+---+---+---+---+---+ | | | | | | | | | | | +---+---+---+---+---+---+---+---+---+---+ | | | | | | |0.0| | | | +---+---+---+---+---+---+---+---+---+---+ | | | | | | | | | | | +---+---+---+---+---+---+---+---+---+---+ | | |\O/| |~~~| |~~~| | | | +---+---+---+---+---+---+---+---+---+---+ | | | | | | | | | | | +---+---+---+---+---+---+---+---+---+---+ | | | | | | | | | | | +---+---+---+---+---+---+---+---+---+---+ | | | | | | | | | | | +---+---+---+---+---+---+---+---+---+---+

Here, we have tiles containing:

  • the lander /|\
  • a rock ^^^
  • a cheese <(]
  • a hole down \O/
  • two portals ~~~
  • the player 0.0

Where do we store the player?

The player is not stored in the board, instead the print_board() function takes the player's row and column as arguments whenever we print the board.

  • for the above example: print_board(board, 4, 6);.

So you can store the player however you like! (e.g. variables for the row/col, or perhaps a struct that contains both the row and the col!)

Reference Implementation

To help you understand how the assignment works, we have written a reference implementation for you to run. You can run it via the command 1511 cs_moonlander. 

1511 cs_moonlander...
Example Input

FAQ

FAQ

Stages

We have broken the assignment spec down into incremental stages:

  • Stage 1: Place the lander, add cheese & rocks to the board.
  • Stage 2: Setup the player, add player movement, pick up and drop off cheese, keep oxygen levels correctly updated, refill oxygen at the lander.
  • Stage 3: Check for a win or lose condition, add a command to quit the program early, add moonquake mechanics.
  • Stage 4: Make the board 3D, add commands to create holes and jump between levels, add portals, implement travelling through portals.
  • Extension (no marks): Add a graphical user interface.

Your Tasks

This assignment consists of four stages. Each stage builds on the work of the previous stage, and each stage has a higher complexity than its predecessor. You should complete the stages in order.

A video explanation to help you get started with the assignment can here found here:

Stage 1

In stage 1, you will scan and store values to set up the map, including the lander, rock obstacles, and collectible cheese.

There is a reference implementation that you can play by running the command 1511 cs_moonlander in the terminal.

Here is an example of input for a finished stage 1 that you can try within the reference implementation. 

1511 cs_moonlander1 5c 1 2c 3 1r 3 5r 3 7R 5 4 8 6[ctrl+d]

Stage 1.1: Placing the Lander

We will begin by scanning in and storing some values from the terminal. We will also need to assert that the values are valid.

In this substage, you will need to do the following:

  1. Print the prompt Please enter the [row] [col] of the lander: .
  2. Scan in the lander's position as row and col.
  3. Check that the row and col values correspond to a valid tile:
    • If the requested tile is not on the board, place the lander at board[4][4].
    • Otherwise, add the lander to the board at the requested tile.
  4. Call the provided print_board() function with these arguments:
    • INVALID_INDEX as the arguments for player_row and player_col.
    • BASE_OXY_RATE as the argument for oxy_rate.
    • 0 or 0.0 for all other arguments.
You might want to create a function for asserting that a coordinate is valid, this will come up a lot in all 4 stages, including later in stage 1!

Clarifications

  • The lander row and col will always be ints.

Examples:

Example 1.1.1: Adding Lander
Example 1.1.2: Bad Row Input

Autotest

You may like to autotest this section with the following command: 
1511 autotest-stage 01_01 cs_moonlander

Remember to do your own testing!

Stage 1.2: Add cheese and rocks

So far we have only added the lander to the board, that is pretty boring so let us add some moon cheese collectibles and rock obstacles to spice it up!

To do this we will create a setup loop that scans in commands to let the user add CHEESE and ROCKs to the board. Allow the user to add CHEESE using the command in the form c int int and add a ROCK using the command in the form r int int until [ctrl+d] is pressed.

In this substage, you will need to do the following:

  1. Print the prompt Please enter cheese and rock locations:\n.
  2. Allow the user to input commands in a loop until [ctrl+d] is pressed.
  3. Given the command: c [row] [col], add a CHEESE to that tile.
  4. Given the command: r [row] [col], add a ROCK to that tile.
  5. After the user enters [ctrl+d], call the provided print_board() function with these arguments:
    • INVALID_INDEX as the arguments for player_row and player_col.
    • BASE_OXY_RATE as the argument for oxy_rate.
    • 0 or 0.0 for all other arguments.

Clarifications

  • Each command provided will be of the form char int int.
  • You can not assume that only the c or r commands will be entered.

Examples

Example 1.2.1: Adding Cheese to Board
Example 1.2.2: Adding Cheese and Rocks to Board

Autotest

You may like to autotest this section with the following command: 
1511 autotest-stage 01_02 cs_moonlander

Remember to do your own testing!

Stage 1.3: Add Large Rocks and Check Scan Positioning

Adding rocks one by one can get quite repetitive, so here we will introduce the new R command to our handy setup loop from stage 1.2. This will allow us to add large rectangular rocks to the board. We will also print an error message if the cheese and rocks we scan in would be placed on a square that already contains something.

In this substage, you will need to do the following:

  1. For our cheese input from stage 1.2, if the requested tile is occupied or not on the board, instead of adding the cheese to the board print That is not a valid cheese placement!\n.
  2. For our single rock input from stage 1.2, if the requested tile is occupied or not on the board, instead of adding the rock to the board print That is not a valid rock placement!\n.
  3. Given the command R [start_row] [start_col] [end_row] [end_col], place a large rock with top left corner at [start_row] [start_col] and bottom right corner at [end_row] [end_col]. A large rock is represented by placing a ROCK on every tile in it's area.
    • If any of the following error conditons are true, print That is not a valid rock placement!\n and do not add the large rock to the board.
      • Any tile enclosed in the requested rectangle does not lie on the board.
      • Any tile enclosed in the requested rectangle is occupied.
      • start_row is greater than end_row, or start_col is greater than end_col.

Clarifications

  • A tile is occupied if its entity field is not EMPTY.

Examples:

发表评论

电子邮件地址不会被公开。 必填项已用*标注