Randomness
Each coin is decided by the browser's cryptographic random numbers (crypto.getRandomValues), heads or tails with equal chance. A cast is six throws of three coins: eighteen results, all recorded in the report as they fell. Nothing is adjusted afterwards, and a saved record shows the same hexagram.
The numbers are made on your device. No server takes part.
Coins and yarrow stalks do not have the same odds
With three coins the totals 6, 7, 8, 9 come with chances 1/8, 3/8, 3/8, 1/8. By the usual account of the yarrow method in the commentaries (大衍之数五十,其用四十有九) the chances are 1/16, 5/16, 7/16, 3/16: old yang is more common than old yin. This site uses coins because that is the most common method today and the easiest to check by hand.
Which passage to read
This site follows the rule set out by Zhu Xi in the 易学启蒙 (12th century). It is the most influential rule, not the only one.
| Changing lines | Read |
|---|---|
| None | The judgment of the first hexagram |
| One | That line of the first hexagram |
| Two | Both lines of the first hexagram; the upper leads |
| Three | The judgments of both hexagrams |
| Four | The two unchanged lines of the second hexagram; the lower leads |
| Five | The one unchanged line of the second hexagram |
| Six | 乾 and 坤 read their extra statement; the rest read the second judgment |
Where the text comes from
Judgments, line statements and Image lines are taken from the Zhou Yi on Chinese Wikisource, one page per hexagram. The classic is in the public domain.
- The source marks about fifty variant readings. This site prints the received text throughout; the list of choices is kept in the program.
- Simplified characters come from Wikisource's converter, keeping characters that must not be converted.
- The program has its own, separately written table of the sixty-four structures. A test compares it with the titles of all 384 lines and with both trigrams of every hexagram: they agree.
The text has not been proofread line by line by a scholar. An English translation of the classic is not included yet. If you find a wrong character, please tell us.
Who wrote the plain notes
The theme and the question beside each hexagram were written by this site, with AI assistance, from the hexagram's name, its Image and the common understanding. They are pointers for beginners, not translations and not any scholar's interpretation.
What this site does not do
- It does not attach stems, branches and "six relatives" to the lines. That is Liu Yao, a different rule set.
- It gives no luck score and no success rate.
- The cast does not depend on what your question says.
Sources
- Zhou Yi with the Image, Shuo Gua and Xi Ci commentaries; text from Chinese Wikisource, read November 2026.
- Zhu Xi, 易学启蒙, the chapter on changing lines.
- Web Crypto API of the browser.
Versions
Casting engine 0.1.0 (November 2026): three coins, Zhu Xi's rule.