LwjglApplicationConfiguration

Group 5.1

Status

INF112 RoboRally game

Used to be a simple skeleton with libgdx.

How to play

Choose a card by clicking on one of the cards to the right. These are the cards you currently have in your hand. Choosing a card will put it in the register. You can click on the card in the register to remove it again. You can submit once five cards are chosen. Pressing the submit button will cause the game round to start. Pressing the clear button will remove any chosen cards from the register. Pressing the power down button will cause your robot to go into power down mode.

You can zoom in and out by pressing '1' and '2', respectively. You can also move the screen by dragging anywhere on the map.

How to run

To run the game, run Main.java and follow the instructions.

When running, you will first be taken to the main menu screen. Here you have some options:

• Quick Play: Quickly start a game with default setup.
• Singleplayer: Set up your own game by choosing number of players, pick your own skin, select map and place flags.
• Multiplayer: Start a multiplayer game (lan) where you can either host or join someone elses session.

Multiplayer

• Click multiplayer
• Enter name when prompted (DO NOT CHOOSE SAME NAMES)
• Choose to either join or host a game
• If you click "CREATE SESSION", you will enter a lobby screen where you can see connected players and your own IP(Make sure you have a valid IP, see "known bugs" under)
• Click start game when you see all players are connected
• If you click "JOIN SESSION", enter the IP given on the host screen
• The screen will change and display "Waiting for players" when you are connected to server
• Wait for server host to start game

NOTE:

• After collecting all flags , the winner screen doesnt appear the round after. Everyone needs to submit cards.
• There is a max limit of 8 players.
• If you there is only one player in the game, the player will instantly

How to test

We have junit tests that make sure code is not broken when implementing new features. The menus screen also has some options for testing:

• Pressing 'T' or clicking the gui test button will take you to the GUI test screen.
• Pressing 'A' or clicking the ai vs ai button will do the same as QuickPlay, but all the robots are controlled by AI and you can sit back, relax, and watch the mayhem.
• Pressing 'B' or clicking the board test button will take you to a testBoard where you can move around to make sure the board interacts how it should with the player.

GUI - How to do testing for the TestScreen:

When running Main.java you will get prompted to 'PRESS ENTER'. Hitting 'T' instead will launch a test screen where you can test that ProgramCard and ProgramRegister GUI works as it should. Clicking the submit button when you have chosen five cards is not supposed to do anything here.

As instructed on the test screen, pressing 'S' will add a card to the register. Pressing 'D' will make the robot take one damage. Pressing 'R' should empty all the registers, returning all non-locked cards to the hand. Clicking on the clear button should do the same as pressing 'R'. Clicking on a specific card in the register should remove it from the register and return it to the player hand as long as it is not locked.

How to test that locked cards in the register do not return:

1. Fill up all five registers by pressing 'S' five times.
2. Press 'D' at least five times to take enough damage to lock a register.
3. Check that pressing 'R' will only return the cards that are not locked.

• Instead of pressing 'R' in step (3) you can click on the individual cards to return them. Check that locked cards are still not removed from the locked registers.

How to check that the player is unable interact with the game when dead:

1. Choose 5 cards (optional, but in the game you are not able to take damage without picking five cards).
2. Press 'D' 30+ times. Should not be able to interact with the game since the player is dead.

Tiles - How to test each of the different tiles:

• You can do this in the main game, but it's much easier to test this on the testMap.
• In the GameScreen class there is a boolean called testMap, set this to true and run Main.java.
• This will begin the game on the test map.

Controls:

• W - Forward one tile
• A - Rotate left
• S - Backup one tile
• D - Rotate right
• Each input counts as one phase, which means that the tiles do their thing right after your input.

Things to test here:

• The different types of tiles, you can find further information about each tile below.
• You fire a laser at the end of each phase.
• Other robots fire a laser at the end of each phase.
• Lasers fired by robots do not penetrate walls.
• Pushing of robots.
• Warning: The testmap does not have garbage cleaning, and respawning.(To test this use main game)
• This means that dead robot's texture won't be removed from the map, but you won't be able to interact with them
• You will not respawn if you die.

Main Game - How to do testing for the main game:

Run Main.java and press Enter when prompted to get to the main game.

Conveyor belts:

• Check that the player is moved two tiles when ending its turn on a blue conveyor belt.
• Check that player is moved one tile when ending its turn on a red conveyor belt.

When player ending its turn on a gyro:

• Check that the gyro rotates the player once in the direction that the gyro is showing.

Walls stops the player:

• Check that trying to move forward/backward into a wall will not let the player move through it.

Players get hit by board laser:

• Ending a phase in a laser should cause the robot to take damage. A robot should lose a life if the player has taken max damage (visualised by the triangular damage indicators above the health bar on the program register).

Players get hit by other players' laser:

• Same as the board laser, but the laser is shot by other robots.
• Ending a phase in front of another robot should cause you to take one damage. If you are facing a robot then the robot you are facing should take one damage.

Walking into the void (out of the map):

• Check that the player loses a life and is not returned to the board before the round is over.
• Check that the player scream sound is only played once.
• If not dead: all old cards should be gone and the player should be ready for the next round with new cards.
• If dead, meaning the player has no more lives: the player should not be returned to the map and should not be dealt any cards.

Testing power down:

Pressing the power down button should cause you to power down after you have played the current round. The robot should not move the next round and all damage taken should be removed when the power down is finished.

• Pressing the power down button before clicking the submit button should result in going into power down mode.
• Pressing the power down button a second time should toggle off the power down mode.

Settings button testing for game screen and test screen

• Pressing 'B' or clicking on the settings button located to the bottom left of the screen should bring up the settings screen.

• You should be able to mute/unmute the game by pressing 'M'.

• Pressing 'B' or Escape when in settings screen should return you to the screen you came from.

• Pressing 'N' should create a new game. You should end up at the Menu Screen where you are prompted to 'PRESS ENTER'.

  • Pressing Enter: A new game should be initiated and all progress you potentially had in an earlier game should be gone.
  • Pressing 'T' should bring up the test screen instead.

How to choose flag location and skin on robot:

When prompted to press Enter at startup, press 'S' instead. This should bring up a page where you can click on the skin you want to use. After choosing a skin, click on the map that is to the right of the black vertical line to place a flag. After placing all three flags the game should start with your chosen skin and flag locations.

Pressing 'T' instead of choosing skin and flag locations should start the game with the preset values.

Checking win condition:

• To win you need to walk into flag 1, followed by flag 2 and then finally ending a phase on flag 3 should bring up the winner screen.

Known bugs

• Currently throws "WARNING: An illegal reflective access operation has occurred", when the java version used is >8. This has no effect on function or performance, and is just a warning.
• Game freezes if the host leaves.
• If you get an IP NOT leading with 10.111.xxx.xxx , you cannot HOST the game. On our team the Mac users could host without issues, but windows users could not.
• If you click "CREATE SESSION" and press the back button, and then click "CREATE SESSION" again, you will get a bind exception