Card game AZI

Project Name:

Card Game AZI with Trading and Bidding Elements

Project Goal:

Development of a cross-platform mobile application for playing the card game Azi, as described in the provided rules. The application should be available on iOS and Android platforms and support online multiplayer gameplay.

Functional Requirements:

1. Authorization and Registration:
   • Ability to register via email, phone, or through social networks (Google, Apple, Facebook).
   • Ability to log into the account using a password, fingerprint, or Face ID.
   • Support for guest login without registration.
2. Main Menu:
   • Button "Start Game" to create or join a new game.
   • Button "Settings" to manage game and profile parameters.
   • Button "Game Rules" to familiarize with the rules.
   • Button "Store" for purchasing in-game currency or items (if applicable).
3. Game Modes:
   • Multiplayer Game:
     • Online Mode: Play over the internet with other players.
   • Training: Mode for learning the game and practicing against AI without betting.
4. Card Dealing:
   • Automatic determination of the card dealer.
   • Animation of shuffling the deck and dealing cards.
   • Display of the trump card with animation.
   • Ability for players to refuse to participate in the game after the trump card is revealed.
5. Trading:
   • Interface for betting and raising bets.
   • Support for "blind" trading and after the cards are revealed.
   • Highlighting the current turn and animation for raising bets.
6. Bidding:
   • Interface for selecting cards for the turn.
   • Automatic rule checking (suit presence, need to beat with a trump, etc.).
   • Counting tricks and determining the winner of the bidding.
7. Additional Rules:
   • Implementation of the "different suit" rule with corresponding interface hints.
   • Ability to propose "Azi" to other players, as well as automatic checking for meeting conditions.
8. User Interface (UI):
   • Intuitive and simple interface with gesture support.
   • Design adapted for various screen sizes.
   • Display of player avatars, their bets, and the current state of the game.
   • Visualization of the deck, trump, bets, and tricks.
9. Sound and Music:
   • Background music with the option to turn off.
   • Sound effects for shuffling cards, dealing, turns, betting, etc.
   • Ability to choose sound packs.
10. Settings:
    • Sound and music settings.
    • Display settings (theme, brightness, language, etc.).
    • Ability to manage notifications.
11. Social Features:
    • Ability to add friends
    • Chat for communication with other players during the game.
    • Ability to send game invitations via social networks or messengers.
    • VIP table by invitation
12. Store (optional):
    • Ability to purchase unique avatars, themes, and sound packs.
13. Integration with Platforms:
    • Support for cloud synchronization (e.g., via Google Play Games or Apple Game Center).
    • Support for achievements and leaderboards.
    • Separate achievements and leaderboards for VIP tables

Technical Requirements:

1. Platforms:
   • iOS: Support for iOS 13 and above.
   • Android: Support for Android 8 and above.
2. Development:
   • Development on cross-platform frameworks such as Flutter or React Native.
   • Use of responsive design to support different screen sizes.
   • Ensuring stable application performance with weak internet connection.
3. Server Side (for online mode):
   • Ensuring secure data transmission (HTTPS).
   • Using reliable servers for data storage and matchmaking.
   • Data backup and the ability to restore the game in case of connection loss.
4. Testing:
   • Testing on various devices with different OS versions.
   • Unit tests for critical functions.
   • User interface and interaction testing.

Support and Updates:

1. Release and Support:
   • Publishing the application in the App Store and Google Play.
   • Providing regular updates with bug fixes and functionality improvements.
   • User support through feedback system within the application.
2. Updates:
   • Periodic updates with new features, themes, and improvements.
   • Ensuring compatibility with new versions of iOS and Android.

Implementation Timeline:

Development of the application from scratch to release in the markets should take approximately 1-2 months, considering all testing stages.


Game Rules:

           The game uses a deck of 27 cards, with a total of 3 suits. Each suit is represented by cards from 6 to Ace. The suits of the cards can be any. The game consists of 2 stages: card dealing and bidding. Before the game starts, each player bets an agreed amount of money (for example, 10 rubles). Then the players deal cards.

          Card Dealing. The first dealer is determined by drawing lots. In subsequent games, players deal cards in turn clockwise. After determining the dealer, the deck is thoroughly shuffled, divided into two parts, where the top part is placed under the bottom one, and each player is dealt 3 cards from the top of the deck. The last dealt card (which must be the dealer's card) is revealed by the dealer, and the suit of this card becomes the trump suit. Players who do not wish to play after the trump is shown announce this and discard their cards on the table. Those who agree to play begin the game.

          After Card Dealing. Players bid in the dark without revealing cards. The bidding starts with the player from whom the dealing began. For the following players who bid in the dark, the bet must be raised by at least 1.5 times compared to the previous player. For those who did not bid in the dark, after the cards are revealed, the bets made in the dark are doubled.

          Trading. The first to act is the player sitting to the left of the dealer. He must state a bet higher than the one on the table and place that money on the table. If he does not want to raise the bet, he passes his turn. Raising the bet is allowed no more than 3 times for all players in the game. If all players pass except one, the trading ends and the bidding begins.

          Bidding. The first turn in the first bidding round belongs to the player sitting to the right of the player who won the trading. This player can place any card on the table, and each subsequent player clockwise must place a card of the same suit, and if they do not have a card of that suit, they must place a trump card; if they do not have a trump card, they can place any card. When each player places one of their cards, a trick is formed from the cards, which is taken by the player who placed the highest card. The player who first takes 2 tricks takes all the money bet. If no player takes more than 1 trick, it means a draw, called Azi, after which players who took 1 trick in the previous bidding round play for the pot. The player who did not take any tricks in the previous bidding round must contribute half of the money in the pot to participate in the bidding. A player who did not participate in the bidding must place the same amount of money as in the pot to participate in the new bidding. The card dealing in the new bidding is done by the dealer if he participates in this bidding; if not, the cards are dealt by the player who took the last trick. After dealing the cards, trading and bidding proceed according to the rules described above.

There are 2 additional rules in the game:

A player who has a trump Ace and 2 cards of the same suit has the right to declare "different suit," which means the player's goal is to prevent other players from taking two tricks; in this case, the player is not obliged to beat the first card of the turn with their trump Ace if they do not have a card of that suit, but if the second turn is made in the same suit during the bidding, then it is mandatory to beat with the Ace.

Players have the right to invite each other to Azi, which means a game that does not allow other players to take more than one trick, and if one of such players takes 2 tricks, then the player does not take the pot but participates in the repeat bidding as a player who took one trick.