Add pause inventory and persisted transformation progress

Author: emp0ry

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## Unreleased
+
+- Added a top-left pause-only inventory browser for collectibles, active items,
+  trinkets, held cards and runes, identified pills, and all transformation
+  progress.
+- Added native pause detection from the verified Repentance PauseScreen state.
+- Replaced session-only transformation reconstruction with Isaac's persisted
+  15-entry PlayerForm counter array, preserving progress across active-item
+  replacement and save reloads.
+- Added native Super Bum familiar detection for correct post-merge progress.
+
 ## 0.5.0 - 2026-08-20
 
 - Fixed Curse of the Blind spoiler protection by reading the native level curse mask and suppressing every collectible pedestal while the curse is active.

README.md

@@ -38,9 +38,9 @@ The overlay tracks the player's position and displays the nearest eligible objec
 - Untouched floor cards and runes remain hidden until the game marks them touched or a player holds them in a native pocket slot.
 - Pills remain hidden until Isaac's native ItemPool state identifies their effect.
 - Curse of the Blind suppresses every collectible description using the native level curse mask. The forced-blind field and question-mark sprite are retained as additional guards.
-- Transformation progress is calculated from the player's real owned-collectible table instead of nearby-item observations.
-- Replaced active items remain counted for the current run, matching persistent transformation contribution.
-- Native run identity and seed tracking reset learned cards, runes, and transformation history when a new run begins.
+- Transformation progress is read from the player's native persisted transformation state instead of nearby-item observations.
+- The 14 normal transformations use Isaac's persisted native PlayerForm counters, so replaced active items and saved/reloaded runs keep their real progress. Super Bum completion is read from its native merged familiar.
+- Native run identity and seed tracking reset learned cards and run-only knowledge when a new run begins.
 
 ### Artwork and presentation
 
@@ -65,6 +65,14 @@ The **EID ⚙** button appears in the bottom-right corner while Isaac is in a me
 
 The default overlay position is 140 px from the left and 50 px from the top.
 
+### Pause inventory
+
+While a run is paused, an **EID Items** button appears in the top-left corner.
+It opens a scrollable browser containing the player's current collectibles,
+active item, trinkets, held cards and runes, identified pills, and progress for
+all transformations. Selecting an item closes the browser and renders its full
+EID description. The button and browser disappear as soon as gameplay resumes.
+
 ## Compatibility
 
 The current native layout supports this App Store build:
@@ -154,9 +162,9 @@ The description importer combines upstream `ab+` base tables with `rep` override
 
 ## How it works
 
-The native iOS game has no desktop Lua mod API. This project locates the supported Isaac executable by UUID, resolves native C++ RTTI for pickup, player, slot, effect, and grid-spike types, and reads bounded snapshots from its own process.
+The native iOS game has no desktop Lua mod API. This project locates the supported Isaac executable by UUID, resolves native C++ RTTI for pickup, player, familiar, slot, effect, and grid-spike types, and reads bounded snapshots from its own process.
 
-Those snapshots provide nearby pickup identity, player position, card/rune knowledge, pill knowledge, owned collectibles, level curses, room effects, Sacrifice Room grid state, and run identity. The mod does not patch save data or write into Isaac's native gameplay objects.
+Those snapshots provide nearby pickup identity, player position, card/rune knowledge, pill knowledge, current inventory, persisted transformation counters, native pause state, level curses, room effects, Sacrifice Room grid state, and run identity. The mod does not patch save data or write into Isaac's native gameplay objects.
 
 Verified offsets and their validation are documented in [Native layout](docs/NATIVE_LAYOUT.md). Device and packaging results are recorded in [Test matrix](docs/TEST_MATRIX.md), and presentation differences are tracked in [EID parity](docs/EID_PARITY.md).
 

docs/NATIVE_LAYOUT.md

@@ -33,10 +33,13 @@ allocator and does not directly dereference mutable game allocations.
 | Pickup forced-blind byte | `0x562` | ARM64 disassembly of native `SetForceBlind` |
 | Crane Game prize collectible | `0x570` | ARM64 disassembly of `Entity_Slot::SetPrizeCollectible` |
 | Player pocket items | `Entity_Player + 0x1c10` | Live held-card and rune identity matched pocket slots |
+| Player trinket slots | `Entity_Player + 0x1ab0` | Native GetTrinket call sites and both live slots |
 | Player collectible-count table | `Entity_Player + 0x1ab8` | Live inventory changes matched collected items |
+| Player transformation counters | `Entity_Player + 0x1c54` | Native 15-entry add/remove, save, and restore loops |
 | Game level curse mask | `Game + 0x0c` | Live Curse of the Blind state matched mask `0x40` |
 | Game current room | `Game + 0x21550` | Live room transitions matched room descriptor state |
 | Game run seed | `Game + 0x25d44` | Stable within a run and changed when starting a new run |
+| Game pause-menu state | `Game + 0x10dfd8` | PauseScreen state switch; valid values are `0...3` |
 | Room grid-entity table | `Room + 0x30` | Live Sacrifice Room spikes and activation count |
 | Game ItemPool | `Game + 0x242c0` | Native `GetPillEffect` call sites |
 | ItemPool pill effect array | `ItemPool + 0xa2c` | ARM64 `GetPillEffect` implementation |
@@ -71,8 +74,34 @@ iOS drops that create a new entity with `Touched` cleared. This learned identity
 lasts only for the current run. A newly discovered floor card is therefore
 still hidden until it is actually held by a player.
 
-Transformation progress comes from the player's native collectible-count
-table. Active collectibles are remembered after replacement for the duration
-of the run, matching the way transformation contribution persists. A native
-run seed plus a debounced empty-player state resets this history when a new run
-starts.
+The native `Entity_Player::_playerForms` array has 15 persisted `int32`
+counters starting at `+0x1c54`. Isaac copies the complete 60-byte array into
+and out of its player save state. EID transformation IDs are mapped to the
+native PlayerForm order rather than treated as the same enum:
+
+| EID | Native | Form |
+| ---: | ---: | --- |
+| 1 | 0 | Guppy |
+| 2 | 2 | Fun Guy |
+| 3 | 1 | Lord of the Flies |
+| 4 | 7 | Conjoined |
+| 5 | 5 | Spun |
+| 6 | 6 | Yes Mother? |
+| 7 | 9 | Oh Crap |
+| 8 | 4 | Bob |
+| 9 | 8 | Leviathan |
+| 10 | 3 | Seraphim |
+| 12 | 10 | Bookworm |
+| 13 | 12 | Spider Baby |
+| 14 | 11 | Adult |
+| 15 | 13 | Stompy |
+
+Super Bum is a familiar merge rather than a native PlayerForm. Its partial
+progress uses the three source collectible identities, and completion is
+verified from the live `Entity_Familiar` type `3`, variant `102`, so the display
+remains `3/3` after the source familiars merge. In co-op, each player has an
+independent counter array; the overlay displays the highest valid per-player
+counter instead of incorrectly summing two players.
+
+The pause browser reads PauseScreen state `1...3` as paused and `0` as live
+gameplay. An invalid read fails closed and leaves the button hidden.

docs/TEST_MATRIX.md

@@ -33,7 +33,9 @@
 | Untouched-card identity guard | Pass: untouched cards stay hidden; held cards are learned from the four native player pocket slots |
 | Native item artwork | Pass: exact Isaac collectible/trinket paths and subtype-aware pocket-item artwork rendered beside text |
 | Native card/rune/pill artwork | Pass: subtype-aware card and rune frames plus original EID pill-atlas frames |
-| Transformation progress | Pass: native owned-collectible counts, duplicate handling, active-item run history, and run-seed reset |
+| Transformation progress | Pass: live persisted PlayerForm counters survived a save reload and reported Conjoined `1/3` plus Bookworm `1/3`; Super Bum uses verified familiar type/variant state |
+| Pause detection | Pass: live PauseScreen state changed `0 -> 1 -> 0` on the supported device build |
+| Pause inventory | Pass: top-left button rendered 3 current items and all 15 transformations; item 312 selection opened its description; UI hid on resume |
 | Dice Room descriptions | Pass: live native face detection and localized effect description |
 | Sacrifice Room descriptions | Pass: native grid-spike detection and live next-payout counter |
 | Description removal transition | Pass: title, icon, and body now disappear together after collection |

include/EIDNativeProbe.h

@@ -25,13 +25,20 @@ typedef NS_ENUM(NSInteger, EIDPickupVariant) {
 @property(nonatomic, copy, readonly) NSString *status;
 @property(nonatomic, readonly, getter=isSupportedBuild) BOOL supportedBuild;
 @property(atomic, readonly, getter=isGameplayActive) BOOL gameplayActive;
+@property(atomic, readonly, getter=isPauseStateAvailable) BOOL pauseStateAvailable;
+@property(atomic, readonly, getter=isPaused) BOOL paused;
 @property(atomic, readonly) uint32_t runSeed;
 @property(atomic, readonly) NSUInteger runCounter;
 @property(atomic, readonly, getter=isOwnedCollectibleStateAvailable) BOOL ownedCollectibleStateAvailable;
+@property(atomic, readonly, getter=isInventoryStateAvailable) BOOL inventoryStateAvailable;
+@property(atomic, readonly, getter=isTransformationStateAvailable) BOOL transformationStateAvailable;
+@property(atomic, readonly, getter=isSuperBumActive) BOOL superBumActive;
 - (void)start;
 - (NSArray<EIDPickupIdentity *> *)currentDescribablePickups;
+- (NSArray<EIDPickupIdentity *> *)currentInventoryItems;
 - (NSInteger)ownedCollectibleCountForID:(NSInteger)collectibleID;
 - (NSInteger)transformationCollectibleCountForID:(NSInteger)collectibleID;
+- (NSInteger)nativeTransformationCounterForFormID:(NSInteger)formID;
 // Compatibility API used by early integrations and exported diagnostic helpers.
 - (NSArray<NSNumber *> *)currentCollectibleIDs;
 @end

include/EIDTransformationProgress.h

@@ -0,0 +1,18 @@
+#import <Foundation/Foundation.h>
+
+@class EIDNativeProbe;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface EIDTransformationProgress : NSObject
+@property(nonatomic, weak, nullable) EIDNativeProbe *probe;
+@property(nonatomic, readonly) NSInteger required;
++ (instancetype)shared;
+- (NSArray<NSNumber *> *)allTransformationIdentifiers;
+- (NSArray<NSNumber *> *)transformationsForCollectible:(NSInteger)collectible;
+- (NSInteger)progressForTransformation:(NSInteger)transformation;
+- (NSString *)localizedNameForTransformation:(NSInteger)transformation;
+- (NSString *)englishNameForTransformation:(NSInteger)transformation;
+@end
+
+NS_ASSUME_NONNULL_END