Test Plan Document

1. Introduction

1.1. Version Control

Version No	Description of Changes	Date
1.0	First Version	May 10, 2024

1.2. Overview

The test plan for Ecosculptor, an ecosystem simulation game, details the testing approach to ensure game reliability, functionality, and user experience. Testing encompasses functional, compatibility, performance, and usability aspects. The usage status of the system user (player) specified in the SRS document will be tested.

1.3. Scope

This document encapsulates the test plan for Ecosculptor, including the use cases, test design specifications, and corresponding test cases.

1.4. Terminology

Acronym	Definition
GUI	Graphical User Interface
GPM	Game Play Mode

2. Features To Be Tested

This section provides brief descriptions of all significant features planned to be tested. A Test Design Specification will be added at the end of the document.

2.1. Graphical User Interface (GUI)

In this project, graphical user interface components are used. The GUI part is divided into three parts which are Main Menu and Gameplay mode. Every part of the GUI also includes smaller parts. The GUI part includes testing of the functions of GUI components which are used in the project such as button, panel, text, etc.

2.2. Game Play Mode

This part includes the test cases and test plan of the gameplay. In this mode, the player has to manage the world and keep the ecosystem stable using his many powers.The testing of these actions are to be documented in this doc.

3. Item Pass / Fail Criteria

3.1. Exit Criteria

100% of test cases are executed.
99.9% of test cases pass successfully.
All test cases categorized as High and Medium Priority pass satisfactorily.
Critical defects are addressed and resolved.
Performance quality tests meet or exceed predefined thresholds.

4. References

[1] Github, "Software Requirements Specification Document". [Online]. Available: https://github.com/CankayaUniversity/ceng-407-408-2023-2024-EcoSculptor/wiki/Software-Requirements-Specification-Document [Accessed 29 March 2024].

[2] Github, "Game Design Document". [Online]. Available: https://github.com/CankayaUniversity/ceng-407-408-2023-2024-EcoSculptor/wiki/Game-Design-Document [Accessed 29 March 2024].

5. Test Design Specifications

5.1. Graphical User Interface (GUI)

5.1.1. Subfeatures to be Tested

5.1.1.1 New Game(GPM.NG_BTN)

The "New Game" button is a user interface feature in game that allows players to start a fresh game session or initiate a new game instance with reset progress and data.

5.1.1.2 Load Game(GPM.LG_BTN)

A "Load Game" button is a user interface element in the game that allows players to resume a previously saved game session by loading saved progress and data.

5.1.1.3 Exit Game(GPM.EG_BTN)

The "Exit Game" button is a user interface element in the game that allows players to close the game and return to the desktop.

5.1.1.4 Settings(GPM.STNGS_BTN)

A "Settings" button is a user interface element in the game that provides access to adjustable options and configurations such as audio settings and graphic settings preferences.

5.1.1.5 Music Volume(GPM.MV_SLDR)

Music volume features serve two essential functions: enhancing the game’s atmosphere and evoking emotional responses from players.

5.1.1.6 Windowed(GPM.Windowed_CB)

Windowed mode allows gamers to run applications or games within a window on your screen, rather than in full-screen mode.

5.1.2. Test Cases

TC ID	Requirements	Priority	Scenario Description
GPM.NG_BTN	4.2.1	H	Select the “New Game” button. After selecting, a new game will be loaded.

TC ID	Requirements	Priority	Scenario Description
GPM.LG_BTN	4.2.1	H	Select the “Load Game” button. After selecting, the saved game will be loaded.

TC ID	Requirements	Priority	Scenario Description
GPM.EG_BTN	4.2.1	M	Select the “Exit Game” button. After selecting, the game will be closed and the player will return to the desktop.

TC ID	Requirements	Priority	Scenario Description
GPM.STNGS_BTN	4.2.1	L	Select the “Settings” button. After selecting, the settings window will be opened.

TC ID	Requirements	Priority	Scenario Description
GPM.MV_SLDR	4.2.2	L	Player adjusts music volume through the slider.

TC ID	Requirements	Priority	Scenario Description
GPM.Windowed_CB	4.2.2	L	Select the “Window” button by checking the windowed checkbox.

5.2. Game Play Mode(GPM)

5.2.1. Subfeatures to be Tested

5.2.1.1 Create Tile(GPM.CT_BTN)

The player has a tile change button in the game UI. This button offers several tile types for the player to choose from, allowing them to select the desired tile type.

5.2.1.2 Animal Spawner(GPM.A_SPW)

When certain specific conditions are met, animals will forage in the player’s valley. For instance, if a deer seeks a food source and arrives in the valley, naturally a predator may follow.

5.2.1.3 Save Button(GPM.Save_BTN)

When the player presses the "Save" button, the current state of the game is saved.

5.2.1.4 Cancel Button(GPM.Cancel_BTN)

When the player presses the "Cancel" button, it closes the settings menu.

5.2.1.5 Quit Game Button(GPM.QG_BTN)

When the player presses the "Quit Game" button, the game closes.

5.2.1.6 Player Ability Button(GPM.PAB_BTN)

When the player presses the “Player Ability” button, a window of abilities opens up, allowing the player to influence creatures within it.

5.2.1.7 Pause Button(GPM.Pause_BTN)

When this button is pressed, everything in the game shall cease movement including panels.

5.2.1.8 Continue Button(GPM.Cont_BTN)

When this button is pressed, all movement begins again.

5.2.1.9 Resource Panel(GPM.R_P)

This panel shows the amount of resources.

5.2.1.10 Animal Population Panel(GPM.AP_P)

This panel shows the population count of each animal.

5.2.1.11 Camera Movement(GPM.CM)

Makes the player move around as pleased.

5.2.2. Test Cases

TC ID	Requirements	Priority	Scenario Description
GPM.CT_BTN	4.2.3	L	Provides tile catalog on click.

TC ID	Requirements	Priority	Scenario Description
GPM.A_SPW	4.2.3	L	Animals spawn when specific conditions are met.

TC ID	Requirements	Priority	Scenario Description
GPM.Save_BTN	4.2.2	L	When the "Save" button is clicked, the game will be saved.

TC ID	Requirements	Priority	Scenario Description
GPM.Cancel_BTN	4.2.2	L	When the "Cancel" button is clicked, it will close the settings section.

TC ID	Requirements	Priority	Scenario Description
GPM.QG_BTN	4.2.2	M	When the "Quit Game" button is clicked, the player will be directed to the main menu screen.

TC ID	Requirements	Priority	Scenario Description
GPM.PAB_BTN	4.2.3	H	Click on the "player ability" button. A feature will be selected from the opened features window and the selected feature will be used in the game.

TC ID	Requirements	Priority	Scenario Description
GPM.Pause_BTN	4.2.3	L	Select “Pause” button. After selecting, the simulation will be stopped.

TC ID	Requirements	Priority	Scenario Description
GPM.Cont_BTN	4.2.3	L	Select “Continue” button. After selecting, the simulation will continue.

TC ID	Requirements	Priority	Scenario Description
GPM.R_P	4.2.3	H	Check the Resource Panel for usable resources.

TC ID	Requirements	Priority	Scenario Description
GPM.AP_P	4.2.3	H	Check the Animal Population Panel for animal count.

TC ID	Requirements	Priority	Scenario Description
GPM.CM.01	4.2.3	H	Press the “w” button to move forward
GPM.CM.02	4.2.3	H	Press the “s” button to move backward.
GPM.CM.03	4.2.3	H	Press the “d” button to move to the right.
GPM.CM.04	4.2.3	H	Press the “a” button to move to the left.
GPM.CM.05	4.2.3	H	Press the “q” button to rotate to the left.
GPM.CM.06	4.2.3	H	Press the “e” button to rotate to the right.
GPM.CM.07	4.2.3	H	Scroll up to move to zoom in.
GPM.CM.08	4.2.3	H	Scroll down to move to zoom out.

6. Detailed Test Cases

TC ID	GPM.NG_BTN
Purpose	A new game is loaded.
Requirements	4.2.1
Priority	High
Estimated Time Needed	Less than a minute
Dependency	Cursor.
Setup	Ensure the button appears in the main menu.
Procedure	The player presses the “New Game” button.
Cleanup	Exit from the game.

TC ID	GPM.LG_BTN
Purpose	The saved game is loaded.
Requirements	4.2.1
Priority	High
Estimated Time Needed	A minute
Dependency	Cursor.
Setup	Ensure the button appears in the main menu.
Procedure	The player presses the “Load Game” button.
Cleanup	Exit from the game.

TC ID	GPM.EG_BTN
Purpose	The game is closed and the player returns to the desktop.
Requirements	4.2.1
Priority	Medium
Estimated Time Needed	Less than a minute
Dependency	Cursor.
Setup	Ensure the button appears in the main menu.
Procedure	The player presses the “Exit Game” button.
Cleanup	Exit from the game.

TC ID	GPM.STNGS_BTN
Purpose	The settings window will be opened.
Requirements	4.2.1
Priority	Low
Estimated Time Needed	Less than a minute
Dependency	Cursor.
Setup	Ensure the button appears in the main menu.
Procedure	The player presses the “Settings” button.
Cleanup	Exit from the game.

TC ID	GPM.MV_SLDR
Purpose	Increases and decreases level of music volume
Requirements	4.2.2
Priority	Low
Estimated Time Needed	less than a minute
Dependency	Cursor.
Setup	Ensure the button appears at the bottom of the gameplay screen.
Procedure	The player slides Music Volume slider. Right for increase and left for decrease.
Cleanup	Exit from the settings menu.

TC ID	GPM.Windowed_CB
Purpose	Changes fullscreen to windowed mode.
Requirements	4.2.2
Priority	Low
Estimated Time Needed	less than a minute
Dependency	Checkbox
Setup	The button should appear on the bottom of the gameplay screen.
Procedure	The player checks or unchecks the windowed checkbox.
Cleanup	Exit from the settings menu.

TC ID	GPM.CT_BTN
Purpose	Provides tile catalog.
Requirements	4.2.3
Priority	Medium
Estimated Time Needed	less than a minute
Dependency	Cursor.
Setup	The button should appear on the bottom of the gameplay screen.
Procedure	The player presses the “Tile” Image button.
Cleanup	Pressing the tile button toggles this process.

TC ID	GPM.A_SPW
Purpose	Spawn animals at specific conditions.
Requirements	4.2.3
Priority	High
Estimated Time Needed	Depends on player.
Dependency	Existing tile types in game.
Setup	Confirm active game environment and existing tile types.
Procedure	Spawn animals based on specific conditions.
Cleanup	Release temporary resources and update game state variables.

TC ID	GPM.Save_BTN
Purpose	Save the current game correctly.
Requirements	4.2.2
Priority	Low
Estimated Time Needed	2 minutes
Dependency	Having a clickable "Save" button.
Setup	The necessary code must be present to save the playerprefs structure to the system.
Procedure	The player presses the “Settings” button then presses the “Save” button.
Cleanup	Exiting the in-game-settings Menu.

TC ID	GPM.Cancel_BTN
Purpose	Close the settings Menu.
Requirements	4.2.2
Priority	Low
Estimated Time Needed	less than a minute
Dependency	Having a clickable "Cancel" button.
Setup	The button should appear at the bottom left of the in-game-settings menu screen.
Procedure	The player presses the “Settings” button then presses the “Cancel” button.
Cleanup	Exiting the in-game-settings Menu.

TC ID	GPM.QG_BTN
Purpose	Closing the game and opening the Main Menu.
Requirements	4.2.2
Priority	Medium
Estimated Time Needed	less than a minute
Dependency	Pressing the "Quit Game" button in the in-game-settings menu.
Setup	The button should appear on the bottom in-game-settings Menu screen.
Procedure	The player presses the “Quit Game” button on the in-game-settings Menu.
Cleanup	Exiting the in-game-settings Menu.

TC ID	GPM.PAB_BTN
Purpose	Provides “Player Ability” catalog.
Requirements	4.2.3
Priority	High
Estimated Time Needed	less than a minute
Dependency	Cursor.
Setup	The button should appear on the bottom of the gameplay screen.
Procedure	The player presses the “Player Ability” Image button.
Cleanup	Pressing the “Player Ability” button toggles this process.

TC ID	GPM.Pause_BTN
Purpose	Pauses the game correctly.
Requirements	4.2.3
Priority	Low
Estimated Time Needed	1 Minute
Dependency	Selecting the “Pause” button in the game.
Setup	The button should appear on the gameplay screen.
Procedure	The player presses the “Pause” button and stops the game.
Cleanup	Press Continue Button

TC ID	GPM.Cont_BTN
Purpose	Continue the game correctly.
Requirements	4.2.3
Priority	Low
Estimated Time Needed	1 Minute
Dependency	Selecting the “Continue” button in the game.
Setup	The button should appear on the gameplay screen.
Procedure	The player pressing the “Continue” button and continuing the game.
Cleanup	Press Pause Button

TC ID	GPM.R_P
Purpose	Shows the resource amount.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Showing the “Resource Panel” in the game.
Setup	The panel should appear on the gameplay screen.
Procedure	The player checks the resource amount shown on the panel
Cleanup	None

TC ID	GPM.AP_P
Purpose	Shows the Animal Population amount.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Showing the “Animal Population” in the game.
Setup	The panel should appear on the gameplay screen.
Procedure	The player checks the population of animal species shown on the panel
Cleanup	None

TC ID	GPM.CM.01
Purpose	Move the camera forward.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Press the “w” button.
	Verify that the first camera is moved forward
Cleanup	Exit

TC ID	GPM.CM.02
Purpose	Move the camera backward.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Press the “s” button.
	Verify that the first camera is moved backward.
Cleanup	Exit

TC ID	GPM.CM.03
Purpose	Move the camera right.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Press the “d” button.
	Verify that the first camera is moved right.
Cleanup	Exit

TC ID	GPM.CM.04
Purpose	Move the camera left.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Press the “a” button.
	Verify that the first camera is moved left.
Cleanup	Exit

TC ID	GPM.CM.05
Purpose	Rotate the camera right.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Press the “q” button.
	Verify that the first camera is rotated right.
Cleanup	Exit

TC ID	GPM.CM.06
Purpose	Rotate the camera left.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Press the “e” button.
	Verify that the first camera is rotated left
Cleanup	Exit

TC ID	GPM.CM.07
Purpose	Zoom the camera in.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Scroll the mouse wheel up.
	Verify that the first camera is zoomed in
Cleanup	Exit

TC ID	GPM.CM.08
Purpose	Zoom the camera out.
Requirements	4.2.3
Priority	High
Estimated Time Needed	2 Minute
Dependency	Gameplay mode should be started.
Setup	Movement of the camera should be scripted.
Procedure	Scroll the mouse wheel down.
	Verify that the first camera is zoomed out
Cleanup	Exit