What are Hanafuda?

Hanafuda are Japanese Flower Cards. Created during a period in Japan where gambling was illegal, these cards were designed to be small and concealable, as well as illustrated and beautiful so as to not look like they could be used for gambling.

A traditional Hanafuda deck is made up of 48 cards. Twelve flowers or other plants appear on the cards, making up twelve "suits," one for every month of the year. Each month has 4 cards.

---

What does this data pack do?

This pack adds a craftable Hanafuda Deck, which you can then deal Hanafuda cards from. Right click the deck while in your mainhand or offhand, or while it's in an item frame to draw a card at random. Right click the deck while sneaking to shuffle all cards in your inventory back into the deck. The same card cannot be drawn from the deck until it has been shuffled back in. Note that this means if you lose a card, it is lost from that deck, and you'll have to craft a new deck (once you realize that has happened).



Additionally, this pack adds some foundation to play a game with the Hanafuda. Many games exist that use Hanafuda, but the most popular is called Koi-Koi, and it's what's been recreated here.

This Hanafuda Deck has custom artwork that is Minecraft-focused, while still paying homage to the standard Hanafuda designs. Where able, the same flowers, plants, and animals have been used, but with Minecraft textures, such as Spruce Trees and pink Peonies. In other cases, close approximations have been made, like a Hoglin instead of a Boar. And in others still, they use more original Minecraft features, like Chorus plants instead of Chrysanthemum. Below is a list of all the plants and their month.

January:   Spruce Trees
February:  Rose Bush
March:   Flowering Azalea Leaves
April:    Weeping Vines
May:    Twisting Vines
June:    Peony
July:    Sweet Berry (Bush)
August:   Mycelium
September: Chorus
October:   Glow Berries
November:  Jungle Leaves
December:  Lilac

---

How to play Koi-Koi in Minecraft

Koi-Koi is a two-player game using one Hanafuda deck. "Koi-Koi" literally means "Come On!", a phrase used during gameplay. Once you have a Hanafuda Deck crafted, you'll also need at least 8 item frames somewhere between each player, where they can both reach. More item frames may be necessary as the game goes on.

Setup:

Choose 1 player to be the dealer. Either place the Hanafuda deck in an item frame where both players can reach it, or have the dealer hold the deck in their hotbar, somewhere convenient.

The dealer draws 4 cards from the deck and gives them to their opponent (if the deck is in an item frame, the opponent can draw for themselves), then draws 4 cards and places them in 4 of the item frames between the two players, then draws 4 cards and keep them in their inventory. Repeat this step so that both players have 8 cards in their hotbar, and there are 8 cards in item frames between the players.

Turn Procedure:

Starting with the dealer, each player's turn occurs in this order.

1. The turn player right clicks a card in an item frame while holding a card from the same month (depicting the same plant) in their mainhand. A sound and particles will indicate a successful match. The player picks up the card from the item frame, and moves both cards out of their hotbar, but still in their inventory. (They are captured)
   
   
2. The turn player draws a card from the deck (or is dealt one by the dealer) and tries to match that new card in the same way as above. If they can't, the card is placed in an empty item frame.
   
   
3. If the player has captured all the cards necessary for a Combo*, both players will be told what combo has been obtained and how many points it is worth. The turn player will be given a text prompt to either "Koi-Koi" or "Stop". If they choose Koi-Koi, the game continues until either player gets a new combo or adds to an existing one. If they Stop, the game ends and scores are calculated.

Note: If a player has no matching card in their hand for step 1, they must still place a card in an empty item frame. They still get to perform step 2.

Special Rules:

These special rules are traditional to Koi-Koi, but are not handled automatically by this data pack.

• If all 4 cards of the same month are dealt in the item frames at the start of the game, shuffle all the cards back and redeal, as the game is moot.
• If 3 cards of the same month are all in the item frames, and at any point a player makes a match with 1 of them, that player also collects all the others of the same suit (Pick up 1 of remaining 2 unmatched cards and match it with the last one, since you can't match using cards that are already captured)
• If a player is dealt all 4 cards of the same month, they automatically win the game. Shuffle all the cards back and play again!

Combos:

When a player captures all the cards for a combo, they are given the decision to Koi-Koi or end the game, counting up their points. Some combos are more valuable than others, and they are how you get scored (Even though cards have individual point values, these are traditionally for grouping certain similar cards, not for scoring).

Below are all of the combos the data pack recognizes.

• 10 Plains:         1 point, +1 for each additional Plains
• 5 Banners:        1 point, +1 for each additional Banner
• 5 Animals:        1 point, +1 for each additional Animal
• Potion + Moon:     5 Points
• Potion + Curtain:     5 Points
• 3 Poetry Banners:     6 Points
• 3 Blue Banners:     6 Points
• Hoglin-Goat-Bat:     6 Points
• Three Lights (no Creeper): 6 Points
• Four Lights (w/ Creeper): 7 Points
• Four Lights (no Creeper): 8 Points
• Five Lights:        15 Points

Ending the Game:

When a player decides to Stop after capturing a combo, the game ends and scores are calculated based on the combos the player got. Traditionally, only the player who Stopped is awarded points, and play continues for a determined number of rounds or until a determined number of points are reached. However for this data pack, the scores of both players are calculated and shown.

Importantly, the player who Stopped gets a multiplier based on the number of times Koi-Koi was called by either player. If Koi-Koi was called once, the player who Stops gets their score multiplied by 2. If twice, the multiplier is x3. This is why it can be good to Koi-Koi and keep playing if you have so far only captured a few points, in the event you are playing multiple rounds to try and catch up, but also dangerous, as your opponent may be the one who gets the bonus if they Stop first.

---

Known Bugs

• After placing a Hanafuda Deck in an item frame, you need to change your selected hotbar slot before being able to draw from the deck. This is a weird Minecraft bug with how it handles predicates and item frames, so unfortunately there's nothing I can do about it.
  
  
• In my testing, trying to capture cards while recording (either with Replay Mod or with external recording software) can be inconsistent or unreliable. I'm still working out if there is anything that can be done about this, but it probably has to do with FPS or something similar as a result of the recording.