fabianishere / formula-andy

Formula One Manager written in Java

Formula Andy

Formula Andy is the State of the art Formula One Manager game, open-source and written in Java.

Getting the source

Download the source code by running the following code in your command prompt:

$ git clone https://github.com/fabianishere/formula-andy.git

or simply grab a copy of the source code as a zip file.

Building

For building the source code, we use Gradle. To run gradle, enter the following in your command prompt:

$ ./gradlew build

To test the source code, run the following code in your command prompt

$ ./gradlew test

Running

Formula Andy is a multi-player game and requires a server to run. To quickly start a test server on localhost, run the following in your command prompt:

$ ./gradlew :fa-server:runTestServer

To run the game's frontend, simply enter the following in your command prompt:

$ ./gradlew :fa-frontend-javafx:run

This will open the JavaFX frontend of the game and present a login screen. The following pre-defined users are available:

Username	Password
fabianishere	test
christov	test

License

The code is released under the MIT license. See the LICENSE.txt file.

formula-andy's Issues

Create a REST client for the server

As a developer, I want to be able to connect to the server via Java

Create draft of final report

Finish the first draft of the personal text of the final report.

Create JavaFX front-end module

Create a gradle module for a JavaFX front-end.

Create animated loading screen in JavaFX

As a user I want to see a loading screen when opening the client

Link game prediction algorithm to game lobby actor

Link the game predication algorithm Christian created to the game lobby actor, so it uses that algorithm to simulate a race game.

Refactor fa-core actors

Improve the code quality of the fa-core package by:

• putting actor messages in a message package
• implement hashCode() and equals() methods for messages
• test message classes
• putting actors in a actor package
• improve naming consistency

Load configuration from the file system

We should create a package that loads the configuration files containing the circuits, engines, tires, etc from the file system.

Design algorithm that assembles the computer teams

As a developer, the algorithm that puts together a bot team should be created

User-interface is not responsive

The user-interface elements should align properly with respect to the user's resolution

Create game domain model classes

As a developer, I want the core domain model classes to be created

Separate issues per module

Label issues according to their Gradle module instead of just back-end and front-end.

Fix stupid indentation settings for Checkstyle

2 space indentation in Java is just plain stupid. Use something more sensible like 4 spaces.

Travis does not know "openjdk8"

Travis crashes with the following error

 $ jdk_switcher use openjdk8
Sorry, but JDK 'openjdk8' is not known.
The command "jdk_switcher use openjdk8" failed and exited with 1 during .

Create a registration screen

As a user, I want to be able to create an account

Expose lobby functionality from REST endpoint

The functionality provided by a Lobby actor should be exposes by a REST endpoint of the server.

Implement HTTP authentication between client and server

As a developer, I want the user to be able to authenticate over HTTP

Refactor fa-core domain classes

Improve the equals() implementations

Example of an improved equals() implementation:

@Override
public boolean equals(Object other) {
        if (this == other) {
            return true;
        }
        if (other == null || getClass() != other.getClass()) {
            return false;
        }
        LeaveSuccess that = (LeaveSuccess) other;
        return Objects.equals(user, that.user) && Objects.equals(lobby, that.lobby);
}

The configuration file should be loaded from the file system

Test

Implement a lobby balancer

Create a lobby balancer which distributes the clients smartly across multiple lobbies, and spin up a new lobby if needed.

• Refactor Lobby actor to become offer-based
• Create a LobbyBalancer actor that delegates the requests to each Lobby

Seed database

Add data to the database

Create a store interface

As a user, I want to be able to buy new staff and material in a store

Create configuration files

Create the configuration files that contain the non-dynamic data like tires, engines, drivers, etc

Create initial version of game lobby actor

This feature should contain

• A lobby actor that can be joined by users
• A REST API endpoint that shows information about the lobby
• Error handling when lobby is full, etc

Create race prediction algorithms

As a developer, I want a real time Formula positional simulating algorithm to be formulated

Create game screen

As I user, during the game, I want to see the progress of the race and the current standings.

Create the team assembly user interface

As a user, I want to be able to put a team together in the user-interface

Create user interface design

Design the user interface elements and overall interface, including colours, etc.

Implement authentication via JPA

Allow users to be authenticated to the core via JPA

Fix checkstyle warnings

As a developer, I want the current code to pass the checkstyle checks.

Create login screen in JavaFX

As a user, I want a login screen so I can login to the server

Create emergent architecture in UML

Create an emergent architecture in UML that describes the how the code is designed and works together.

Setup Akka for core

Setup the Akka library for the fa-core module.

Add sprint reports for sprint 2

• Checkstyle reports
• JUnit reports
• JaCoCo reports

Finish persistence mappings

Create persistence mappings for all core classes

Incorrect package name in tests directory

nl.tudelft.fa.core.game should be nl.tudelft.fa.core.race

Link front-end to client

As a developer, I want to connect the GUI to be connected to the back-end code.

Allow user registration

As a developer, I want to be able to register a new user via the REST API.

Create start screen in JavaFX

As I user, I want to see a start screen, so I can select the game mode or go to the settings

Setup REST API

Set up the REST API for the server.

Create the user model

As a developer, I want to have the user model to be created

Create back-end persistence module

As a developer, I want a back-end persistence module to save the game state.

This basically means that we should persist the game state to for example a database using JPA.

Unable to launch login screen

The JavaFX front-end crashes with the error "Invalid identifier" when opening login-screen.fxml.

Add contributor pictures as required by the grading rubric

This should be done for today

Replace sprint reports with screenshots

The current sprint reports contain multiple HTML, CSS, JavaScript and image files
which litter the repository.

Images of the reports per sprint contain enough information about the
sprints and don't leave us with all these unnecessary HTML files.

• Convert existing reports to a screenshot
• Remove the unnecessary files of these reports

Fix formatting

Fix formatting, copyright headers, etc for multiple files.

Draft sprint plan for the third sprint

The sprint plan for the third sprint should be drafted.

Add new entity mappings

Add the new entity mappings for the classes Credentials and User.

Game lobby actor should start a game

Modify the game lobby actor so it starts a game after a certain time duration

Create game core module for Gradle

As a developer, I want a Gradle module for the core component of the game.

Create game specification

Determine the specifications and rules of the Formula One manager game.