YinYang Maze

This maze uses the change of four images of ba gua (an abstract expression used by ancient Chinese to understand changes in the world) as the mechanics.

Current version only contains core function :(

You could check the design process in this page (in Chinese): https://medill-east.github.io/2023/11/26/20231126-cfgd-chap3-challenge2-maze/

The complete version of the game is as follows:

1. Game Objective
   • Players need to reach the exit using the shortest path (nine steps) from the entrance.
     • The status of the grid where the player walked will be collected.
     • The collected statuses are arranged from bottom to top.
       • The first six lines form one of the sixty-four hexagrams.
       • The last three lines, excluding the situations with three yin or three yang lines, are converted to a number from 1 to 6 as the line position through binary conversion.
   • Eventually, the player obtains the hexagram and line position results for the desired question.
2. Game Process
   • Pre-game Preparation
     • Conceptualize a question.
     • Decide the initial line (yin or yang).
     • Initialize a 5x5 square maze (draw a path from entrance to exit).
   • In-game Process
     • Changes in hexagram lines during the game.
     • Player moves, locking the hexagram lines at the visited positions and recording them.
   • Post-game Settlement
     • Build the hexagram from the first six lines of the player's path from bottom to top.
       • For example, if the first six lines of the path are all yin, the resulting hexagram is Kun.
     • Build the line position from the last three lines of the player's path.
       • Three yin lines (000) and three yang lines (111) are considered unchanged.
       • In other cases, convert based on binary, resulting in a number from 1 to 6.
       • For example, if the last three lines of the path are yin, yang, yang (110), the converted result is 6.
     • Obtain the final hexagram and line position.
3. Specific Rules
   • Questioning
     • Avoid asking "whether" questions.
     • Instead, ask questions like "What will happen to xxx?"
   • Grid States
     • Yin line - 0
     • Yang line - 1
   • 5x5 Square Maze Initialization
     • Entrance and exit must be diagonally opposite, forming a non-overlapping path.
     • Players can choose the initial line as yin or yang.
     • During initialization, each time a player passes a grid, the line drawn on the next grid is reversed (e.g., if the entrance is a yang line, the next grid's line will be yin, and so on).
   • Hexagram Changes
     • Pre-game Initialization
       • If the upper grid of an undefined grid (not passed by the player) has a line, the current grid's line is opposite to it.
         • For example, if the upper grid has a yang line, the current grid will have a yin line.
       • If the upper grid of an undefined grid has no line, both are considered yin.
     • In-game Hexagram Changes (Cellular Automaton)
       • Change the current grid and its upper grid based on the line status.
         • shao yin -> lao yin
         • lao yin -> shao yang
         • shao yang -> lao yang
         • lao yang -> shao yin