Dungeon Artifact
Unified Dungeon Data Artifact
Unified artifact storing all persistent dungeon data: - Per-dungeon stats (rooms, instances created, best time, completions) - Per-player stats (total runs, completions, best time) The data lives in memory and is written by one background writer ([DungeonStatsStore]): reads never touch the disk after the first load and never block a game thread, a change is visible at once and reaches the file a moment later (the newest state always wins). Until the first load has finished, reads answer with empty stats and changes wait for the load, so nothing already on disk is overwritten. Profile-aware: the key of a player comes from the [StatsKeyProvider].
フィールド
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
artifactId | String | dungeon_data | Unique artifact identifier |
How to use it
Create one and link it in the artifact field of your dungeon instances. It holds per-dungeon and per-player statistics (runs, completions, best time, and the 22 statistics of a run) read by the statistics placeholders, the Player Dungeon Statistic fact and the Dungeon Leaderboard Source. The artifactId defaults to dungeon_data. The extension records the statistics itself: an attempt when a run starts, the rest when each member is paid out of the run (a completion and the best time when the run is completed with Dungeon Complete). A player's best time is kept once per artifact, over every dungeon that shares it: give each dungeon its own artifact when each needs its own personal best.