a3-4300-cpp

try to clone the assignment 3 game of COMP4300 on Youtube teached by Dave Churchill

dependencies:

• SFML 2.6.1
• DearImGui 1.90
• ImGui-SFML 2.6

DEMO

Screen.Recording.2024-01-03.at.11.18.58.mov

to-do

• improve animations of brick debris
• improve animation of question block

---

Program Specification

This game must have the following features:

Assets:

• Entities in the game will be rendered using varius Textures and Animations which we will be calling Assets (along with Fonts)
• Assets are loaded once at the beginning of the program and stored in the Assets class, which is stored by the GameEngine class
• All Assets are defined in assets.txt, with the syntax defined below

Note:

• All entity positions denote the center of their rectangular sprite It also denotes the center of the bounding box, if it has one This is set via sprite.setOrigin() in the Animation class constructor

Player:

• The player Entity in the game is represented by Megaman, which has several different Animations: Stand, Run, and Air. You must determine which state the player is currently in and assign the correct Animation.
• The player moves with the following controls: Left: A, Right: D, Jump: W, Shoot: Space
• The player can move left, move right, or shoot at any time during the game This means the player can move left/right while in the air
• The player can only jump if it is currently standing on a tile
• If the jump key is held, the player should not continuously jump, but instead it should only jump once per button press. If the player lets go of the jump key mid-jump, it should start falling back down immediately
• If the player moves left/right, the player's sprite will face in that direction until the other direction has been pressed.
• Bullets shoot by the player travel in the direction the player is facing
• The player collides with 'Tile' entities in the level (see level syntax) and cannot move through them. The player land on a Tile entity and stand in place if it falls on it from above.
• The player does not collide with 'Dec' (decoration) entities in the level
• If the player falls below the bottom of the screen, they respawn at the start
• The player should have a Gravity component which constantly accelerates it downward on the screen until it collides with a tile
• The player has a maximum speed specified in the Level file (see below) which it should not exceed in either x or y direction
• The player will be given a CBoundingBox of a size specified in the level file
• The player's sprite and bounding box are centered on the player's position

Animations:

• See below for Animation asset specification
• Animations are implemented by storing multiple frames inside a texture
• The Animation class handles frame advancement based on animation speed
• You need to implement Animation::update() to properly prograss animations
• You need to implement Animation::hasEnded() which returns true if an animation has finished its last frame, false otherwise
• Animations can be repeating (loop forever) or non-repeating (play once)
• Any entity with a non-repeating animation should be destroyed once its Animation's hasEnded() returns true (has finished one cycle)

Decoration Entities:

• Decoration entities ('Dec' in a level file) are simply drawn to the screen, and do not interact with any other entities in the game in any way
• Decorations can be given any Animation in the game, but intutively they should be reserved for things like clouds, bushes, etc.

Tiles:

• Tiles are Entities that define the level geometry and interact with players

• Tiles can be given any Animation that is defined in the Assets file

• Tiles will be given a CBoundingBox equal to the size of the animation tile->getComponent().animation.getSize()

• The current animation displayed for a tile can be retreieved with: tile->getComponent().animation.getName()

• Tiles have different behavior depending on which Animation they are given

  Brick Tiles:

  • Brick tiles are given the 'Brick' Animation
  • When a brick tile collides with a bullet, or is hit by a player from below:
    • Its animation should change to 'Explosion' (non-repeat)
    • non-repeating animation entities are destroyed when hasEnded() is true
    • Its CBoundingBox component should be removed

  Question Tiles:

  • Question tiles are given the 'Question' Animation when created
  • When a Question tile is hit by a player from below, 2 things happen:
    • Its Animation changes to the darker 'Question2' animation
    • A temporary lifespan entity with the 'Coin' animation should appear for 30 frames, 64 pixels above the location of the question entity

Drawing:

• Entity rendering has been implemnted for you, no need to change that system

Bonus:

• Any special effects which do not alter game play can be added for up to 5% bonus marks on the assignment...
• You may develop a 'special weapon' that has special effects.

Misc:

• The 'P' key should pause the game
• Pressing the 'T' key toggles drawing textures
• Pressing the 'C' key toggles drawing bounding boxes of entities
• Pressing the 'G' key toggles drawing of the grid
• The 'ESC' key should go 'back' to the Main Menu, or quit if on the Main Menu

---

Level Creation

For this assignment you are also required to create your own level. This level should include some interesting gameplay. (level.txt)

---

Assets File Specification

There will be three different line types in the Assets file, each of which correspond to a different type of Asset. They are as follows:

Texture Asset Specification: Texture N P Texture Name N std::string (it will have no spaces) Texture FilePath P std::string (it will have no spaces)

Animation Asset Specification: Animation N T F S Animation Name N std::string (it will have no spaces) Texture Name T std::string (refer to an existing texture) Frame Count F int (number of frames in the Animation) Anim Speed S int (number of game frames between anim frames)

Font Asset Specification: Font N P Font Name N std::string (it will have no spaces) Font FilePath P std::string (it will have no spaces)

---

Level Specification File

IMPORTANT NOTE: All (GX, GY) positions given in the level specification file are given in 'grid' coordinates. The 'grid' cells are of size 64 by 64 pixels, and the entity should be positioned such that the bottom left corner of its texture is aligned with the bottom left corner of the given grid coordinate. The grid starts at (0, 0) in the bottom-left of the screen, and can be seen by pressing the 'G' key while the game is running.

Tile Entity Specification: Tile N GX GY Animation Name N std::string (Animation asset name for this tile) GX Grid X pos GX float GY Grid Y pos GY float

Decoration Entity Specification: Dec N X Y Animation Name N std::string (Animation asset name for this tile) GX Grid X pos GX float GY Grid Y pos GY float

Player Specification: Player GX GY CW CH SX SY SM GY B GX, GY Grid Pos X, Y float, float (starting position of player) BoundingBox W/H CW, CH float, float Left/Right Speed SX float Jump Speed SY float Max Speed SM float Gravity GY float Bullet Animation B std::string (Animation asset to use for bullets)