This project is a web-based card game that allows you to play the Japanese card game Koi-Koi against an AI opponent. This game features beautiful artwork created by various artists, and the primary goal of the project is to share these designs by making them playable online.
Play now at https://newhanafuda.art!
Koi-Koi is a simple card game that is typically played with hanafuda (literally "flower cards"). In this web-based version, the game is played with a standard 48-card deck. The objective of the game is to score points by collecting sets of cards, called "yaku". Points are awarded based on the number of yaku collected, and the player with the most points at the end of the game wins.
To play, simply click on the "Play now" button on the homepage. You will be dealt a hand of cards, and the AI opponent will be dealt a hand as well. To collect sets of cards, you must match cards in your hand with cards on the table that share the same suit (flower). Once you have collected a yaku, you will be prompted to continue (and possibly collect more yaku) or end the round and score points.
The game ends when all cards have been played, or when one player reaches a predetermined number of points. Coins obtained in game can be used to unlock different hanafuda designs!
Many different rules and game variants exist for Koi-Koi. This version offers some optional scoring rules with more to be added. More in-depth guides on rules and scoring can be found using the links below.
The artwork featured on this site was created by various artists. The history of Hanafuda reaches back quite far, but new reimaginations of the classic designs continue to surface to this day!
The currently available designs in the game are attributed to the following artists:
| Design | Artist |
|---|---|
| Modern Hanafuda | Sarah Thomas |
| Moon Rabbit Hanafuda | Kelsey Cretcher |
| Nishiki Fuda | Estudio Artes |
| Pokemon Hanafuda | Sabling |
| Koinobori & Hanami Hanafuda | IndianWolf Studios |
| Hanafuda | Parish Cherry |
| Hanamaki Hanafuda | Tsuruta |
| Vaporwave Hanafuda | Heavenlysome |
Whether you're an artist, developer, or fellow hanafuda enthusiast, contributions are certainly welcome! Check our CONTRIBUTING page to see how you can contribute to this project!
If you would like to run a local copy for development or testing purposes, follow these steps:
- Clone the repository to your local machine.
- Install the necessary dependencies by running npm install in the root directory of the project.
- Run the development server by running npm run dev.
- Navigate to http://localhost:3000 in your web browser.
This project was built using the Nuxt.js, Vue.js, and TypeScript.
This project was created by our contributors and is licensed under the MIT License. All artworks used in the game are attributed to and are property of the respective artists.