Game Screens

Introduction

The game contains several screen which which each implement libgdx's ScreenAdapter interface. Screen are responsible for initiating important game services, loading screen resources, drawing the background and UI, rendering the entities, handling input, etc.

Only one screen is shown at a time and GDXGame.java contains functionality for transitioning between screens. Screen transitions are triggered by the current screen.

Within the base game, there are 5 screens: Main Menu Screen, Main Game Screen, Level Screen, Death Screen, Victory Screen and Settings Screen. The Main Menu Screen is the starting screen.

Screens can also be split into different Game Areas which can be used to create different levels and areas. Read more here!

Usage

Add a new screen

Create a new screen class, e.g. NewScreen.

  public class NewScreen extends ScreenAdapter {
    ...
  }

Then, register the new screen in GDXGame.java by adding NEW_SCREEN to ScreenType and modifying newScreen:

  private Screen newScreen(ScreenType screenType) {
    switch (screenType) {
      ...
      case NEW_SCREEN:
        return new NewScreen(this);
      ...
    }
  }

  public enum ScreenType {
    MAIN_MENU, MAIN_GAME, SETTINGS, NEW_SCREEN
  }

Switch screen

  private void switchScreen(GdxGame game, ScreenType screenType) {
    game.setScreen(screenType);
  }

Switching to Death/Victory Screen

public class PlayerStatsDisplay extends UIComponent {
  public static boolean gameOver
}

gameOver is used as the global tracker for when the player is defeated. Death Screen should then be triggered using the switch screen method shown above.

Global tracker for victory condition to be implemented (when the game has a winning objective)