Summary

Project Card Combat is a turn based card game that pits the user against a Computer AI that can be played on your Android devices. Project Card Combat lets the user create decks to beat the AI and allows the user to set conditions for the AI for the purpose of challenging other users. The game opens to a menu allowing the user to choose whether they wish to make a deck, play against the computer with their created decks, attempt the challenge quests, set conditions for AI for the user created challenge quests, and export their created decks and challenge quests via a generated QR code.

The purpose of this project originally was to act as a goal to facilitate the learning of Java and Android by the development team as all on the team had played and enjoyed card games before. As development continued the team had more potential than previously expected as an almost puzzle-like game to challenge one’s mind. What makes this card game unique among card games is the belief that the gameplay of Project Card Combat is something hasn’t been done many times before.

Two of the key functionalities of Project Card Combat will be the persistent data and the camera functionality. Persistent data will be necessary as the user will be able to create new decks and save them for future use. The camera of the Android device will be necessary to use the qr scanner portion of the app although if the then current user’s device is lacking a camera then such functionality will be missing though the rest of the application will still work.

Intended users

• People who would like to pass some time with a quick simple game.

  As someone who at times feels bored, I need an app that allows me to pass some time playing a game, so that I’m not wasting my time doing absolutely nothing but instead keeping my brain active.

• People who enjoy solving puzzles and thinking challenges.

  As someone who enjoys solving a good puzzle, I would like an app that lets me play pre-made challenges that come with the app and after beating those the ability to play and create user created challenges, so that my friends and I can continue having fun with each other.

Current State of the Application

• Current State

  • All screens are set up with custom, button based navigation.

  • The application uses Google Sign In as an external service.

  • Data from the application is being stored in a SQLite database.

• Current Issues

  • Camera functionality has not been implemented yet.

  • Game logic has not been implemented yet.

  • Qr code generation has not been implemented yet.

• Possible Aesthetic/Cosmetic Enhancements

  • More art enhancements to the unit cards art.

  • A better color theme.

• Stretch Goals/Possible Enhancements

  • PvP over bluetooth.

  • The ability to share decks with other users over bluetooth.

Functionality

• Create custom-made decks.
  • The user chooses 3 units cards out of 7 and then chooses 5 attackType cards for each unit for a total of a 15 card deck.
    • There 3 types of attackType cards that can be chosen for a unit, red cards, blue cards, and green cards and one of each must be a chosen for a unit.
      • Red cards deal 1.5 times damage
      • Blue cards deal 1 times damage and build up the unit’s magic gauge.
      • Green cards deal 0.8 times damage and generate stars that increase the odds of a critical hit for other cards during the next turn.
    • The unit cards have stats on them (i.e. HP, ATK, and CRITICAL CHANCE) and active abilities on them (i.e. Heal)
      • The user may also choose certain active abilities for the units though this may be subject to change.
      • The units have a sort of Rock Paper Scissors style of effectiveness against each other.
• Play games against the computer with their created decks.
  • The game starts with the user’s 3 unit cards placed on the field.
  • At the start of the user’s turn, the user then draws 5 cards from their deck and any critical stars are distributed to the attackType cards.
  • The user then can choose to either activate the unit cards’ active abilities or enter the attackType phase.
  • In the attackType phase the user chooses 3 cards of the 5 to attackType the computer with and discards the other two.
    • (Note: Once the deck has been emptied, the played cards and the discarded cards are shuffled together and form another deck to draw from again.)
  • The computer’s turn then comes and plays similarly to the user’s.
  • The user’s turn then comes and this repeats until either the user or the computer wins.
  • Please note that gameplay of Project Card Combat is currently subject to change depending on balance testing.

• Play pre-made challenge quests or user created challenge quests.

• Set conditions for AI for the user created challenge quests.

• Create QR codes for custom-made decks or challenge quests.

• Scan QR codes to receive custom-made decks or challenge quests.

Build instructions

1. Go to the Card Combat Project Github

2. With SSH selected, click on the green Code button and then click on the clipboard icon to copy the link.

3. Turn on either IntelliJ IDEA or Android Studio and select new project from version control and then paste the copied link into URL field and click Clone.

4. Once the IDE has finished downloading everything, run the project by clicking the green hammer icon or clicking Build Project in the Build Menu.

5. Once the IDE has finished building the project, click the green arrow button or click the ‘Run Card Combat.app’ button in the Run menu.

User Instructions

Technical Requirements and Dependencies

Javadoc-Generated Technical Documentation

Wireframe

Entity-Relationship Diagram

Data Definition Language (DDL)

Data Model Implementation

External or Device-Based Services

Copyright & License Information