Skip to content

Latest commit

 

History

History
101 lines (66 loc) · 3.19 KB

README.md

File metadata and controls

101 lines (66 loc) · 3.19 KB

Four in a line

Four in a line is a two-player game in which two players first select a color and then take turns dropping a token of their color from the top into a grid. The token falls straight down, occupying the lowest free cell in the grid. The first player who has four tokens in a row, either horizontally/vertically or diagonally, wins the game.

It is possible to play the game with two human players, either locally or over the network, or with one human player playing against a computer player. When playing over the network, the players can communicate using an in-game chat. The number of won/lost/drawn games of each player are stored in a highscore list.

The program was created within the scope of an assignment for the course Multimedia: Entwicklung Multimedialer Systeme.

Authors

Requirements

The game is written using the Qt framework.

  • Qt 5

Project structure

This list gives an overview over the modules/subprojects of this application.

  • app

    The main application.

  • src

    Source code for the main application.

  • src/GameLogic

    Game board and other general classes that could be used for board games.

  • src/GameLogic/FourInALine

    The four in a line game logic and artificial intelligence.

  • src/Game

    Integrates the game logic into the application. Extends the game logic making it aware of different player types and implementing network functionality. Contains classes for saving/loading games/replays. Also contains the game controller which manages the gameplay.

  • src/Game/Players

    Player classes representing the different player types (human player, AI player, network player, ...).

  • src/GUI

    The graphical user interface of the application. Contains main window and views. The main window has a menu bar and multiple toolbars containing actions for the application's functionality. The central widget of the main window is either controlled by the GameView when the user is playing a game, or by the ReplayView when the user is watching a replay.

  • src/GUI/Actions

    Containers for the application's actions which are used throughout in the GUI. The containers take care of disabling/enabling the actions according to current application state.

  • src/GUI/Widgets

    Custom widgets used by the GUI.

  • src/GUI/Dialogs

    Dialogs shown by the GUI.

  • tests

    Unit-tests.

  • resources

    Application resources like icons, images, sounds.

  • resources/qml

    The game board user interface and themes (QML).

License

Four in a line is free software and is distributed under the terms of the MIT license. The full license text is available in the LICENSE.md file.

This program uses some of the "Farm-Fresh Web Icons" from FatCow ( http://www.fatcow.com/free-icons ). They are licensed under a Creative Commons Attribution 3.0 License ( http://creativecommons.org/licenses/by/3.0/us/ ). Some icons were modified.

This program uses some of the sounds from the "Kenney Donation Pack" licensed under CC0 ( http://kenney.itch.io/kenney-donation ). They have been converted from .ogg to .wav.