ITECH7201 Software Engineering: Analysis and Design
Assignment 2 Important Note
This assignment requires the use of a provided code base. You must use the code provided in the Assessment section of Moodle. Do not use code given to you by another student (or past student) as you will be awarded ZERO MARKS for the assignment task.
You are required to modify and logically extend the functionality of a provided code base to implement a game. This requires you to modify the code base as well as create documentation and implement various user stories.
You will use the Boost methodology discussed during lectures, including using Paired Programming to complete this assignment. You must work in pairs, unless you have received explicit approval in writing from your lecturer to vary this requirement.
The code base provided for this assignment has already implemented the “warm up” and some “sets”. You will be implementing numerous other “sets” for this assignment using the Boost methodology. The “warm down” stage is not required.
You are free to take ideas discussed during lectures and implement these in your own version of the code.
This assignment will be marked according to the functionality of your code, in addition to the elegance and extensibility of your design and quality of your documentation.
Note: It is recommended that you spend some time familiarising yourself with the provided code base prior to beginning any work on this assignment. You should start by spending some time exploring the structure of the code to gain an understanding of the roles each class plays within the system and then complete Lab 7.
Timelines and Expectations
Percentage Value of Task: 20%
Due: 23:55 Sunday 30th October 2018 (week 11)
Minimum time expectation: 20 hours
Learning Outcomes Assessed
The following course learning outcomes are assessed by completing this assessment:
- Apply software design principles to design and document software that utilises design patterns
- Analyse source code and develop comprehensive unit test suites
- Operate CASE software to document the design of a piece of software
- Apply refactoring to identify poor programming practice in existing source code and improve its structure and readability
- Apply an appropriate software development methodology to the development of a software system
1817 ITECH7201 Assignment 2 specification.docx
Where In The World Is Carmen Sandiego was a popular edutainment computer game first released in 1985 by
Broderbund Software Inc. Players performed the role of a detective who travelled around the world finding clues to track the villain and solve various crimes committed by a gang led by Carmen Sandiego. When enough clues were found to identify the villain, a warrant would be issued, the villain arrested and a trial held to see if the correct person had been arrested. Eventually, after solving a number of cases, Carmen Sandiego herself could be captured, which would earn the detective a place in the ACME Hall of Fame. A fully-functional emulator for this game is available at: https://archive.org/details/msdos_Where_in_the_World_is_Carmen_Sandiego_1985
Your task is to implement your own version of this game, in which a detective will attempt to solve a crime by travelling to various cities around the world. At each city, the detective will explore the location and speak with local people to discover clues to identify, track and ultimately arrest the culprit.
This assignment must be completed in pairs.
- Design and implement a custom environment for your game. This requires:
- Creating your own hand-drawn representation of the world map and changing the HardCodedData file to reflect the details on this map. This needs to include:
- at least four (4) locations to travel through, in addition to the starting location of ACME
Headerquarters. One of the four custom locations is to be the place where the villain is hiding, hoping to avoid capture. These locations form the path the villain has followed and the detective will need to trace in order to locate the villain. This path must be clearly identified on the map.
- Sufficient additional locations for alternative destinations so that the detective must use clues to determine the correct path to take.
- names and student ids of the team members who created the map.
- Compiling a list of at least six (6) suspects and their identifying features, one of whom must be the villain. These suspects must be unique so that it is possible to find clues to eliminate all but one of the suspects from the search.
- For each location, including the locations that are not part of the correct path, documenting the nonplayer characters and the clues, as well as any additional items you may choose to include, that will be available in that location. You may use a generic set of non-player characters and / or clues for locations that are not on the correct path if you wish. The final location will need to include the villain as one of the non-player characters. The clues must enable the villain to be identified as well as allowing the detective to follow the correct path.
IMPORTANT NOTE: If you correctly apply the design patterns in your assignment code, all of this game playspecific data will be in the hard-coded data file, separated from the code that controls the behaviour of your game.
- Implement each of the following deliverables / milestones, using the design patterns covered in classes:
- functionality as detailed in Lab 7 and Lab 8. You may customise the names of commands to better suit the context, for example: move may be better represented by fly.
- commands to enable game play for a minimum of one case. You may customize these commands to suit your variation of the game, but at a minimum, need to include:
- allowing a user to identify and read clues, be these from items in the location or through interacting with NPCs in each location.
- entering details of known villain attributes from clues for Interpol to compare these attributes with the list of subjects to identify a list of suspects who match the attributes provided. This may be repeated as often as required, with the intent being to eliminate all suspects bar one so that the true villain can be identified.
- issuing a warrant from Interpol once only one suspect remains as per b) ii. The detective must be carrying a warrant for a suspect in order to arrest that particular suspect, and only one warrant may be carried at any time.
- The ability to arrest a suspect. This command must be context-specific, so it is only available when the detective has been issued a warrant, and only when a suspect is present in the current location. The detective must only win the game if the correct suspect has been arrested.
- Produce a short video (up to 5 minutes) and upload this to YouTube as an unlisted file. A link to view this on YouTube must be submitted with your assignment. All team members must actively participate (be visible throughout the recording and contribute equally to the discussion) in the video to:
- Provide a demonstration of the game – how the game play works and how this was implemented
- Explain the role of design patterns in the game, clearly identifying the functionality where design patterns have had an impact and how this has occurred.
- Reflect on the use of a development methodology in creating the game. How did this assist, or make the development of the game more complicated?
This video will be assessed based on the clarity and accuracy of the explanations and how clearly it
demonstrates an understanding of how the game was coded, the design patterns used and the impact of using a development methodology. All required design patterns must be implemented to be eligible for full credit for this component, otherwise marks will be available on a pro-rata basis. All team members must contribute equally to the discussion and be visibly involved in the demonstration. The quality of the video itself will not be assessed – using a mobile phone to record this is fine. If you do not have access to recording facilities, please speak with your tutor prior to week 9 to make arrangements to have this recorded.
- Prepare a report, to be submitted as a Word document or a PDF, which includes:
- The student number and name of each person on your team
- User stories for each of the deliverables / milestones
- Class diagrams for Lab 7 and Lab 8
- Sequence diagrams for any two (2) of the game play commands of your choice
- A link to the YouTube video demonstration
- Prepare an individual report that includes:
- A statement of your own personal contribution to the assignment
- A statement of your partner’s personal contribution to the assignment.
Please note that assignments will NOT be marked and zero marks will be allocated if the individual statements of personal and partner contributions are not submitted.
Each group must submit a single zip file which contains all the assignment files. This includes a photograph or a scanned image of your hand-drawn map with the locations, suspects and clues, source code for each deliverable / milestone, and your group report. Each individual must also submit their own individual report of contribution statements.
|Student ID || ||Partner ID || |
|Student Name || ||Partner Name || |
|Pre-Requisites For Marking – Individual Task |
• Statement of personal contribution and partner’s contribution. Note that partners may receive different marks to reflect individual assignment contributions.
|Task||Available Marks||Student Mark|
|Paired Tasks – Note: penalty of half the available marks for work completed individually without prior written approval from the lecturer.|
|a. Hand-drawn world map detailing custom game environment, including locations, flight paths, suspects, non-player characters and clues.|
| b. Functionality as detailed in Lab 7 and Lab 8|
| c. Implementation of game play commands:|
| i. Identifying or reading clues||10|
| ii. Comparing clues with suspects to eliminate non-villains||10|
| iii. Issuing a warrant||10|
| d. Implementation of arrest sequence in final location||10|
|e. Context-specific commands, for example: arrest only available with warrant and in same location as villain.||10|
|f. Demonstration video uploaded as an unlisted file to YouTube, of no more than 5 minutes duration, providing a game demonstration, discussion of required design patterns and development methodologies as per assignment specification description||20|
| g. Report, including:|
a. User stories for each of the deliverables / milestones
b. Class diagrams for lab 7 and lab 8 functionality
c. Sequence diagrams for any two (2) of the game play commands
d. Link to the YouTube demonstration video
Assignments will be marked within 2 weeks of submission. Marks will be loaded in fdlGrades, and a completed marking sheet will be available via Moodle.
Plagiarism is the presentation of the expressed thought or work of another person as though it is one’s own without properly acknowledging that person. You must not allow other students to copy your work and must take care to safeguard against this happening. More information about the plagiarism policy and procedure for the university can be found at http://federation.edu.au/students/learning-andstudy/online-help-with/plagiarism.