Multiple Maps Explanation

Overview

In sprint 3 we decided to add the multiple maps feature to the game to improve the game playability. We decided to add a portal after winning the spaceship in order to provide an entrance to the bonus map. In the bonus map, there will be no monsters and player are free to collect more and more gold before hitting the exit portal. Background image for the bonus map is here. BGM for the bonus map is here.

UML diagram

Code implementation

Rock road

Under the com/deco2800/game/areas/terrain/TerrainFactory.java file, we added a new terrainType ROCK_ROAD:

   case ROCK_ROAD:
     TextureRegion rockRoad =
         new TextureRegion(resourceService.getAsset("images/rock.jpg", Texture.class));
     return createRockRoadTerrain(1, rockRoad);

In order to create rock road terrain and tiles, two private functions have been created:

   private TerrainComponent createRockRoadTerrain(float tileWorldSize, TextureRegion road) {
    GridPoint2 tilePixelSize = new GridPoint2(road.getRegionWidth(), road.getRegionHeight());
    TiledMap tiledMap = createRockRoadTiles(tilePixelSize, road);
    TiledMapRenderer renderer = createRenderer(tiledMap, tileWorldSize / tilePixelSize.x);
    return new TerrainComponent(camera, tiledMap, renderer, orientation, tileWorldSize);
   }

   private TiledMap createRockRoadTiles(GridPoint2 tileSize, TextureRegion road) {
    TiledMap tiledMap = new TiledMap();
    TerrainTile grassTile = new TerrainTile(road);
    TiledMapTileLayer newLayer = new TiledMapTileLayer(MAP_SIZE.x, MAP_SIZE.y + 47, tileSize.x, tileSize.y);
    fillTiles(newLayer, MAP_SIZE, grassTile, 49);
    tiledMap.getLayers().add(newLayer);
    return tiledMap;
   }

After that, we added one parameter int vertical into fillTiles() function, so that the tiles can be filled in the given vertical height. Based on the above code, some public functions have been created in order to be called under com/deco2800/game/screens/MainGameScreen.java to realize the scrolling terrain:

   switch (newMapStatus) {
     case Off:
         ...
     case On:
         // Render terrains on new map
         if (screenVector.x > (2 * counter + 1) * 10) {
             counter += 1;
             forestGameArea.spawnTerrainRandomly((int) (screenVector.x + 2), TerrainFactory.TerrainType.ROCK_ROAD);
         }

Background image

In order to draw image on certain vertical height. We added an global variable private float vertical = 0; into com/deco2800/game/rendering/BackgroundRenderComponent.java, and created a public function to manually adjust the height of background:

    /**
     * Set the vertical start point for the background texture
     * @param y vertical value
     */
    public void setVertical(float y) {
        vertical = y;
    }
   
    @Override
    public void draw(SpriteBatch batch) {
        batch.draw(texture, -30, 0, 30, 15);
        batch.draw(texture, horizontal, 0, 30, 15);
        batch.draw(texture, -30, vertical, 30, 15);
        batch.draw(texture, horizontal, vertical, 30, 15);
    }

After that, under com/deco2800/game/areas/ForestGameArea.java, we created the following function to show new map scrolling background image on given height:

    public void showNewMapScrollingBackground(int counter, float vertical) {
        Entity gameBg = new Entity();
        BackgroundRenderComponent newBg = new BackgroundRenderComponent("images/background_2.png");
        newBg.setHorizontal(30f * counter);
        newBg.setVertical(vertical);
        gameBg.addComponent(newBg);
        spawnEntity(gameBg);
    }

Last but not least, call showNewMapScrollingBackground and set its vertical parameter according to the player current position under com/deco2800/game/screens/MainGameScreen.java.

Switch BGM

Under com/deco2800/game/areas/ForestGameArea.java, created four public functions, which can be called to play or stop corresponding BGM from other class.

    public void playMusic() {
        Music music = ServiceLocator.getResourceService().getAsset(BACKGROUNDMUSIC, Music.class);
        music.setLooping(true);
        music.setVolume(0.3f);
        music.play();
    }

    public void playNewMapMusic() {
        Music newMusic = ServiceLocator.getResourceService().getAsset(NEWMAP_BACKGROUNDMUSIC, Music.class);
        newMusic.setLooping(true);
        newMusic.setVolume(0.3f);
        newMusic.play();
    }

    public void stopMusic() {
        ServiceLocator.getResourceService().getAsset(BACKGROUNDMUSIC, Music.class).stop();
    }

    public void stopNewMapMusic() {
        ServiceLocator.getResourceService().getAsset(NEWMAP_BACKGROUNDMUSIC, Music.class).stop();
    }

After creating above functions, we can call these functions under com/deco2800/game/screens/MainGameScreen.java to realize switching BGM between regular map and bonus map.

Multiple Maps Explanation

Overview

Code implementation

Rock road

Background image

Switch BGM

Rocks and woods piling up

Overview

Code implementation

Line of rock flying in the air

Create rock pyramid type 1

Create rock pyramid type 2

Create rock rocks collum from the ground up

Create rocks collum from the sky down

Create large rock pyramid

UML diagram

Overview

BackgroundRenderComponent & MainGameScreen

ForestGameArea

Sequence diagram

Gameplay

Game Design

Features Design

Code Guidelines

Background Music Selection

Achievements Ecosystem - Code Guidelines

Food and Water System

Asset Creation

User Testing

Achievements User Testing

Testing

Game Engine

Troubleshooting

Clone this wiki locally