Welcome to the HiveGame project documentation. This project was developed as part of the LO21 course to create an application that lets users play the Hive board game, designed by John Yianni and published by Gen Four Two Games.

Project Objective

This application allows two players to play locally or a single player to face off against an AI developed by our team. In addition to the base game, two expansions will be integrated to enhance the gameplay experience. The project’s goal is to strengthen our technical development skills while building our organizational and project management abilities.

Game Rules

Goal of the Game

The primary objective is to capture the opponent's queen bee by completely surrounding it with six tiles, regardless of which player the tiles belong to. Each player must place their queen bee within the first four turns to establish the central objective.

Game Flow

The game is played without a board. Players take turns placing tiles, adhering to placement and movement rules specific to each insect type. A tile can only be moved if it follows the movement abilities of the insect it represents. The Hive must always remain connected and cannot be split into multiple parts.

Insects and Their Roles

Queen Bee

• Role: The central piece, around which the game's objective revolves.
• Movement: Moves one adjacent cell per turn.

Soldier Ant

• Role: Highly mobile, able to move around the structure.
• Movement: Unlimited cells along the Hive’s outer edge.

Grasshopper

• Role: Has the unique ability to jump over other tiles.
• Movement: Jumps in a straight line to the first free cell on the other side.

Spider

• Role: Moves exactly three cells, adding unpredictability to the game.
• Movement: Always moves exactly three cells.

Beetle

• Role: Can climb onto other pieces, blocking them.
• Movement: Moves one cell per turn and can climb on top of adjacent tiles to block them.

Expansions

• Ladybug: Moves three cells in a pattern: climbs up, crosses, and descends.
• Mosquito: Mimics the movement of adjacent pieces.
• Pillbug: Can pull an adjacent piece onto a free cell nearby, except the queen.

Development Team

• Pierre Fromont - https://github.com/Pierrafrom
• Alberic Peveraud de Vaumas - https://github.com/IceSkull08
• Benoit de Miscault - https://github.com/benoit-demiscault
• Robin Lanfranchi - https://github.com/volkoffff

Each team member has made significant contributions to both technical and organizational aspects, allowing us to maintain a robust, well-documented, and professional codebase.