Wildlife

The client does not place the game's animals, so the map's public points stand in for them, as spawned places describes. This page is the built part of the wildlife proposal: the three kinds of bird and beast the map marks as fleeing are placed in the scene by the fit's transform and written into each region's slice, and in Windrise's scene each one stands at its place and runs from the character when it comes near. Nothing is struck, dropped or picked up yet.

How it works

flowchart TD
  P["The official map's points, read into the references folder"] --> K{"An animal label: White Pigeon, Crimson Fox or Squirrel?"}
  K -->|"no"| SKIP["Not a fleeing kind: left alone"]
  K -->|"yes"| L{"On the ground layer, in a mapped region?"}
  L -->|"no"| UG["Left out, as the chests are"]
  L -->|"yes"| T["Carried into the game's coordinates by the fit's transform, then into its region's axes"]
  T --> S["One slice per region in genshin-world's generated wildlife folder"]
  S --> V["Windrise's scene parses Mondstadt's slice and stands each animal at its place"]
  V --> F{"The character within the escape radius?"}
  F -->|"yes: run straight away"| F
  F -->|"no, once the escape time has passed"| I["Stands idle at its place"]

The kinds

WildlifeKind names three: CrimsonFox, Squirrel and WhitePigeon. Each is one of the map's own labels under its Animals group, and WildlifeKindLabelIdMap gives its label id, so a point takes its kind by its label. The archive files each as an animal or aviary monster, which the capture table's rows and the monster rows hold for the parts still to come.

The flight

stepWildlife runs on the enemies' fixed step, a sixtieth of a second. An idle animal with the character within its escape radius starts running straight away from it at the flight speed. A running one keeps running for the escape time, then stands idle, or runs again if the character is still in reach. A character that is gone leaves a running animal running on its last heading until its time is up, and then standing idle.

The numbers are provisional, each marked in services/wildlife/constants.ts:

• The escape radius, four metres, and the escape time, one second. The environment table holds no row for a bird or a beast, so these are its gadget rows' values, the closest it holds, until a recording of each kind's flight measures them.
• The flight speed, six metres a second. No table gives it, so it is a placeholder until a recording times it.

The placement

pnpm -C scripts genshin:assets wildlife writes each region's animals as one slice in packages/genshin-world/src/generated/wildlife/, the chest slices' pattern. Mondstadt's slice holds about a hundred animals, and the other regions hold the same kinds where their labels are marked.

WorldWildlife stands each animal in Windrise's scene as a capsule of one instanced draw, the enemies' stand-in, stood on the ground under it and turned to its heading. Windrise parses the Mondstadt slice with wildlifePlaceSchema when it loads, and the animals are not drawn in a witness render, as the enemies are not.

Every animal of the slice exists from the scene's load. The rule that most animals come into being only when the player is near is not built, and neither are their shadows nor the elemental sight over them.

Key files

Sources

• Teyvat Interactive Map, HoYoLAB: the official map. Its label tree and point list are the public data the writer reads as references.
• AnimeGameData, the community's per-patch dump: the environment animal table whose gadget rows give the closest escape radius and time held for the kinds.