StateKeeper

StateKeeper 0.1.0

STATE KEEPER records your PEAK expeditions so you can review player states, item observations, and supporting evidence from the pause menu.

This is the first public test release. The interface and statistics are still being improved. Analysis reflects facts and inferences available to the recording client, not an all-seeing view or a teammate rating system.

Features

• Records regular and extra stamina, afflictions, petrification, jumps, positions, teammate distances, and inventory changes.
• Six review pages: Overview, Event Timeline, Player Report, Team Relations, Items, and Data Quality.
• Select an event to inspect nearby stamina, status, distance, and item evidence. Missing or uncertain data is explicitly marked.
• Search items by Chinese or English name, category, or effect keywords to review consumption evidence, possible assistance, and alternative explanations.
• Keeps the 10 most recent runs by default, with favorites, unfavoriting, deletion, and custom run names. Favorites do not count toward the recent-run limit.
• Compare the same player across 2-4 runs. Only reliable Steam identities are matched; different players sharing a nickname are not merged.
• English and Chinese text follows the game language. Recordings and analysis stay local, with no automatic uploads or additional network RPCs.

Installation and Usage

• Install through r2modman or Mod Manager. Requires BepInExPack PEAK 5.4.2403.
• For manual installation, place StateKeeper.dll in the game's or profile's BepInEx/plugins folder, then start the game. Do not keep multiple StateKeeper DLLs installed. Remove any legacy development build named PeakRunAnalytics.dll from the plugins folder first.
• Recording starts automatically in-game. Press ESC and find STATE KEEPER below the leave-game button, separated by one empty button space.
• Open a recorded run to view its report. The first analysis reads data in the background and shows progress, with cancellation and retry available.
• An active run cannot be favorited, renamed, or deleted. Manage it after it ends or is aborted. Custom names support up to 40 characters; leave the name blank to restore the default.

There is no F8 favorite shortcut. Use the panel to favorite, rename, or delete runs.

Configuration

The first launch creates BepInEx/config/com.local.statekeeper.cfg.

| Setting | Default | Description |

| --- | --- | --- |

| General.Enabled | true | Enables collection. When disabled, sampling and item/jump event recording stop, but history remains available. An already-started run is still saved and finalized normally. Re-enabling marks an observation interruption. |

| Advanced.DebugLogging | false | Logs diagnostic timings for collection, inventory scans, and slower panel rebuilds. Enable for troubleshooting; ordinary error logging is unaffected. |

| Advanced.StaminaEventThreshold | 0.01 | Minimum change recorded as an immediate stamina event, from 0 to 1. Does not change the stamina sampling rate of 5 samples per second. |

No ModConfig or other menu plugin is required. Restart the game after editing the configuration to apply the new settings.

Data and Privacy

Default Windows data directory: %USERPROFILE%/AppData/LocalLow/LandCrab/PEAK/StateKeeper.

• Runs contains recent recordings, Favorites contains favorited recordings, and Analysis contains regenerable analysis caches.
• Raw data is compressed into chunks covering approximately 30 seconds. The active run is saved approximately every 5 seconds. A complete run includes all its chunks; do not move just one JSON file.
• Deleting a run removes its recordings and analysis cache and cannot be undone in the panel. Favorite or back up runs you want to keep.
• Recordings contain player nicknames, Steam identifiers, detailed timestamps, positions, and item information. Do not publish raw files without participants' consent.
• Only current schema 3 recordings are shown. Legacy schema 2 recordings are not migrated, dis