Release EID pause tools in v0.6.0

Author: emp0ry

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## Unreleased
+## 0.6.0 - 2026-08-20
 
 - Added a top-left pause-only inventory browser for collectibles, active items,
   trinkets, held cards and runes, identified pills, and all transformation
@@ -10,6 +10,8 @@
   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.
+- Made the complete EID settings panel available while a run is paused and
+  kept it hidden during active gameplay.
 
 ## 0.5.0 - 2026-08-20
 

README.md

@@ -54,7 +54,7 @@ The overlay tracks the player's position and displays the nearest eligible objec
 
 ### In-game settings
 
-The **EID ⚙** button appears in the bottom-right corner while Isaac is in a menu and hides automatically during gameplay. Its settings include:
+The **EID ⚙** button appears in the bottom-right corner while Isaac is in a menu or a run is paused. It hides automatically during active gameplay. Its settings include:
 
 - All 20 bundled languages
 - Horizontal and vertical position
@@ -67,7 +67,8 @@ 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.
+While a run is paused, an **EID Items** button appears in the top-left corner and
+the **EID ⚙** settings button becomes available in the bottom-right 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

docs/NATIVE_LAYOUT.md

@@ -104,4 +104,5 @@ 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.
+gameplay. The inventory and settings buttons are enabled only for a verified
+paused state; an invalid read fails closed and leaves both controls hidden.

docs/RELEASE_NOTES_v0.6.0.md

@@ -0,0 +1,24 @@
+# Isaac External Item Descriptions iOS v0.6.0
+
+This release adds a native pause inventory and fixes transformation progress
+across save reloads and active-item replacement.
+
+## Highlights
+
+- A top-left **EID Items** button now appears while a run is paused.
+- The pause browser lists current collectibles, active items, trinkets, held
+  cards and runes, identified pills, and all 15 transformations.
+- Selecting an inventory entry displays its full localized EID description.
+- The complete **EID ⚙** settings panel is now available while paused and hides
+  again when gameplay resumes.
+- The 14 standard transformations use Isaac's persisted native PlayerForm
+  counters, preserving real progress after replacing an active item or
+  reopening a save.
+- Super Bum completion is detected from the native merged familiar.
+- Pause, inventory, trinket-slot, pocket-slot, and transformation layouts were
+  verified against iOS executable UUID
+  `F4357753-A25F-30EE-BACF-63709F902895` and tested in the real game.
+
+The release includes the standalone ARM64 dylib, rootless ElleKit package,
+LiveContainer framework, embedded package, complete 20-language description
+database, and SHA-256 checksums. No Isaac IPA or game data is distributed.

docs/TEST_MATRIX.md

@@ -16,7 +16,7 @@
 | English/Russian pill import | Pass: 51 normal + 51 horse each |
 | All-language upstream import | Pass: 20 EID languages; English fallback fills untranslated Repentance entries |
 | Menu/game detector | Pass: native player-presence detector with 12-scan menu debounce |
-| EID settings | Pass: menu-only bottom-right button, native language picker, horizontal and vertical sliders, 140/50 px defaults, credits and dataset version |
+| EID settings | Pass: bottom-right button is available in menus and while paused, hidden during active gameplay; native language picker, layout controls, 140/50 px defaults, credits and dataset version |
 | Unknown-pill spoiler guard | Pass: native identified byte required |
 | Native pill color-to-effect mapping | Pass: ARM64 ItemPool layout verified |
 | Crane Game prize field | Pass: ARM64 setter/layout verified |
@@ -35,7 +35,7 @@
 | Native card/rune/pill artwork | Pass: subtype-aware card and rune frames plus original EID pill-atlas frames |
 | 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 |
+| Pause inventory | Pass: top-left button rendered 3 current items and all 15 transformations; item 312 selection opened its description; inventory and settings controls hide 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 |

livecontainer/Info.plist

@@ -15,9 +15,9 @@
     <key>CFBundlePackageType</key>
     <string>FMWK</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.3.0</string>
+    <string>0.6.0</string>
     <key>CFBundleVersion</key>
-	<string>5</string>
+    <string>6</string>
     <key>MinimumOSVersion</key>
     <string>15.0</string>
 </dict>

package/control

@@ -1,6 +1,6 @@
 Package: com.emp0ry.isaaceid
 Name: Isaac External Item Descriptions
-Version: 0.5.0
+Version: 0.6.0
 Architecture: iphoneos-arm64
 Description: Native External Item Descriptions bridge for Isaac Repentance on iOS.
 Maintainer: emp0ry

src/EIDOverlayController.m

@@ -468,12 +468,11 @@ - (void)tick:(NSTimer *)timer {
 - (void)updateMenuModeForGameplay:(BOOL)gameplayActive {
     if (gameplayActive) {
         self.consecutiveMenuScans = 0;
-        self.settingsButton.hidden = YES;
-        self.settingsCard.hidden = YES;
         if (!self.menuMode) return;
         self.menuMode = NO;
+        self.settingsCard.hidden = YES;
         [self updateSettingsControls];
-        EIDLog(@"game state: gameplay active; settings hidden");
+        EIDLog(@"game state: gameplay active; settings available only while paused");
         return;
     }
     if (self.consecutiveMenuScans < 12) self.consecutiveMenuScans++;
@@ -489,9 +488,11 @@ - (void)updateMenuModeForGameplay:(BOOL)gameplayActive {
 - (void)updatePauseInventoryForPaused:(BOOL)paused {
     BOOL available = paused && self.probe.inventoryStateAvailable;
     self.inventoryButton.hidden = !available;
+    self.settingsButton.hidden = !(self.menuMode || paused);
     if (!paused) {
         self.inventoryCard.hidden = YES;
         self.inventorySignature = nil;
+        if (!self.menuMode) self.settingsCard.hidden = YES;
         if (self.pauseUIActive) {
             self.selectedInventoryItem = nil;
             if (!self.menuMode) [self renderPickups:self.lastPickups];
@@ -501,7 +502,7 @@ - (void)updatePauseInventoryForPaused:(BOOL)paused {
         [self rebuildInventoryContentsIfNeeded:NO];
     }
     if (paused && !self.pauseUIActive) {
-        EIDLog(@"native pause detected; inventory button available");
+        EIDLog(@"native pause detected; inventory and settings buttons available");
     }
     self.pauseUIActive = paused;
 }
@@ -519,9 +520,11 @@ - (void)updateSettingsControls {
     self.settingsVerticalPositionLabel.text = [NSString stringWithFormat:
         @"Vertical position: %.0f px", verticalPosition];
     NSString *appVersion = [NSBundle.mainBundle objectForInfoDictionaryKey:@"CFBundleShortVersionString"] ?: @"unknown";
+    NSString *context = self.probe.paused ? @"Paused" :
+        (self.probe.gameplayActive ? @"In game" : @"Menu");
     self.settingsVersionLabel.text = [NSString stringWithFormat:
         @"%@ · iOS %@ · dataset: %@ · not Repentance+",
-        self.probe.gameplayActive ? @"In game" : @"Menu", appVersion,
+        context, appVersion,
         self.store.descriptionDataSet];
 }
 
@@ -733,10 +736,13 @@ - (void)toggleSettings:(UIButton *)sender {
     (void)sender;
     self.settingsCard.hidden = !self.settingsCard.hidden;
     if (!self.settingsCard.hidden) {
+        self.inventoryCard.hidden = YES;
         [self updateSettingsControls];
         [self.rootView bringSubviewToFront:self.settingsCard];
         self.panel.alpha = 0;
     }
+    EIDLog(@"settings panel %@ (%@)", self.settingsCard.hidden ? @"closed" : @"opened",
+           self.probe.paused ? @"paused" : (self.menuMode ? @"menu" : @"gameplay"));
 }
 
 - (void)closeSettings:(UIButton *)sender {