YojigenShift.YiFramework 7.0.1

YojigenShift.YiFramework ☯️

English | 简体中文

YiFramework is a high-performance C# library designed for Chinese Metaphysics algorithms.

Its goal is to encapsulate complex logic (such as BaZi/Four Pillars, Qi Men Dun Jia, Plum Blossom Oracle, etc.) into pure mathematical models and data structures, providing a robust core driver for game development (Unity/Godot) and Metaphysics applications.

✨ Features

The current version provides the fundamental building blocks for Metaphysics computing:

• High-Performance GanZhi: O(1) mathematical model for Heavenly Stems and Earthly Branches conversion and indexing, with zero memory allocation.
• Precision Solar Time Plotting: Built-in simplified VSOP87 astronomy algorithm for accurate Solar Terms and True Solar Time calculation.
• Qi Men Dun Jia System (Time-Based):
  • Full Layout: Supports Earth, Heaven, Man, and God plates, plus Hidden Stems.
  • Smart Structure Calculation: Uses "Chai Bu" method to determine Yin/Yang Dun and Ju number automatically.
  • Holographic Model: Tracks Zhi Fu (Star) and Zhi Shi (Door) rotations.
  • Pattern Analyzer: Determines Auspicious/Inauspicious combinations (e.g., 10 Stem Combinations / Shi Gan Ke Ying).
• BaZi Analysis Engine:
  • Complete Ten Gods and Hidden Stems lookup.
  • 12 Life Stages calculation.
  • Strength/Weakness Evaluation and Useful God (Xi Yong Shen) recommendation based on 5-Element energy scoring.
  • Pattern Recognition: Automatically detects Normal Patterns and Special Patterns (Dominant/Surrender structures).
• Han Style Naming Engine:
  • Chinese Characters Only: The current logic relies on Hanzi shape, meaning, and Kang Xi strokes. English naming is not supported.
  • Shape & Meaning First: Supports primary/secondary elements, structural attributes (Head-Out), and gender preference.
  • Pattern Generation: Auto-generates optimal Wu Xing structures based on "First Useful God" and "Remedy" logic.
  • Zodiac Taboos: Built-in Big/Small zodiac logic and character structure validation.
  • Han Numerology: Lightweight numerology scoring based on Kang Xi stroke units.
• Six Lines (Liu Yao) System:
  • Coin Casting: Simulates traditional 3-coin method with auto-complete support.
  • Auto Mounting: Automatic Na Jia (Stems/Branches), Shi/Ying assignment, and Six Relations (Liu Qin).
  • ​Metaphysical Analysis: Six Beasts assignment, Void (Kong Wang) calculation, and Day/Month clash analysis.
• Plum Blossom Oracle (Mei Hua):
  • Casting via Time or Numbers.
  • Deriving Original, Mutual, and Changed Hexagrams.
  • ​Auspiciousness analysis based on Ti/Yong relationship.
• Yin-Yang & Five Elements: Complete matrix for logic regarding Generating, Overcoming, Weakening, and Draining cycles.
• Localization (i18n): Built-in localization support for metaphysical terminology (e.g., Stems, Branches, Gods).
• Zero GC Design: Core algorithms utilize struct and static lookup tables, optimized specifically for high-frequency calls in game loops.

📦 Installation

This project is published on NuGet. You can install it via the Package Manager Console or the .NET CLI:

dotnet add package YojigenShift.YiFramework

For Unity projects, installation via the "NuGet for Unity" plugin is recommended.

🚀 Quick Start

1. Qi Men Dun Jia Plotting & Analysis

using YojigenShift.YiFramework.QiMen.Logic;
using YojigenShift.YiFramework.QiMen.Models;
using YojigenShift.YiFramework.Analysis.Logic;

DateTime time = DateTime.UtcNow;
QiMenChart chart = QiMenPlotter.Plot(time);

// Traverse nine palaces，get patterns
foreach (var palace in chart.Palaces.Values)
{
    var patterns = QiMenPatternAnalyzer.AnalyzePalace(palace);
    foreach (var p in patterns)
    {
        Console.WriteLine($"Palace Index {palace.Index} Found Pattern: {p.Name} - {p.Description}");
    }
}

3. BaZi Plotting & Analysis

using YojigenShift.YiFramework.Analysis.Logic;

// Assume BaziPlotter has already had the four pillars and calculated Five Elements' scores and result
var patternResult = BaZiPatternAnalyzer.Analyze(
    dayMaster, monthBranch, yearStem, monthStem, hourStem, baziAnalysis
);

Console.WriteLine($"Pattern Name: {patternResult.Name}"); // e.g. Cong Sha
Console.WriteLine($"Reason: {patternResult.Description}");

🗺️ Roadmap

YiFramework is under active development. Future updates will follow this roadmap:

• Phase 1: Foundation
  • GanZhi Math Algorithms
  • Five Elements Matrix
  • Precise Solar Terms Calculation
  • Lunar Calendar Conversion
• Phase 2: Four Pillars (BaZi)
  • Intelligent Pillar Plotting (Handling Early/Late Rat Hour, Solar Term Boundaries)
  • Ten Gods & Hidden Stems Lookup
  • Basic Strength/Weakness Scoring (For game numerical simulation)
• Phase 3: Plum Blossom Oracle (Mei Hua Yi Shu)
  • Trigram Definitions & Extensions
  • Hexagram Casting (Time/Number based)
  • Body & Application (Ti/Yong) Relationship Analysis
• Phase 4: Han Style Naming
  • Character Model (Shape/Meaning First, Multi-Element)
  • Han Numerology (Stroke Unit Digit)
  • Pattern Generation (First Useful God & Remedy Logic)
  • Zodiac Taboos (Big/Small Zodiac & Structure Check)
• Phase 5: Six Lines (Liu Yao)
  • Coin Casting Simulation
  • Hexagram Mounting (Na Jia / Six Relations)
  • Six Beasts & Void Calculation
  • Status Analysis (Clash/Break)
• Phase 6: Qi Men Dun Jia
  • Ju Calculation (Chai Bu / Solar Terms)
  • Earth Plate Layout
  • Full Layout (Earth/Heaven/Man/God)
  • Hidden Stems
• Phase 7: Advanced Analysis
  • Qi Men Patterns (Structures & 10 Stems Combinations)
  • BaZi Advanced Patterns (Dominant & Surrender Patterns)
• Phase 8: Upcoming Features
  • BaZi Gods & Demons (Shen Sha)
  • Advanced Qi Men Tactics (San Qi De Shi, etc.)
  • Liu Yao Diagnostic Generation

⚙️ Design Philosophy

• Separation of Algorithm & Presentation: Provides only data and calculation results. No UI code included, making it suitable for Console, Web API, Unity, Godot, etc.
• Data-Driven: Complex metaphysical dictums and dictionaries are loaded via a separate data layer to avoid hardcoding.
• Game-Ready: Extreme focus on runtime performance. Core calculation paths avoid Boxing/Unboxing and GC Allocations.

📝 License

Copyright © 2026 Lewis Lin/Yojigen Shift. All rights reserved.

Currently a private repository for internal development.