Jokerly

How far is your rack from every hand on your card?

Jokerly is an American mahjong helper in ChatGPT. Snap a photo of your rack: Jokerly counts how many tiles away you are from each hand on your card, says which three tiles to pass in the Charleston, and tells you whether a joker swap is legal.

The counting is done by a rules engine, not guessed: jokers only in groups of three or more, every suit and every number the hand allows.

Coming soon to ChatGPTHow it works in ChatGPT
Your rack · 13 tilesJokerly practice hands
2BAM2BAM4BAM4BAM6BAM6BAM8BAMFFLOWERFFLOWERJJOKERNWIND9DOT3CRAK
  1. #1 Even Steps4 tiles away
    FF 222a 444a 666a 888a
    FFLOWERFFLOWER2BAM2BAMJJOKER4BAM4BAM4BAM6BAM6BAM6BAM8BAM8BAM8BAM

    Needs 4 Bam, 6 Bam and 8 Bam ×2 (jokers can stand in).

  2. #4 Run of Five7 tiles away
    11a 22a 333a 444a 5555a · any numbers
    2BAM2BAM3BAM3BAM4BAM4BAMJJOKER5BAM5BAM5BAM6BAM6BAM6BAM6BAM

    Needs 5 Bam ×3 and 6 Bam ×2 (jokers can stand in); 3 Bam ×2 (natural tiles only, no jokers).

  3. #8 Pairs Parade7 tiles away
    NN SS 11a 22a 33a 44a 55a · any numbers · concealed
    NWINDNWINDSWINDSWIND2BAM2BAM3BAM3BAM4BAM4BAM5BAM5BAM6BAM6BAM

    Needs 3 Bam ×2, 5 Bam ×2, North and South ×2 (natural tiles only, no jokers).

Three questions it answers at the table

  1. How close am I?

    Every hand on your card, ranked by tiles away, with the tiles each still needs and where a joker can stand in.

  2. What do I pass?

    Jokerly tries every set of three tiles and keeps the pass that leaves you closest, never a joker. On the last pass it says when a blind pass saves a tile.

  3. Can I take that joker?

    Exposure, timing and tile checked against the standard rules, plus whether the swap brings you closer.

Bring your own card

Jokerly comes with no league's card. Type or photograph the hands on the card your table plays, and Jokerly saves them for you alone: never shared, never pooled with anyone else's. Until then, try its own practice hands.

A hand is written the way it reads on a card, with a letter for each suit color: FF 2222a 4444b 6666c. See how to write a hand.

Try saying

  • “Here's my mahjong rack [photo]. How far am I from the hands on my card?”
  • “What three tiles should I pass right in the first Charleston?”
  • “Can I swap my 5 Dot for the joker in their 5 Dot pung?”
  • “Save these hands from my card: [photo of your card]”
Coming soon to ChatGPT

Questions

Does Jokerly include this year's card?
No. Card hands belong to their publishers, so Jokerly ships none. You save the hands from your own card, privately.
How does it read my tiles?
ChatGPT reads the photo and passes the tiles to Jokerly. Jokerly shows every tile it got, so you can fix a misread one with a tap.
Does it work for any card?
Any card whose hands are 14 tiles in groups: you write each line in Jokerly's notation, once.
Does it keep score?
No. Jokerly counts tiles and checks rules; it keeps no score and handles no money.