Reading time: ~12 minutes. Last updated: 18 June 2026. Author: yifubob.
Short answer: Qimen Dun Jia (奇门遁甲, sometimes written Qi Men Dun Jia, often abbreviated QMDJ) is a 3,000-year-old Chinese system for evaluating a moment in time and choosing the best action. It uses a 3-by-3 grid of nine palaces, eight symbolic doors, nine stars, and a rotating calendar of heavenly stems to model the "shape" of any given moment. It is not a fortune-telling tool, and on this site we treat it as an educational subject and a structured reflection aid, not a prediction engine.
You are reading the most thorough free English introduction to Qimen Dun Jia on the open web. There is no signup, no paywall, and no prediction service behind it. Just the historical, cultural, and structural facts, written by an engineer who happens to find the system fascinating from a systems-thinking perspective. If you want the academic background first, the English Wikipedia entry on Qimen Dun Jia is a fair secondary reference, and we cross-check our own explanations against it.
If you have ever asked "what is Qimen Dun Jia, really?" the cleanest answer is this: it is a Chinese decision-support framework, born in an era when generals needed to choose a battle hour, an envoy needed to pick a travel day, and a merchant needed to weigh a deal. The system was designed to reduce the chaos of high-stakes choice to a structured snapshot of a single moment.
The traditional origin story places Qimen Dun Jia in the late Neolithic period, tied to the legendary Yellow Emperor (Huangdi) and his campaign against the warlord Chi You. The story goes that Chi You could summon fog, and the Yellow Emperor, trapped and disoriented, received instruction from a divine figure often called the "Goddess of the Nine Heavens" (九天玄女). She handed down a structured way of reading the hour and the direction. Whether you read that as history or myth, the important fact is that the system was already framed, in its earliest legends, as military technology, not prophecy.
By the Warring States period (475–221 BCE), the system was being written into treatises. The Han Dynasty (206 BCE – 220 CE) saw it move from military classics into a broader scholar's library, and the Tang (618–907 CE) and Song (960–1279 CE) dynasties standardized the calculation methods. The version most Western students learn today was largely fixed in the Ming Dynasty (1368–1644 CE), the era when the strategist Liu Bowen (1311–1375) is associated with the system. For the wider context of how Chinese metaphysics evolved in that period, the Wikipedia article on Chinese metaphysics is a reasonable starting point.
That long history matters because it explains why Qimen Dun Jia survives at all. It is not a passing trend. It is a 3,000-year-old information design problem: how do you represent the quality of a moment, with paper and pen, well enough that two different readers, in two different centuries, can agree on what the moment looked like?
Every Qimen Dun Jia chart is built from three stacked layers, sometimes called the three boards or three rings. They are called Heaven (天盘), Earth (地盘), and Human (人盘). Think of them as three transparent sheets laid on top of each other over the same 3-by-3 grid.
The bottom layer, Earth, is fixed. It carries the palace layout and the rotating cycle of heavenly stems. It does not change based on your question. The middle layer, Human, places the eight doors around the grid and reflects the actionable surface of the moment. The top layer, Heaven, places the nine stars and shows the hidden, more strategic energy of the moment. The way these three layers line up over a single palace is what the practitioner reads.
There is also a fourth overlay used in some schools, the Deity plate (神盘), which carries the Eight Deities and provides a moral or symbolic tone. Not every Qimen Dun Jia practitioner uses it. Different schools emphasize different layers. This is one reason the system feels more like a framework family than a single rulebook.
The genius of the three-board design is that it separates the structural facts of time from the qualitative mood of the moment and the surface actions available to you. You can look at a chart and ask three distinct questions: what is fixed about this moment, what is the prevailing mood, and what is the right action? That separation is also why the system maps surprisingly well to modern strategy tools. The Earth board is a constraint map, the Heaven board is a sentiment map, and the Human board is an option list.
If you are new to Chinese metaphysics, the most common confusion is between Qimen Dun Jia, Bazi (八字, the Four Pillars), and the I Ching (易经, the Book of Changes). They share a vocabulary of yin and yang, the five elements, and the ten heavenly stems, but they answer different questions and operate on different inputs.
| System | Input | What it does | Mental model |
|---|---|---|---|
| Qimen Dun Jia (QMDJ) | A specific date and hour | Models the quality of one moment | Hourly forecast |
| Bazi (Four Pillars) | Your birth year, month, day, hour | Models your life themes and personality | Long-term climate |
| I Ching (Book of Changes) | A question, cast as hexagrams | Generates a reflective answer | Mirror |
A useful way to think about it: Bazi is a climate report for the country you were born into, Qimen Dun Jia is the weather report for the specific street you are standing on right now, and the I Ching is a conversation with a wise but cryptic friend. Each has its own use. We have a longer comparison of Qimen Dun Jia versus Bazi if you want to go deeper.
The grid at the heart of every Qimen Dun Jia chart is the 3-by-3 Luo Shu square (洛书), one of the oldest pattern diagrams in Chinese mathematics. Each of the nine palaces is numbered, oriented to a direction, and associated with a trigram from the I Ching. The center palace (number 5) is the pivot. The other eight palaces sit around it, with their numbers arranged so that every row, column, and diagonal adds up to 15.
That mathematical property is the reason the grid became the canvas for time-keeping. The Luo Shu is not a decorative frame. It is a balance-preserving map. If you are interested in the broader context, the Wikipedia article on the Luo Shu Square covers the legend of the turtle emerging from the Yellow River with the pattern on its shell, which is how the design is traditionally explained.
For a working Qimen Dun Jia reader, the nine palaces are simply nine regions of any moment. Each region has its own governing theme: career, relationships, family, wealth, health, and so on. When you cast a chart, you look at which stars, doors, and stems fall into which palace, and you read the interaction.
The three building blocks that fill the grid are the 8 doors (八门), the 9 stars (九星), and the 10 heavenly stems (天干). If the grid is the canvas, these are the three brushes that paint it.
The 8 doors represent categories of action. Each door has a name and a quality. The most commonly named are Open (开门), Rest (休门), Life (生门), Injury (伤门), Delusion (杜门), Scenery (景门), Death (死门), and Fear (惊门). We have a longer breakdown of what the eight Qimen doors mean. For a beginner, the simplest mental model is: think of the eight doors as the verbs available in a given moment, and the chart tells you which verbs are usable and which are not.
The 9 stars represent ambient energies. Each star is tied to one of the five elements and carries a personality. Heavenly Auxiliary (天蓬) and Heavenly Emissary (天任) are very different in flavor. The stars do not predict events. They describe the texture of the moment. If you have ever walked into a meeting and thought "the air in this room is tense", the 9 stars are a structured way of saying that, but pinned to a specific hour on the calendar.
The 10 heavenly stems are the most subtle layer. They are the rotating ten-day cycle borrowed from the sexagenary calendar. Each stem interacts with the doors and stars in a specific way, producing the "useful god" (用神), the one element a chart is essentially pointing at for you. The useful god is the topic of our chart interpretation guide.
This is the question that gets us the most email, so let me be direct. Qimen Dun Jia is not a science in the modern sense. It does not generate testable predictions about the physical world, and we do not claim it does. It is also not the kind of thing that can be cleanly falsified by a single double-blind trial, because its practitioners do not claim a one-to-one mapping between chart feature and worldly event.
What Qimen Dun Jia is, on this site, is a structured reflective tool. It works the way a SWOT analysis, a weather briefing, or a chess clock works: by forcing you to slow down, name the variables, and look at the configuration honestly. The well-documented psychological effect of structured reflection on decision quality is real, even if the symbols are drawn from an ancient Chinese calendar.
We also make a sharp distinction between the original military use of the system, which was essentially a structured environmental scan, and the modern fortune-telling wrapper that has grown up around it. If you encounter a practitioner who tells you that a chart can name a specific future event, that is a modern folk belief layered on top of an older strategic system, and we actively discourage it. Our position is straightforward: the system is interesting as cultural heritage and as a model of structured decision-making. The moment someone uses it to make a binding claim about your future, it stops being a system and starts being a sales pitch.
For a useful cross-cultural comparison, the Encyclopaedia Britannica article on the I Ching discusses how a similar Chinese system was long treated as mystical in the West and only later re-read as a tool for thoughtful reflection rather than prophecy. The same re-reading is overdue for Qimen Dun Jia.
If after reading this far you want to actually try Qimen Dun Jia for yourself, here is the three-step path we recommend. We deliberately keep it short, because the literature is full of much longer "12-step" lists that mostly end up scaring beginners off.
Do not read another book. Open our free QMDJ compass, plot the chart for the current hour, and write down what you see. Do this for every working hour of a single week. You will not be able to interpret anything yet, but you will get comfortable with the visual grammar of the chart. The fastest way to learn Qimen Dun Jia is to look at enough charts that the grid stops being a picture and starts being a language.
Take two weeks to drill the 8 doors and 9 stars as flashcards. There are only 17 items, but each one carries several layers of meaning. Focus on the single most common meaning first. Do not get lost in obscure sub-meanings. If you can name, from memory, what each door and star does in a sentence, you are ready to start reading actual charts.
After four to six weeks of chart plotting and flashcard drill, pick a single structured book and finish it. The most widely used English reference is the Joey Yap library of QMDJ titles, especially the Qi Men Dun Jia Compendium and Qi Men Dun Jia: The 100 Formations. We are not affiliated with Joey Yap, and we do not sell his books, but his work is the largest body of structured English-language material on the subject, and the practical chart-plotting chapters are genuinely useful. For a different angle, the Mastery Academy offers more advanced online courses.
Total realistic timeline to a competent beginner reading: six to twelve months of regular study, with our free AI chat tool used as a practice partner. There is no shortcut, and anyone selling you a "30-day masterclass" is selling you a confidence boost, not a skill.
Qimen Dun Jia should be treated as a structured decision-making framework and a cultural artifact, not as a prediction engine. Its accuracy depends on the practitioner's ability to interpret the chart honestly. It is not, and has never been, a substitute for real-world data, professional advice, or your own judgment. We present it here as an educational tool only.
Bazi (Four Pillars) is a static natal chart built from your birth year, month, day, and hour. It describes your inherited personality and life themes. Qimen Dun Jia is a dynamic chart cast for a specific moment in time and space, used to evaluate the right action at the right moment. Think of Bazi as a long-term weather pattern and QMDJ as the hourly forecast for a particular decision.
No. We do not treat QMDJ as a fortune-telling tool and we do not offer predictions on this site. The historical use of QMDJ was military and strategic, not prophetic. Modern readers may find value in it as a structured reflection aid, similar to a SWOT analysis, not as a crystal ball.
Its popular usage has often blended with fortune-telling, but its original intent was strategic decision support for commanders and emperors. On fsqmdj.com, we deliberately separate the two. If you want fortune telling, you have come to the wrong place. If you want to study a 3,000-year-old Chinese strategic framework, keep reading.
Expect six months to one year of regular study to read charts at a beginner level with confidence, and several more years to reach the level where you can interpret nuanced configurations. There is no shortcut. We recommend pairing any book study with our free QMDJ compass tool to practice chart plotting hands-on.
Now that you have a working definition of Qimen Dun Jia, the next pieces worth reading depend on your goal. If you want to understand where the system sits among the wider Chinese traditions, read our guide to Chinese metaphysics for beginners. If you want a hands-on learning plan, go straight to Qimen Dun Jia for beginners. If you came here from a history angle, our piece on ancient Chinese divination places QMDJ in its wider cultural lineage. And if you already know the basics and want to read a chart, head to Qimen Dun Jia chart interpretation.
This is educational content, not prediction. We do not offer fortune-telling, prediction, or personal advice.
Sources cited in this article: Wikipedia: Qimen Dun Jia, Wikipedia: Chinese metaphysics, Wikipedia: Bazi, Wikipedia: I Ching, Britannica: I Ching, Joey Yap, Mastery Academy.