Gadgets

Gadgets are the game's tools: the Wind Catcher, the Treasure Compasses and Oculus Resonance Stones that find chests and Oculi, the Portable Waypoint, the Kamera, the Parametric Transformer and many more. The bag already files them under their own tab (inventory), and the controls already bind Z to the one equipped (controls). Most find or act on what the world spawns, so this page waits on the spawned places and the crafting bench most are made at. The gadgets' data and cooldowns are built (gadgets); what remains is below.

Decisions

• A gadget's kind is the game's own. BinOutput/Widget/ConfigWidget.json names each gadget's kind, which the built data reads as the four kinds of the gadgets page. Each kind is one small module. The config's other widgets wait on the pages that name them, as the built page lists.
• A detector points to what the config spawns. A Treasure Compass (ConfigWidgetClientDetector) spawns a treasure box of its city, and the Seelie detector (ConfigWidgetTreasureMapDetector) a Seelie crystal. No widget of the config spawns an Oculus, so the Oculus Resonance Stone's target is not in the config, and its detector is not settled until its target is read from another table.
• A compass works in its city. The city table's open-state names put city 1 at Mondstadt (Mengde) and city 2 at Liyue, and the Mondstadt and Liyue compasses name those cities. The city table gives each city its areas, not its region, so a city joins a region's chest slice only once the areas are outlined; the Dragonspine compass names city 3, whose name is not read here.
• Equipped on Z, four on the quick swap. One gadget is equipped to the quick-use slot and used with Z. Holding it opens the quick swap, which holds up to four gadgets chosen in the bag. Only a gadget the config marks equipable can be equipped.
• A cooldown runs on while paused. A gadget that is not used up has a cooldown, shared within its cooldown group, which keeps counting while the world is paused under a menu, unlike every combat cooldown. It is kept as the moment it is ready, so it is read rather than ticked. The wiki states this; a recording confirms it (Recordings owed).
• Where a gadget may be used is the game's. WidgetUseableExcelConfigData says where each may not be used: in another player's world, which waits on co-op being deferred, and in a domain's type or scene, which the domains page supplies. The open world refuses none, so this check is not yet built.
• Made from instructions. Most are crafted at the bench or forged once their instructions or diagram are used, which reputation and offerings give; a few come from quests and are kept.
• A gadget is a bag item of the widget material type. Each of the slice's gadgets (generated/gadgets/gadgets.json, eleven at this revision) has a MaterialExcelConfigData row of type MATERIAL_WIDGET, so the bag holds it as any material, filed under ItemCategory.Gadget, and writeItems writes its row beside the drops' and the forge's items.

How it works

flowchart TD
  GATE["Equipped, and its cooldown group ready"] --> KIND{"Its kind"}
  KIND -->|"detector"| POINT["Points to the nearest of its kind in its city"]
  KIND -->|"collector"| STORE["Stores or spends its element"]
  KIND -->|"device"| PLACE["Placed in the world"]
  POINT --> START["Its group's cooldown starts, or its cooldown on a failed use"]
  STORE --> START
  PLACE --> START

Scope and order

Built: the gadgets' data and their cooldowns, on gadgets.

This still adds, in order:

1. Gadgets in the bag.
   • MaterialType (packages/genshin-world/src/models/inventory/MaterialType.ts) gains Widget = "MATERIAL_WIDGET", and MaterialTypeItemCategoryMap maps it to ItemCategory.Gadget.
   • writeItems (scripts/src/services/genshinAssets/items/writeItems.ts) adds every id of readGadgetRows()'s slice to the item ids it writes; then pnpm -C scripts genshin:assets items rewrites data/items/materials.json and pnpm -C scripts genshin:text names its names into the existing name chunks.
   • Test: writeItems.test.ts gains a case that every gadget the slice holds is written with materialType MATERIAL_WIDGET.
2. The quick-use slot. The equipped gadget and its use on Z, with the usable-here check once domains stand: Inventory gains the equipped gadget, the bag's screen equips one from its tab, and the HUD shows it with its cooldown. It touches the bag's screen, so the fleet offers it only while no inventory unit holds that folder.
3. Detectors, the Treasure Compass to treasure boxes once a compass's city joins a region's chest slice, then the Oculus Resonance Stone once its target is settled.
4. Collectors and placed devices, one kind at a time.
5. The quick swap.

Data and measures

• Read from the game's data: ConfigWidget.json, read into the built slice. WidgetUseableExcelConfigData and WidgetExcelConfigData are fetched into the dump, and neither is read yet: the first waits on domains and co-op, the second on the bag's items.
• Measured: each gadget's effect where its kind's config leaves it open, off a recording, and the cooldown counting on through a menu, which is owed a recording.

Key files

Sources

• Gadget, Genshin Impact Wiki: gadgets as the bag's sixth tab, the quick-use slot, cooldowns that run while paused, gadgets crafted or forged from their instructions, and the quick swap of four.
• AnimeGameData, the community's per-patch dump: the widget config with each gadget's kind, cooldowns and ranges, and the widget tables.