genshin-lore-graph

Genshin Lore Graph is a structured dataset about the characters, organizations, gods, events, and world lore of the video game Genshin Impact. The data was organized from publicly shared relationship maps on a site called GraphLink, then converted into formats that are easier for AI tools and programs to read and search through.

The dataset has two parts. The character and entity graph covers 613 nodes, including player characters, NPCs, factions, monsters, and in-world objects, connected by 585 directional relationships such as family ties, rivalries, alliances, and story events. The worldview graph covers 135 nodes that describe the game's cosmology and hierarchy, including regions, races, abilities, and power levels, connected by 134 relationships and also organized into a tree structure with paths from the root node down to each concept.

The files are stored as JSONL (one record per line) and JSON adjacency tables so that programs can look up a character by name and quickly retrieve all their known connections without loading the entire dataset at once. An index file maps names and aliases to node IDs for fast lookups.

The repository also includes a skill that can be installed into AI coding assistants like Claude Code or Codex. Once installed, the assistant can call query scripts to answer questions about character relationships or worldview hierarchies using the local data. A combined query script can also pull basic character info from an external game wiki and merge it with the local graph data.

The project notes that graph edges are directional and that some entries are marked as speculation or unresolved plot threads, not confirmed lore. The data reflects the state of the source maps at the time of collection and may not match the latest game version. The repository is not affiliated with HoYoverse or miHoYo, and is intended for non-commercial research and AI retrieval experiments.