Update index.html

index.html

@@ -13,13 +13,13 @@
             margin: 0;
             padding: 20px;
         }
-        
+
         h1 {
             color: #c00;
             text-align: center;
             margin-bottom: 20px;
         }
-        
+
         .container {
             max-width: 900px;
             margin: 0 auto;
@@ -29,7 +29,7 @@
             padding: 20px;
             box-shadow: 0 0 20px rgba(0, 0, 0, 0.2);
         }
-        
+
         .game-description {
             text-align: center;
             margin-bottom: 20px;
@@ -45,7 +45,7 @@
             <p>An interactive text adventure game powered by Gradio-lite</p>
             <p><em>Can you defeat the Evil Power Master and save the land?</em></p>
         </div>
-        
+
         <gradio-lite theme="light">
 <gradio-file name="app.py" entrypoint>
 import gradio as gr
@@ -60,61 +60,84 @@ def initialize_game():
     game_state = GameState()
     current_page = 1
     page_data = game_data[str(current_page)]
-    
+
     # Create the SVG illustration
-    svg_content = create_svg_illustration(page_data["illustration"])
-    
+    svg_content = create_svg_illustration(page_data.get("illustration", "default"))
+
     # Build page content
-    content = f"<h2>{page_data['title']}</h2>"
-    content += page_data["content"]
-    
+    content = f"<h2>{page_data.get('title', 'Untitled Page')}</h2>"
+    content += page_data.get("content", "<p>No content for this page.</p>")
+
     # Build options
     options = []
-    for opt in page_data["options"]:
-        options.append(opt["text"])
-    
+    if "options" in page_data:
+        for opt in page_data["options"]:
+            options.append(opt["text"])
+    if not options: # Fallback if no options defined
+        options = ["Restart"]
+        content += "<p><i>There are no actions defined here.</i></p>"
+
+
     # Update game statistics display
     stats = generate_stats_display(game_state) # Use the function here
-    
-    # Initialize inventory as empty
+
+    # Initialize inventory display
     inventory = generate_inventory_display(game_state) # Use the function here
-    
+
     # Set story path
     story_path = "You are at the beginning of your adventure."
-    
-    return svg_content, content, gr.Dropdown(choices=options, label="What will you do?"), game_state.to_json(), stats, inventory, story_path
+
+    return svg_content, content, gr.Dropdown(choices=options, label="What will you do?", value=None), game_state.to_json(), stats, inventory, story_path
 
 def update_game(choice, game_state_json):
     """Update game based on player choice"""
+    if not choice: # Handle empty choice if dropdown value is cleared
+        return gr.update(), gr.update(), gr.update(), gr.update(), gr.update(), gr.update(), gr.update()
+
     # Parse game state from JSON
     game_state_dict = json.loads(game_state_json)
     game_state = GameState.from_dict(game_state_dict)
-    
+
     # Get current page data
     current_page = game_state.current_page
     # Ensure current_page is always a string for dictionary keys
-    page_data = game_data[str(current_page)] 
-    
+    current_page_str = str(current_page)
+    if current_page_str not in game_data:
+         # Handle invalid page number - maybe reset?
+         error_content = f"<p>Error: Reached invalid page number {current_page}. Resetting game.</p>"
+         svg_error = create_svg_illustration("default")
+         return svg_error, error_content, gr.Dropdown(choices=["Restart"], label="Error"), GameState().to_json(), generate_stats_display(GameState()), generate_inventory_display(GameState()), "Error - Resetting"
+
+    page_data = game_data[current_page_str]
+
     # Find the selected option
     selected_option = None
-    for i, opt in enumerate(page_data["options"]):
-        if opt["text"] == choice:
-            selected_option = opt
-            break
-    
+    if "options" in page_data:
+        for i, opt in enumerate(page_data["options"]):
+            if opt["text"] == choice:
+                selected_option = opt
+                break
+
+    # Also check alternative option if it was displayed and chosen
+    alt_opt_data = page_data.get("alternativeOption")
+    if not selected_option and alt_opt_data and alt_opt_data["text"] == choice:
+        selected_option = alt_opt_data
+
+
     if selected_option is None:
         # Handle case where choice might be "Restart" or invalid
         if choice == "Restart":
              return initialize_game()
         else:
-            # Stay on the same page if the choice wasn't found (shouldn't normally happen)
-            options = [opt["text"] for opt in page_data["options"]]
-            svg_content = create_svg_illustration(page_data["illustration"])
-            content = f"<h2>{page_data['title']}</h2>" + page_data["content"] + "<p><i>Invalid choice selected. Please try again.</i></p>"
+            # Stay on the same page if the choice wasn't found
+            options = [opt["text"] for opt in page_data.get("options", [])]
+            if not options: options = ["Restart"]
+            svg_content = create_svg_illustration(page_data.get("illustration", "default"))
+            content = f"<h2>{page_data.get('title', 'Error')}</h2>" + page_data.get("content", "") + "<p><i>Invalid choice selected. Please try again.</i></p>"
             stats_display = generate_stats_display(game_state)
             inventory_display = generate_inventory_display(game_state)
-            story_path_display = f"You remain on page {current_page}: {page_data['title']}"
-            return svg_content, content, gr.Dropdown(choices=options), game_state.to_json(), stats_display, inventory_display, story_path_display
+            story_path_display = f"You remain on page {current_page}: {page_data.get('title', 'Error')}"
+            return svg_content, content, gr.Dropdown(choices=options, value=None), game_state.to_json(), stats_display, inventory_display, story_path_display
 
     # Check if this option requires an item
     item_required = selected_option.get("requireItem")
@@ -126,7 +149,7 @@ def update_game(choice, game_state_json):
         stats_display = generate_stats_display(game_state)
         inventory_display = generate_inventory_display(game_state)
         story_path_display = f"You remain on page {current_page}: {page_data['title']}"
-        return svg_content, content, gr.Dropdown(choices=options), game_state.to_json(), stats_display, inventory_display, story_path_display
+        return svg_content, content, gr.Dropdown(choices=options, value=None), game_state.to_json(), stats_display, inventory_display, story_path_display
 
     # Check if option requires any item from a list
     any_item_required = selected_option.get("requireAnyItem")
@@ -141,48 +164,68 @@ def update_game(choice, game_state_json):
             stats_display = generate_stats_display(game_state)
             inventory_display = generate_inventory_display(game_state)
             story_path_display = f"You remain on page {current_page}: {page_data['title']}"
-            return svg_content, content, gr.Dropdown(choices=options), game_state.to_json(), stats_display, inventory_display, story_path_display
-    
+            return svg_content, content, gr.Dropdown(choices=options, value=None), game_state.to_json(), stats_display, inventory_display, story_path_display
+
     # Process special items to collect
     item_to_add = selected_option.get("addItem")
     if item_to_add and item_to_add not in game_state.inventory:
         game_state.inventory.append(item_to_add)
-    
+        # Optionally remove item if it's consumable (needs item_data lookup)
+        item_data = items_data.get(item_to_add, {})
+        if item_data.get("type") == "consumable" and item_data.get("useOnAdd"): # e.g. a potion
+             if "hpRestore" in item_data:
+                  game_state.current_hp = min(game_state.max_hp, game_state.current_hp + item_data["hpRestore"])
+             # Don't add consumable to inventory if used immediately? Or remove after use? Let's keep it simple and add it.
+
     # Move to the next page
     next_page = selected_option["next"]
     game_state.current_page = next_page
+    next_page_str = str(next_page) # Use string for keys
+
+    if next_page_str not in game_data:
+         # Handle invalid destination page
+         error_content = f"<p>Error: Option leads to invalid page number {next_page}. Resetting game.</p>"
+         svg_error = create_svg_illustration("default")
+         return svg_error, error_content, gr.Dropdown(choices=["Restart"], label="Error"), GameState().to_json(), generate_stats_display(GameState()), generate_inventory_display(GameState()), "Error - Resetting"
+
     if next_page not in game_state.visited_pages: # Avoid duplicates if revisiting
         game_state.visited_pages.append(next_page)
-    
+
     # Update journey progress based on page transitions
     game_state.journey_progress += 5 # Increment progress with each decision
     if game_state.journey_progress > 100:
         game_state.journey_progress = 100
-        
+
     battle_occurred = False
+    battle_message = "" # Initialize battle message
+    battle_result = True # Assume survival unless battle happens and player loses
+
     # Check for random battle (20% chance if page has randomBattle flag)
-    current_page_data = game_data[str(current_page)] # Data for the page *before* potential challenge/next page logic
-    if current_page_data.get("randomBattle", False) and random.random() < 0.2:
+    # Check the *current* page data before moving
+    if page_data.get("randomBattle", False) and random.random() < 0.2:
         battle_result, battle_log = simulate_battle(game_state)
         battle_occurred = True
         if not battle_result:
             # Player died in battle
             content = "<h2>Game Over</h2><p>You have been defeated in battle!</p>" + battle_log
-            return create_svg_illustration("game-over"), content, gr.Dropdown(choices=["Restart"], label="Game Over"), game_state.to_json(), generate_stats_display(game_state), generate_inventory_display(game_state), "Game Over - You were defeated in battle."
+            stats_display = generate_stats_display(game_state) # Show final stats
+            inventory_display = generate_inventory_display(game_state) # Show final inventory
+            return create_svg_illustration("game-over"), content, gr.Dropdown(choices=["Restart"], label="Game Over", value=None), game_state.to_json(), stats_display, inventory_display, "Game Over - You were defeated in battle."
         else:
              # Player survived battle, add battle log to the next page content
              battle_message = f"<div style='border: 1px solid green; padding: 10px; margin-top: 10px; background-color: #e8f5e9;'><strong>Battle Won!</strong>{battle_log}</div>"
 
     # Get new page data (for the destination page 'next_page')
-    page_data = game_data[str(next_page)]
-    
+    page_data = game_data[next_page_str]
+
     # Process page stat effects
     stat_increase = page_data.get("statIncrease")
     if stat_increase:
         stat = stat_increase["stat"]
         amount = stat_increase["amount"]
-        game_state.stats[stat] += amount
-    
+        if stat in game_state.stats:
+             game_state.stats[stat] += amount
+
     # Process HP loss
     hp_loss = page_data.get("hpLoss")
     if hp_loss:
@@ -190,99 +233,122 @@ def update_game(choice, game_state_json):
         if game_state.current_hp <= 0:
             game_state.current_hp = 0
             content = "<h2>Game Over</h2><p>You have died from your wounds!</p>"
-            return create_svg_illustration("game-over"), content, gr.Dropdown(choices=["Restart"], label="Game Over"), game_state.to_json(), generate_stats_display(game_state), generate_inventory_display(game_state), "Game Over - You died from your wounds."
-    
+            stats_display = generate_stats_display(game_state) # Show final stats
+            inventory_display = generate_inventory_display(game_state) # Show final inventory
+            return create_svg_illustration("game-over"), content, gr.Dropdown(choices=["Restart"], label="Game Over", value=None), game_state.to_json(), stats_display, inventory_display, "Game Over - You died from your wounds."
+
     challenge_log = ""
+    challenge_occurred = False
     # Check if this is a challenge page
     challenge = page_data.get("challenge")
     if challenge:
+        challenge_occurred = True
         success, roll, total = perform_challenge(game_state, challenge)
         challenge_log = f"<div style='border: 1px solid #ccc; padding: 10px; margin-top: 10px; background-color: #eee;'>"
         challenge_log += f"<strong>Challenge: {challenge.get('title', 'Skill Check')}</strong><br>"
         challenge_log += f"Target Stat: {challenge['stat']}, Difficulty: {challenge['difficulty']}<br>"
-        challenge_log += f"You rolled a {roll} + {game_state.stats[challenge['stat']] - (roll - total)} ({challenge['stat']}) = {total}<br>"
-        
+        challenge_log += f"You rolled a {roll} + ({game_state.stats.get(challenge['stat'], 0)} {challenge['stat']}) = {total}<br>" # Corrected stat display
+
         # Update story based on challenge result
         if success:
             challenge_log += "<strong style='color: green;'>Success!</strong></div>"
             next_page = challenge["success"]
         else:
-            challenge_log += "<strong style='color: red;'>Failure!</strong></div>"
+            # *** THIS IS THE CORRECTED LINE ***
+            challenge_log += "<strong style='color: red;'>Failure!</strong></div>" 
             next_page = challenge["failure"]
-        
+
+        # Update game state to reflect the page change from the challenge outcome
         game_state.current_page = next_page
+        next_page_str = str(next_page) # Use string for keys
+
+        if next_page_str not in game_data:
+            # Handle invalid page number from challenge outcome
+            error_content = f"<p>Error: Challenge outcome leads to invalid page number {next_page}. Resetting game.</p>"
+            svg_error = create_svg_illustration("default")
+            return svg_error, error_content, gr.Dropdown(choices=["Restart"], label="Error"), GameState().to_json(), generate_stats_display(GameState()), generate_inventory_display(GameState()), "Error - Resetting"
+
         if next_page not in game_state.visited_pages:
             game_state.visited_pages.append(next_page)
-        page_data = game_data[str(next_page)] # Load data for the page determined by the challenge outcome
-    
+        page_data = game_data[next_page_str] # Load data for the page determined by the challenge outcome
+
     # Create the SVG illustration for the final destination page
     svg_content = create_svg_illustration(page_data.get("illustration", "default"))
-    
+
     # Handle game over on the destination page
     if page_data.get("gameOver", False):
         content = f"<h2>{page_data['title']}</h2>"
         content += page_data["content"]
         if battle_occurred and battle_result: content += battle_message # Add battle log if survived
-        if challenge: content += challenge_log # Add challenge log
+        if challenge_occurred: content += challenge_log # Add challenge log
         if "ending" in page_data:
             content += f"<div style='text-align: center; margin-top: 20px; font-weight: bold; color: #c00;'>THE END</div>"
             content += f"<p style='font-style: italic;'>{page_data['ending']}</p>"
-        
-        return svg_content, content, gr.Dropdown(choices=["Restart"], label="Game Over"), game_state.to_json(), generate_stats_display(game_state), generate_inventory_display(game_state), "Game Over - " + page_data['title']
-    
+
+        stats_display = generate_stats_display(game_state) # Show final stats
+        inventory_display = generate_inventory_display(game_state) # Show final inventory
+        return svg_content, content, gr.Dropdown(choices=["Restart"], label="Game Over", value=None), game_state.to_json(), stats_display, inventory_display, "Game Over - " + page_data.get('title', 'Untitled')
+
     # Build page content for the final destination page
-    content = f"<h2>{page_data['title']}</h2>"
-    content += page_data["content"]
+    content = f"<h2>{page_data.get('title', 'Untitled Page')}</h2>"
+    content += page_data.get("content", "<p>No content.</p>")
     if battle_occurred and battle_result: content += battle_message # Add battle log if survived
-    if challenge: content += challenge_log # Add challenge log
-    
+    if challenge_occurred: content += challenge_log # Add challenge log
+
     # Build options for the final destination page
     options = []
-    if "options" in page_data: # Check if options exist (Game Over pages might not have them)
+    current_inventory = game_state.inventory # Cache inventory for checks
+    if "options" in page_data: # Check if options exist
         for opt in page_data["options"]:
             option_available = True
             # Check if option requires an item
-            if "requireItem" in opt and opt["requireItem"] not in game_state.inventory:
+            req_item = opt.get("requireItem")
+            if req_item and req_item not in current_inventory:
                  option_available = False
             # Check if option requires any item from a list
-            if option_available and "requireAnyItem" in opt:
-                if not any(item in game_state.inventory for item in opt["requireAnyItem"]):
+            req_any_item = opt.get("requireAnyItem")
+            if option_available and req_any_item:
+                if not any(item in current_inventory for item in req_any_item):
                      option_available = False
-                     
+
             if option_available:
                 options.append(opt["text"])
-    
-    # Handle alternative option if necessary (only if no primary options are available)
+
+    # Handle alternative option if necessary (only if no primary options are available/visible)
     alt_opt_data = page_data.get("alternativeOption")
     if alt_opt_data and not options:
         alt_show_if = alt_opt_data.get("showIf")
         # Show alternative if no condition or condition met
-        if not alt_show_if or any(item in game_state.inventory for item in alt_show_if):
+        if not alt_show_if or any(item in current_inventory for item in alt_show_if):
             options.append(alt_opt_data["text"])
-            # Add the alternative option details to page_data["options"] temporarily 
-            # so the logic finds it if selected next turn
+            # Temporarily add the alternative option details to the current page's options
+            # This ensures it can be selected on the next turn if it was the only one shown
             if "options" not in page_data: page_data["options"] = []
-            page_data["options"].append(alt_opt_data)
+            # Avoid adding duplicate if somehow already there
+            if alt_opt_data not in page_data["options"]:
+                 page_data["options"].append(alt_opt_data)
 
 
     if not options: # If still no options (dead end maybe?)
-        options = ["Restart"] 
+        options = ["Restart"]
         content += "<p><i>There are no further actions you can take from here.</i></p>"
 
     # Update game progress display text
-    story_path = f"You are on page {next_page}: {page_data['title']}"
+    story_path = f"You are on page {next_page}: {page_data.get('title', 'Untitled')}"
     if game_state.journey_progress >= 80:
         story_path += " (Nearing the conclusion)"
     elif game_state.journey_progress >= 50:
         story_path += " (Middle of your journey)"
     elif game_state.journey_progress >= 25:
         story_path += " (Adventure beginning)"
-        
+
     # Generate final displays
     stats_display = generate_stats_display(game_state)
     inventory_display = generate_inventory_display(game_state)
-    
-    return svg_content, content, gr.Dropdown(choices=options, label="What will you do?"), game_state.to_json(), stats_display, inventory_display, story_path
+
+    # Ensure dropdown value is reset so change event fires even if same choice is valid again
+    return svg_content, content, gr.Dropdown(choices=options, label="What will you do?", value=None), game_state.to_json(), stats_display, inventory_display, story_path
+
 
 def generate_stats_display(game_state):
     """Generate HTML for displaying player stats"""
@@ -293,7 +359,7 @@ def generate_stats_display(game_state):
         hp_color = "#F44336" # Red
     elif hp_percent < 70:
         hp_color = "#FFC107" # Yellow
-    
+
     stats_html = f"""
     <div style='display: flex; flex-wrap: wrap; gap: 10px; margin-top: 15px;'>
         <div style='background: #f0f0f0; padding: 5px 10px; border-radius: 5px;'>
@@ -313,7 +379,7 @@ def generate_stats_display(game_state):
         </div>
     </div>
     """
-    
+
     # Add journey progress
     stats_html += f"""
     <div style='margin-top: 10px;'>
@@ -326,20 +392,21 @@ def generate_stats_display(game_state):
         </div>
     </div>
     """
-    
+
     return stats_html
 
 def generate_inventory_display(game_state):
     """Generate HTML for displaying player inventory"""
     if not game_state.inventory:
         return "<em>Your inventory is empty.</em>"
-    
-    inventory_html = "<div style='display: flex; flex-wrap: wrap; gap: 10px;'>"
-    
+
+    inventory_html = "<div style='display: flex; flex-wrap: wrap; gap: 10px; margin-top: 10px;'>" # Added margin-top
+
     for item in game_state.inventory:
         item_data = items_data.get(item, {"type": "unknown", "description": "A mysterious item."})
         bg_color = "#e0e0e0" # Default grey
         item_type = item_data.get("type", "unknown")
+        description = item_data.get('description', 'No description available.')
 
         if item_type == "weapon":
             bg_color = "#ffcdd2" # Light red
@@ -349,14 +416,16 @@ def generate_inventory_display(game_state):
             bg_color = "#bbdefb" # Light blue
         elif item_type == "quest":
             bg_color = "#fff9c4" # Light yellow
-        
+        elif item_type == "consumable":
+             bg_color = "#d1c4e9" # Light purple
+
         inventory_html += f"""
-        <div style='background: {bg_color}; padding: 5px 10px; border-radius: 5px; position: relative;' 
-             title="{item_data.get('description', 'No description available.')}">
+        <div style='background: {bg_color}; padding: 5px 10px; border-radius: 5px; position: relative; cursor: help;'
+             title="{description}">
             {item}
         </div>
         """
-    
+
     inventory_html += "</div>"
     return inventory_html
 
@@ -364,54 +433,56 @@ def perform_challenge(game_state, challenge):
     """Perform a skill challenge and determine success. Returns (success_bool, roll, total)"""
     stat = challenge["stat"]
     difficulty = challenge["difficulty"]
-    
+
     # Roll dice (1-6) and add stat
     roll = random.randint(1, 6)
     player_stat_value = game_state.stats.get(stat, 0) # Default to 0 if stat doesn't exist
     total = roll + player_stat_value
-    
+
     # Determine if successful
     success = total >= difficulty
-    
+
     # Bonus for great success
     if success and total >= difficulty + 3:
         stat_increase = random.randint(1, 2)
-        game_state.stats[stat] = player_stat_value + stat_increase
-    
+        if stat in game_state.stats:
+             game_state.stats[stat] = player_stat_value + stat_increase
+
     # Penalty for bad failure
     if not success and total <= difficulty - 3:
         stat_decrease = random.randint(1, 2)
-        game_state.stats[stat] = max(1, player_stat_value - stat_decrease) # Stat cannot go below 1
-    
+        if stat in game_state.stats:
+             game_state.stats[stat] = max(1, player_stat_value - stat_decrease) # Stat cannot go below 1
+
     # Record challenge outcome
     if success:
         game_state.challenges_won += 1
-        
+
     return success, roll, total
 
 def simulate_battle(game_state):
     """Simulate a battle with a random enemy. Returns (player_won_bool, battle_log_html)"""
     battle_log = "<div style='font-size: 0.9em; line-height: 1.4;'>"
-    
+
     # Select a random enemy type
     enemy_types = list(enemies_data.keys())
     if not enemy_types:
          return True, "<p>No enemies defined for battle!</p>" # Avoid error if no enemies exist
     enemy_type = random.choice(enemy_types)
     enemy = enemies_data[enemy_type].copy() # Copy data to modify HP
-    
+
     battle_log += f"<p>A wild <strong>{enemy_type}</strong> appears!</p>"
-    
+
     # Simple battle simulation
     player_hp = game_state.current_hp
     enemy_hp = enemy["hp"]
-    
+
     player_base_attack = game_state.stats.get("strength", 1)
     player_base_defense = 1 # Base defense
-    
+
     player_attack = player_base_attack
     player_defense = player_base_defense
-    
+
     # Add weapon/armor bonuses if the player has relevant items
     attack_bonuses = []
     defense_bonuses = []
@@ -431,9 +502,9 @@ def simulate_battle(game_state):
 
     enemy_attack = enemy["attack"]
     enemy_defense = enemy["defense"]
-    
+
     battle_log += f"<p>Player HP: {player_hp}, Enemy HP: {enemy_hp}</p><hr>"
-    
+
     # Simple turn-based combat
     turn = 1
     while player_hp > 0 and enemy_hp > 0 and turn < 20: # Add turn limit to prevent infinite loops
@@ -442,31 +513,32 @@ def simulate_battle(game_state):
         damage_to_enemy = max(1, player_attack - enemy_defense)
         enemy_hp -= damage_to_enemy
         battle_log += f"&nbsp;&nbsp;You attack the {enemy_type} for {damage_to_enemy} damage. (Enemy HP: {max(0, enemy_hp)})<br>"
-        
+
         if enemy_hp <= 0:
             battle_log += f"<p><strong>You defeated the {enemy_type}!</strong></p>"
+            game_state.enemies_defeated += 1 # Increment defeated count
             break
-        
+
         # Enemy attacks
         damage_to_player = max(1, enemy_attack - player_defense)
         player_hp -= damage_to_player
         battle_log += f"&nbsp;&nbsp;The {enemy_type} attacks you for {damage_to_player} damage. (Your HP: {max(0, player_hp)})"
-        
+
         if player_hp <= 0:
             battle_log += f"<p><strong>The {enemy_type} defeated you!</strong></p>"
             break
-            
+
         battle_log += "<hr>"
         turn += 1
 
-    if turn >= 20:
-         battle_log += "<p>The battle drags on too long and ends inconclusively.</p>"
+    if turn >= 20 and player_hp > 0 and enemy_hp > 0: # Check if loop ended due to turn limit
+         battle_log += "<p>The battle drags on too long and ends inconclusively. The enemy retreats!</p>"
 
     # Update player HP after battle
-    game_state.current_hp = player_hp
-    
+    game_state.current_hp = max(0, player_hp) # Ensure HP doesn't go below 0
+
     # Return True if player won (or survived), False if player lost
-    player_won = player_hp > 0
+    player_won = game_state.current_hp > 0
     battle_log += "</div>"
     return player_won, battle_log
 
@@ -475,44 +547,46 @@ def simulate_battle(game_state):
 with gr.Blocks(theme=gr.themes.Soft()) as demo:
     gr.Markdown("# Choose Your Own Adventure")
     gr.Markdown("### Can you defeat the Evil Power Master?")
-    
+
     with gr.Row():
         with gr.Column(scale=2):
             illustration = gr.HTML(label="Scene")
             content = gr.HTML(label="Story")
-            choice = gr.Dropdown(label="What will you do?")
-            
+            choice = gr.Dropdown(label="What will you do?", allow_custom_value=False) # Prevent custom values
+
             # Hidden field to store game state as JSON
             game_state = gr.Textbox(label="Game State JSON", visible=False) # Changed label, still hidden
-        
+
         with gr.Column(scale=1):
             story_path = gr.Markdown(label="Your Path")
             stats = gr.HTML(label="Character Stats")
             inventory = gr.HTML(label="Inventory")
-            # map_btn = gr.Button("View Story Map") # Removed button for simplicity, can add back later
+            # map_btn = gr.Button("View Story Map") # Removed button for simplicity
 
     # Event listener for player choices
     choice.change(
-        update_game, 
-        inputs=[choice, game_state], 
+        update_game,
+        inputs=[choice, game_state],
         outputs=[illustration, content, choice, game_state, stats, inventory, story_path]
     )
-    
+
     # Initialize game on load
     demo.load(
-        initialize_game, 
-        inputs=[], 
+        initialize_game,
+        inputs=[],
         outputs=[illustration, content, choice, game_state, stats, inventory, story_path]
     )
 
+# Launch the Gradio app
 demo.launch()
+
 </gradio-file>
 
 <gradio-file name="game_engine.py">
 import json
 import random
 # Import illustrations from game_data for use in create_svg_illustration
-from game_data import illustrations 
+from game_data import illustrations
 
 class GameState:
     """Class to manage game state"""
@@ -533,11 +607,13 @@ class GameState:
         self.challenges_won = 0
         self.current_path = "main"
         self.journey_progress = 0 # Initialize progress
-    
+
     def to_json(self):
         """Convert game state to JSON string"""
-        return json.dumps(self.__dict__)
-    
+        # Ensure stats is part of the dict being dumped
+        state_dict = self.__dict__.copy()
+        return json.dumps(state_dict)
+
     @classmethod
     def from_dict(cls, data):
         """Create a GameState object from a dictionary"""
@@ -545,23 +621,28 @@ class GameState:
         # Make sure default values are preserved if not in data
         for key, value in game_state.__dict__.items():
              if key in data:
-                 setattr(game_state, key, data[key])
-        # Overwrite specific complex types if they exist in data
-        if 'stats' in data: game_state.stats = data['stats']
-        if 'inventory' in data: game_state.inventory = data['inventory']
-        if 'visited_pages' in data: game_state.visited_pages = data['visited_pages']
-
+                 # Special handling for stats dictionary to avoid losing default keys
+                 if key == 'stats' and isinstance(data[key], dict):
+                      # Update default stats with loaded stats
+                      default_stats = getattr(game_state, key)
+                      default_stats.update(data[key])
+                      setattr(game_state, key, default_stats)
+                 else:
+                      setattr(game_state, key, data[key])
         return game_state
 
 def create_svg_illustration(illustration_key):
     """Return SVG illustration based on the illustration key"""
     # If illustration is not found, use a default illustration
     svg_code = illustrations.get(illustration_key, illustrations.get("default", "<svg viewBox='0 0 100 100'><rect width='100' height='100' fill='grey'/><text x='10' y='50' fill='white'>No Image</text></svg>"))
-    
+
     # Wrap the SVG in a container div with appropriate styling
+    # Ensure SVG scales correctly within the container
     return f"""
-    <div style="width: 100%; max-height: 250px; border: 2px solid #999; border-radius: 5px; overflow: hidden; display: flex; justify-content: center; align-items: center; background-color: #eee;">
-        {svg_code}
+    <div style="width: 100%; height: 250px; border: 2px solid #999; border-radius: 5px; overflow: hidden; display: flex; justify-content: center; align-items: center; background-color: #eee;">
+        <div style="width: 100%; height: 100%; display: flex; justify-content: center; align-items: center;">
+             {svg_code}
+        </div>
     </div>
     """
 </gradio-file>
@@ -582,7 +663,7 @@ game_data = {
         ],
         "illustration": "city-gates"
     },
-    
+
     "2": {
         "title": "The Weaponsmith",
         "content": """<p>The city's renowned weaponsmith, Gorn, welcomes you to his forge. Weapons of all kinds line the walls, from simple daggers to exotic blades that pulse with magic.</p>
@@ -595,7 +676,7 @@ game_data = {
         ],
         "illustration": "weaponsmith"
     },
-    
+
     "3": {
         "title": "The Ancient Temple",
         "content": """<p>The Temple of Eternal Light stands at the heart of Silverhold. Inside, the air is thick with incense, and soft chanting echoes through the chambers.</p>
@@ -608,7 +689,7 @@ game_data = {
         ],
         "illustration": "temple"
     },
-    
+
     "4": {
         "title": "The Resistance Leader",
         "content": """<p>In a secluded tavern, you meet Lyra, leader of the resistance against the Evil Power Master. Battle-scarred but determined, she unfurls a map across the table.</p>
@@ -621,7 +702,7 @@ game_data = {
         ],
         "illustration": "resistance-meeting"
     },
-    
+
     "5": {
         "title": "The Journey Begins",
         "content": """<p>Prepared as best you can be, you leave Silverhold behind. The path to the Evil Power Master's fortress takes you through the Shadowwood Forest, a place once beautiful but now corrupted by dark magic.</p>
@@ -634,7 +715,7 @@ game_data = {
         "randomBattle": True,
         "illustration": "shadowwood-forest"
     },
-    
+
     "6": {
         "title": "Ambush on the Road",
         "content": """<p>The main road through Shadowwood is overgrown but still visible. As you make your way forward, the trees suddenly rustle with movement.</p>
@@ -650,7 +731,7 @@ game_data = {
         },
         "illustration": "road-ambush"
     },
-    
+
     "7": {
         "title": "The Mist-Shrouded River",
         "content": """<p>The river path is longer but less traveled. Thick mist clings to the water's surface, reducing visibility but potentially hiding you from enemies.</p>
@@ -666,7 +747,7 @@ game_data = {
         },
         "illustration": "river-spirit"
     },
-    
+
     "8": {
         "title": "The Forgotten Ruins",
         "content": """<p>The ancient ruins rise from the forest floor like the bones of a forgotten civilization. Moss-covered stones and crumbling arches create a labyrinth of passages and dead ends.</p>
@@ -682,7 +763,7 @@ game_data = {
         },
         "illustration": "ancient-ruins"
     },
-    
+
     "9": {
         "title": "Breaking Through",
         "content": """<p>With courage and quick thinking, you manage to fight your way through the ambush. Several scouts fall to your attacks, and the rest scatter into the forest.</p>
@@ -696,7 +777,7 @@ game_data = {
         "randomBattle": True,
         "illustration": "forest-edge"
     },
-    
+
     "10": {
         "title": "Captured!",
         "content": """<p>Despite your best efforts, the scouts overwhelm you. Disarmed and bound, you're dragged through the forest to a small outpost.</p>
@@ -710,7 +791,7 @@ game_data = {
         "hpLoss": 5,
         "illustration": "prisoner-cell"
     },
-    
+
     "11": {
         "title": "The Spirit's Blessing",
         "content": """<p>"Wisdom flows in you like the river itself," the spirit says, impressed by your answer. The mist swirls around you, and you feel a surge of energy.</p>
@@ -725,7 +806,7 @@ game_data = {
         "statIncrease": { "stat": "wisdom", "amount": 2 },
         "illustration": "spirit-blessing"
     },
-    
+
     "12": {
         "title": "The Spirit's Wrath",
         "content": """<p>"Incorrect," the spirit hisses, its melodic voice turning harsh. "The river does not suffer fools!"</p>
@@ -739,7 +820,7 @@ game_data = {
         "hpLoss": 8,
         "illustration": "river-danger"
     },
-    
+
     "13": {
         "title": "Ancient Allies",
         "content": """<p>Your wisdom guides you through the ruins' labyrinth. As you navigate the crumbling corridors, the whispers change from threatening to curious.</p>
@@ -750,9 +831,10 @@ game_data = {
             { "text": "Ask for knowledge about the fortress", "next": 16 },
             { "text": "Request they guide you through secret paths", "next": 17 }
         ],
+        "statIncrease": { "stat": "wisdom", "amount": 1 }, # Reward for passing challenge implicitly
         "illustration": "ancient-spirits"
     },
-    
+
     "14": {
         "title": "Lost in Time",
         "content": """<p>The ruins become an impossible maze. Each turn leads to unfamiliar passages, and the whispers grow louder, disorienting you further.</p>
@@ -764,24 +846,25 @@ game_data = {
             { "text": "Find a local guide in a nearby village", "next": 17 }
         ],
         "hpLoss": 10,
+        "statIncrease": { "stat": "luck", "amount": -1 }, # Penalty for failing challenge implicitly
         "illustration": "lost-ruins"
     },
-    
+
     "15": {
         "title": "The Looming Fortress",
         "content": """<p>The Evil Power Master's fortress dominates the landscape - a massive structure of black stone with towers that seem to pierce the clouds.</p>
         <p>Lightning crackles around its highest spires, and dark shapes patrol the battlements. The main gate is heavily guarded, but there must be other ways in.</p>
         <p>As you survey the imposing structure, you consider your options for infiltration.</p>""",
         "options": [
-            { "text": "Approach the main gate in disguise", "next": 21 },
-            { "text": "Scale the outer wall under cover of darkness", "next": 22 }, # Leads to Discovered!
-            { "text": "Look for the secret tunnel (requires Secret Tunnel Map)", "next": 24, "requireItem": "Secret Tunnel Map" } # Changed from 23 to 24
+            { "text": "Approach the main gate (needs disguise)", "next": 21, "requireItem": "Guard Disguise" },
+            { "text": "Scale the outer wall under cover of darkness", "next": 22 }, # Leads to Discovered! challenge
+            { "text": "Look for the secret tunnel (requires Secret Tunnel Map)", "next": 24, "requireItem": "Secret Tunnel Map" }
         ],
-        # Alternative option should only appear if the primary one is blocked
-        "alternativeOption": { "text": "Search for another entrance (if no map)", "next": 21, "showIf": ["Secret Tunnel Map"] }, # ShowIf logic inverted here, should be 'showIf *not* having map' but easier to just let it appear if map required option fails
+        # Alternative option shows if neither disguise nor map is present
+        "alternativeOption": { "text": "Search for another entrance (risky)", "next": 21, "showIf": ["Guard Disguise", "Secret Tunnel Map"] }, # Show if *missing* items
         "illustration": "evil-fortress"
     },
-    
+
     "16": {
         "title": "Strategic Approach",
         "content": """<p>You take time to observe the fortress from a distance. Patrols move in predictable patterns, and supply wagons come and go at regular intervals.</p>
@@ -789,14 +872,19 @@ game_data = {
         <p>You identify several possible entry points, each with its own risks and advantages.</p>""",
         "options": [
             { "text": "Infiltrate with an incoming supply wagon", "next": 21 },
-            { "text": "Use magic to create a distraction (requires any spell)", "next": 22, "requireAnyItem": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing"] }, # Leads to Discovered!
-            { "text": "Bribe a guard to let you in (requires special item)", "next": 23, "requireAnyItem": ["Ancient Amulet", "Poison Daggers", "Master Key"] } # Leads to Secret Resistance
+            { "text": "Use magic to create a distraction (requires any spell)", "next": 22, "requireAnyItem": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing"] }, # Leads to Discovered! challenge
+            { "text": "Bribe a guard to let you in (requires special item)", "next": 23, "requireAnyItem": ["Ancient Amulet", "Master Key"] } # Leads to Secret Resistance
         ],
         # If no required items for specific options, provide a fallback
-        "alternativeOption": { "text": "Attempt to sneak in without a specific plan", "next": 21, "showIf": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing", "Ancient Amulet", "Poison Daggers", "Master Key"] },
+        "alternativeOption": {
+            "text": "Attempt to sneak in using shadows",
+            "next": 21,
+            "showIf": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing", "Ancient Amulet", "Master Key"] # Show if missing required items
+        },
+        "statIncrease": { "stat": "wisdom", "amount": 1 }, # Reward for observation
         "illustration": "fortress-observation"
     },
-    
+
     "17": {
         "title": "The Hidden Way",
         "content": """<p>Your search reveals an unexpected approach to the fortress - an ancient maintenance tunnel that runs beneath the barren plains, likely forgotten by the Evil Power Master.</p>
@@ -805,11 +893,11 @@ game_data = {
         "options": [
             { "text": "Enter the tunnel immediately", "next": 24 },
             { "text": "Hide and wait for the patrol to pass", "next": 21 },
-            { "text": "Set a trap for the patrol", "next": 22 } # Leads to Discovered!
+            { "text": "Set a trap for the patrol", "next": 22 } # Leads to Discovered! challenge
         ],
         "illustration": "hidden-tunnel"
     },
-    
+
     "18": {
         "title": "Night Escape",
         "content": """<p>You wait until the dead of night, when most guards are dozing at their posts. Using a loose stone you discovered in your cell, you work on the rusted lock.</p>
@@ -820,12 +908,12 @@ game_data = {
             "description": "Slip past the sleeping guards without alerting them.",
             "stat": "wisdom",
             "difficulty": 6,
-            "success": 16, # Escaped successfully, continue observing
-            "failure": 10 # Recaptured! Back to cell
+            "success": 16, # Escaped successfully, back to observing
+            "failure": 10 # Recaptured! Back to cell (loop)
         },
         "illustration": "night-escape"
     },
-    
+
     "19": {
         "title": "Unexpected Ally",
         "content": """<p>When the guard passes your cell alone, you whisper, asking why they seemed sympathetic. The guard looks around nervously before responding.</p>
@@ -834,26 +922,25 @@ game_data = {
         "options": [
             { "text": "Accept the guard's help (gain disguise, proceed)", "next": 16, "addItem": "Guard Disguise"}, # Gain disguise, proceed to strategic approach
             { "text": "Decline - you don't want to put them at risk", "next": 18 }, # Try night escape instead
-            { "text": "Convince them to join your cause", "next": 20 } # Maybe they arrange transport?
+            { "text": "Convince them to join your cause", "next": 20 } # They arrange transport?
         ],
-        # Removed addItem from here, added to option
         "illustration": "guard-ally"
     },
-    
+
     "20": {
         "title": "Journey to the Fortress",
         "content": """<p>At dawn, you're bound and loaded onto a prison wagon with other captured travelers. The journey to the fortress is uncomfortable, but you use the time to observe and plan.</p>
         <p>The other prisoners share what they know about the fortress. One mentions rumors of a resistance operating within the Evil Power Master's ranks.</p>
         <p>As the wagon approaches the massive gates, you begin to formulate a plan.</p>""",
         "options": [
-            { "text": "Look for an opportunity to escape during transfer", "next": 22 }, # High risk, likely leads to discovered
+            { "text": "Look for an opportunity to escape during transfer", "next": 22 }, # High risk, likely leads to discovered challenge
             { "text": "Remain captive to get inside, then escape", "next": 21 }, # Get inside, then try to move
-            { "text": "Try to contact the internal resistance (requires clue)", "next": 23, "requireAnyItem": ["Guard Disguise"]} # Need something to signal resistance
+            { "text": "Try to contact the internal resistance (needs clue/item)", "next": 23, "requireAnyItem": ["Guard Disguise", "Ancient Amulet"]} # Signal resistance
         ],
-         "alternativeOption": { "text": "Remain captive with no plan", "next": 28, "showIf": ["Guard Disguise"] }, # If no clue for resistance
+         "alternativeOption": { "text": "Remain captive with no plan (leads to capture)", "next": 28, "showIf": ["Guard Disguise", "Ancient Amulet"] }, # If no clue/item
         "illustration": "prison-wagon"
     },
-    
+
     "21": {
         "title": "Infiltration",
         "content": """<p>Using your skills and preparation, you manage to infiltrate the outer perimeter of the fortress. The black stone walls loom overhead, even more intimidating up close.</p>
@@ -864,10 +951,10 @@ game_data = {
             { "text": "Search for the dungeons", "next": 26 },
             { "text": "Follow a group of mages", "next": 27 }
         ],
-        "randomBattle": True, # Corrected typo
+        "randomBattle": True,
         "illustration": "fortress-interior"
     },
-    
+
     "22": {
         "title": "Discovered!",
         "content": """<p>As you make your way through the fortress, an alarm suddenly sounds! Your presence has been detected, and you hear the heavy footsteps of guards approaching.</p>
@@ -876,14 +963,14 @@ game_data = {
         "challenge": {
             "title": "Escape Detection",
             "description": "You need to escape from the approaching guards before they trap you.",
-            "stat": "courage", # Changed to courage for variety
+            "stat": "courage",
             "difficulty": 7,
             "success": 25, # Managed to evade, head to tower
             "failure": 28 # Captured Again
         },
         "illustration": "fortress-alarm"
     },
-    
+
     "23": {
         "title": "Secret Resistance",
         "content": """<p>Through luck or skill (or maybe a bribe or disguise), you make contact with members of the secret resistance operating within the fortress. They're skeptical of you at first, but your actions have convinced them of your intentions.</p>
@@ -896,7 +983,7 @@ game_data = {
         ],
         "illustration": "secret-meeting"
     },
-    
+
     "24": {
         "title": "Underground Passage",
         "content": """<p>The ancient tunnel is damp and narrow, forcing you to crouch as you make your way forward. Roots hang from the ceiling, and the air feels thick with age.</p>
@@ -909,21 +996,21 @@ game_data = {
         ],
         "illustration": "underground-passage"
     },
-    
+
     "25": {
         "title": "The Central Tower",
         "content": """<p>The central tower rises from the heart of the fortress like a black spear. As you get closer, you can feel powerful magic emanating from its peak.</p>
         <p>Guards are more numerous here, and you spot several dark mages performing rituals in alcoves along the walls. Whatever the Evil Power Master is planning, it seems to be approaching its climax.</p>
         <p>A massive door blocks the entrance to the tower, engraved with strange symbols.</p>""",
         "options": [
-            { "text": "Try to decipher the symbols", "next": 35 },
+            { "text": "Try to decipher the symbols (needs wisdom)", "next": 35 },
             { "text": "Look for another entrance", "next": 36 },
-            { "text": "Use magic to open the door (requires any spell)", "next": 37, "requireAnyItem": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing"] }
+            { "text": "Use magic/key to open the door", "next": 37, "requireAnyItem": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing", "Master Key"] }
         ],
-        "alternativeOption": { "text": "Wait and observe the mages", "next": 36, "showIf": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing"] },
+        "alternativeOption": { "text": "Wait and observe the mages", "next": 36, "showIf": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing", "Master Key"] },
         "illustration": "central-tower"
     },
-    
+
     "26": {
         "title": "The Dungeons",
         "content": """<p>The dungeons are a maze of dark, damp corridors lined with cells. Moans and whispers echo off the stone walls, creating an eerie atmosphere of despair.</p>
@@ -936,7 +1023,7 @@ game_data = {
         ],
         "illustration": "dungeon-corridors"
     },
-    
+
     "27": {
         "title": "The Ritual Chamber",
         "content": """<p>Following the group of mages leads you to a large circular chamber. Hidden in the shadows, you observe as they prepare for what appears to be an important ritual.</p>
@@ -949,20 +1036,20 @@ game_data = {
         ],
         "illustration": "ritual-chamber"
     },
-    
+
     "28": {
         "title": "Captured Again",
         "content": """<p>The guards overwhelm you, and this time, there's no easy escape. You're brought before a high-ranking officer, who smiles coldly.</p>
         <p>"The Master will be most pleased," he says. "He so rarely gets to meet those foolish enough to challenge him directly."</p>
         <p>You're escorted under heavy guard toward the central tower, where the Evil Power Master awaits.</p>""",
         "options": [
-            { "text": "Look for another chance to escape", "next": 44 },
+            { "text": "Look for another chance to escape (low odds)", "next": 44 },
             { "text": "Prepare yourself mentally to face the Power Master", "next": 45 },
             { "text": "Try to gather information from the guards", "next": 46 }
         ],
         "illustration": "prisoner-escort"
     },
-    
+
     "29": {
         "title": "The Uprising",
         "content": """<p>The resistance has planned carefully. When the signal is given, chaos erupts throughout the fortress. Guards find themselves fighting servants, and magical wards fail as saboteurs destroy key components.</p>
@@ -975,7 +1062,7 @@ game_data = {
         ],
         "illustration": "fortress-uprising"
     },
-    
+
     "30": {
         "title": "The Final Approach",
         "content": """<p>With the resistance's help, you navigate through secret passages unknown to most of the fortress inhabitants. These narrow corridors, built during the fortress's construction, lead directly to the upper levels.</p>
@@ -988,7 +1075,7 @@ game_data = {
         ],
         "illustration": "secret-passage"
     },
-    
+
     "31": {
         "title": "Knowledge Exchange",
         "content": """<p>You share everything you've learned on your journey - about the river spirit, the ancient ruins, and any magical artifacts you've collected. In return, the resistance provides crucial information.</p>
@@ -999,57 +1086,45 @@ game_data = {
             { "text": "Find out when the alignment will occur", "next": 54 },
             { "text": "Learn if there are any weapons that can harm the crystal", "next": 55 }
         ],
+        "statIncrease": { "stat": "wisdom", "amount": 1 }, # Reward for sharing info
         "illustration": "knowledge-sharing"
     },
 
     # --- Placeholder Pages ---
-    "32": { "title": "Storeroom Search", "content": "<p>You search the dusty storeroom. Mostly old crates and broken tools, but you find a Healing Potion tucked away!</p>", "options": [{ "text": "Find a way up", "next": 33 }], "addItem": "Healing Potion", "illustration": "underground-passage" },
-    "33": { "title": "Ascending", "content": "<p>You find a loose grate leading to the fortress kitchens. Smells better than the tunnel.</p>", "options": [{ "text": "Sneak through the kitchens", "next": 21 }], "illustration": "fortress-interior" },
-    "34": { "title": "Listening", "content": "<p>You hear guards marching above, and the clang of metal. Sounds like standard patrols, nothing urgent.</p>", "options": [{ "text": "Explore the storeroom", "next": 32 }, { "text": "Try to find a way up", "next": 33 }], "illustration": "underground-passage" },
-    "35": { "title": "Deciphering Symbols", "content": "<p>The symbols pulse with dark energy. Your wisdom tells you they form a powerful ward, requiring a specific magical key or immense force.</p>", "options": [{ "text": "Look for another entrance", "next": 36 }, { "text": "Use magic (if you have it)", "next": 37, "requireAnyItem": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing", "Master Key"] }], "illustration": "central-tower" },
-    "36": { "title": "Searching for Entry", "content": "<p>You circle the base of the tower. High up, you spot a less guarded balcony. Scaling the tower might be possible, but dangerous.</p>", "options": [{ "text": "Attempt to climb", "next": 22 }, {"text": "Return to the main door", "next": 25}], "illustration": "central-tower" },
-    "37": { "title": "Magical Entry", "content": "<p>You channel your magic (or use the Master Key). The symbols flare, and the massive door grinds open! You step inside the tower.</p>", "options": [{ "text": "Ascend the tower", "next": 48 }], "illustration": "final-confrontation" }, # Straight to the top
-    "38": { "title": "Causing Distraction", "content": "<p>You manage to unlock a few cells. The freed prisoners, though weak, cause a commotion, drawing guards away.</p>", "options": [{ "text": "Investigate the guarded cell", "next": 39 }, {"text": "Look for an exit upwards", "next": 40}], "illustration": "dungeon-corridors" },
-    "39": { "title": "Guarded Cell", "content": "<p>Inside the cell is a captured resistance mage! They recognize your intent and offer to help you reach the Master if freed.</p>", "options": [{ "text": "Free the mage (requires Master Key or skill)", "next": 30, "requireAnyItem": ["Master Key", "Ancient Amulet"] }, {"text": "Leave them for now", "next": 40}], "illustration": "dungeon-corridors" },
-    "40": { "title": "Finding Passage", "content": "<p>You find a hidden staircase leading up, likely towards the main fortress levels.</p>", "options": [{ "text": "Take the stairs", "next": 21 }], "illustration": "fortress-interior" },
-    "41": { "title": "Disrupting the Ritual", "content": "<p>You burst in! The mages are startled. You attack, disrupting their concentration. The crystal flares erratically.</p>", "options": [{ "text": "Fight the mages", "next": 22 }], "illustration": "ritual-chamber" }, # Likely leads to being discovered
-    "42": { "title": "Observing the Ritual", "content": "<p>You watch as the mages chant. The crystal seems to be drawing power from somewhere deep within the fortress, focusing it for the Master.</p>", "options": [{ "text": "Try to disrupt it now", "next": 41 }, {"text": "Try to steal the crystal", "next": 43}, {"text": "Leave and head to the tower", "next": 25}], "illustration": "ritual-chamber" },
-    "43": { "title": "Stealing the Crystal", "content": "<p>You attempt to snatch the crystal. It burns with cold energy! The mages react instantly, attacking you.</p>", "options": [{ "text": "Fight back!", "next": 22 }], "illustration": "ritual-chamber" }, # Leads to being discovered
-    "44": { "title": "Escape Attempt", "content": "<p>You look for a chance, but the guards are too vigilant. No escape seems possible right now.</p>", "options": [{ "text": "Prepare mentally", "next": 45 }, {"text": "Gather info", "next": 46}], "illustration": "prisoner-escort" },
-    "45": { "title": "Mental Preparation", "content": "<p>You focus your mind, recalling your training and purpose. You are ready to face the Evil Power Master.</p>", "options": [{ "text": "Continue to the Master's chamber", "next": 48 }], "illustration": "final-confrontation" }, # Directly to final battle
-    "46": { "title": "Gathering Information", "content": "<p>You try to subtly listen to the guards. They mention the Master is 'nearly ready' and the 'crystal is at peak power'. Time is short.</p>", "options": [{ "text": "Prepare mentally", "next": 45 }, {"text": "Look for escape again", "next": 44}], "illustration": "prisoner-escort" },
-    "47": { "title": "Leading the Charge", "content": "<p>You lead the resistance fighters bravely, cutting through the Master's guards. You push towards the tower entrance.</p>", "options": [{ "text": "Breach the tower door", "next": 25 }], "illustration": "fortress-uprising" },
+    "32": { "title": "Storeroom Search", "content": "<p>You search the dusty storeroom. Mostly old crates and broken tools, but you find a forgotten Healing Potion tucked away!</p>", "options": [{ "text": "Drink Potion and find way up", "next": 33, "addItem": "Healing Potion" }], "illustration": "underground-passage" }, # Add Potion
+    "33": { "title": "Ascending", "content": "<p>You find a loose grate leading to the fortress kitchens. Smells marginally better than the tunnel. You emerge cautiously.</p>", "options": [{ "text": "Sneak through the kitchens", "next": 21 }], "illustration": "fortress-interior" },
+    "34": { "title": "Listening", "content": "<p>You hear the rhythmic marching of guards above, and the distant clang of metal from the armory. Sounds like standard patrols, nothing immediately alarming.</p>", "options": [{ "text": "Explore the storeroom", "next": 32 }, { "text": "Try to find a way up", "next": 33 }], "illustration": "underground-passage" },
+    "35": { "title": "Deciphering Symbols", "content": "<p>The symbols pulse with dark energy. Your wisdom tells you they form a powerful ward, possibly tied to the Master's life force. It requires a specific magical resonance or immense force to bypass.</p>", "options": [{ "text": "Look for another entrance", "next": 36 }, { "text": "Use magic/key (if you have it)", "next": 37, "requireAnyItem": ["Healing Light Spell", "Shield of Faith Spell", "Binding Runes Scroll", "Water Spirit's Blessing", "Master Key", "Ancient Amulet"] }], "statIncrease": {"stat":"wisdom", "amount":1}, "illustration": "central-tower" },
+    "36": { "title": "Searching for Entry", "content": "<p>You circle the base of the tower. High up, you spot a less guarded balcony. Scaling the sheer, dark stone might be possible for someone with exceptional strength or courage, but it's extremely dangerous.</p>", "options": [{ "text": "Attempt to climb (Strength/Courage Challenge)", "next": 22 }, {"text": "Return to the main door", "next": 25}], "illustration": "central-tower" }, # Leads to challenge
+    "37": { "title": "Magical Entry", "content": "<p>You focus your magical item (or the Master Key). The symbols flare violently, then fade as the massive door groans open! You step into the oppressive darkness of the tower base.</p>", "options": [{ "text": "Ascend the tower", "next": 48 }], "illustration": "final-confrontation" }, # Straight to the top
+    "38": { "title": "Causing Distraction", "content": "<p>Using your lockpicking skills (or the Master Key), you manage to unlock a few cells. The freed prisoners, though weak, immediately cause a commotion, shouting and banging, drawing several guards away from their posts.</p>", "options": [{ "text": "Investigate the guarded cell", "next": 39 }, {"text": "Look for an exit upwards", "next": 40}], "requireAnyItem": ["Master Key"], "illustration": "dungeon-corridors" }, # Added item requirement
+    "39": { "title": "Guarded Cell", "content": "<p>Inside the heavily barred cell is a frail figure clad in mage robes – likely a captured resistance member or someone who defied the Master. They look up weakly as you approach the bars.</p>", "options": [{ "text": "Attempt to free the mage (needs Master Key/Runes)", "next": 30, "requireAnyItem": ["Master Key", "Binding Runes Scroll"] }, {"text": "Leave them for now", "next": 40}], "illustration": "dungeon-corridors" }, # Specified required items
+    "40": { "title": "Finding Passage", "content": "<p>Behind a loose tapestry depicting the Master's grim visage, you find a hidden spiral staircase leading up, likely towards the main fortress levels above the dungeons.</p>", "options": [{ "text": "Take the stairs", "next": 21 }], "illustration": "fortress-interior" },
+    "41": { "title": "Disrupting the Ritual", "content": "<p>You burst into the chamber! The mages are startled, their chant faltering. You launch an attack, disrupting their concentration entirely. The central crystal flares erratically, and raw magic arcs through the room.</p>", "options": [{ "text": "Fight the enraged mages!", "next": 22 }], "illustration": "ritual-chamber" }, # Likely leads to being discovered challenge
+    "42": { "title": "Observing the Ritual", "content": "<p>You watch intently as the mages chant in unison. The crystal seems to be drawing power from ley lines deep within the fortress, focusing it towards the tower's peak for the Master's final empowerment during the alignment.</p>", "options": [{ "text": "Try to disrupt it now", "next": 41 }, {"text": "Try to steal the crystal (very risky)", "next": 43}, {"text": "Leave and head to the tower", "next": 25}], "statIncrease": {"stat": "wisdom", "amount": 1}, "illustration": "ritual-chamber" },
+    "43": { "title": "Stealing the Crystal", "content": "<p>As the mages are deep in their chant, you attempt to swiftly snatch the pulsing crystal. It burns with raw, cold energy! They immediately sense the disturbance and react with fury, turning to attack you.</p>", "options": [{ "text": "Fight back!", "next": 22 }], "illustration": "ritual-chamber" }, # Leads to being discovered challenge
+    "44": { "title": "Escape Attempt", "content": "<p>You scan your surroundings, looking for any weakness, any chance. But the guards are professionals, their grip like iron, their eyes vigilant. No escape seems possible right now.</p>", "options": [{ "text": "Focus and prepare mentally", "next": 45 }, {"text": "Try to glean info from guards", "next": 46}], "illustration": "prisoner-escort" },
+    "45": { "title": "Mental Preparation", "content": "<p>You close your eyes briefly, focusing your mind. You recall your training, your purpose, the faces of those suffering under the Master's rule. You are ready. Let him come.</p>", "options": [{ "text": "Continue to the Master's chamber", "next": 48 }], "statIncrease": {"stat": "courage", "amount": 1}, "illustration": "final-confrontation" }, # Directly to final battle
+    "46": { "title": "Gathering Information", "content": "<p>You try to subtly listen to the guards' chatter. They mutter about the Master being 'nearly ready' and the 'alignment is minutes away'. One nervously mentions the crystal is 'unstable' at peak power. Time is critically short.</p>", "options": [{ "text": "Focus and prepare mentally", "next": 45 }, {"text": "Look desperately for escape again", "next": 44}], "statIncrease": {"stat": "wisdom", "amount": 1}, "illustration": "prisoner-escort" },
+    "47": { "title": "Leading the Charge", "content": "<p>With a battle cry, you lead the resistance fighters forward, cutting through the surprised ranks of the Master's personal guard. Steel clashes against steel as you push relentlessly towards the main tower entrance.</p>", "options": [{ "text": "Breach the tower door", "next": 25 }], "illustration": "fortress-uprising" },
     # Page 48 is the final confrontation
-    "49": { "title": "Sneaking Ahead", "content": "<p>While the uprising rages, you slip past the guards and find a less-guarded entrance to the tower.</p>", "options": [{ "text": "Enter the tower", "next": 50 }], "illustration": "secret-passage" },
-    "50": { "title": "Cautious Entry", "content": "<p>You enter the tower base. Stairs spiral upwards into darkness. The air hums with power.</p>", "options": [{ "text": "Ascend carefully", "next": 48 }], "illustration": "final-confrontation" }, # Head to final battle
-    "51": { "title": "Ritual Information", "content": "<p>Your guide explains the Master is performing a ritual tied to a cosmic alignment to achieve near-godhood. The crystal is key.</p>", "options": [{ "text": "Enter the tower", "next": 50 }, {"text": "Ask for more help", "next": 52}], "illustration": "secret-passage" },
-    "52": { "title": "Requesting Help", "content": "<p>The resistance offers a brave warrior to accompany you, providing backup in the final fight.</p>", "options": [{ "text": "Accept the help and enter", "next": 48 }], "addItem": "Resistance Ally", "illustration": "secret-passage" }, # Add ally and go to fight
-    "53": { "title": "Crystal Location", "content": "<p>The crystal is kept in the Master's main chamber, at the very top of the central tower. It floats above his throne.</p>", "options": [{ "text": "Head to the tower", "next": 48 }], "illustration": "knowledge-sharing" }, # Go to final battle
-    "54": { "title": "Alignment Timing", "content": "<p>The alignment is imminent! Perhaps only minutes away. You must hurry!</p>", "options": [{ "text": "Head to the tower immediately", "next": 48 }], "illustration": "knowledge-sharing" }, # Go to final battle
-    "55": { "title": "Crystal Weakness", "content": "<p>They mention rumors that pure light or holy energy can disrupt the crystal. Perhaps your Healing Light or Shield of Faith spells?</p>", "options": [{ "text": "Head to the tower", "next": 48 }], "illustration": "knowledge-sharing" }, # Go to final battle
-    
-    "58": { 
-         "title": "Attempt to Reason", 
-         "content": """<p>You try to speak to the Evil Power Master, appealing to any shred of humanity left. He laughs mockingly.</p>
-         <p>"Humanity? Reason? Such petty concerns! Power is the only truth!" he snarls, launching a powerful attack.</p>
-         <p>It seems negotiation is impossible.</p>""",
-         "options": [
-             { "text": "Attack the Evil Power Master directly", "next": 56 },
-             { "text": "Try to destroy the crystal", "next": 57 }
-         ],
-         "illustration": "final-confrontation" 
-    },
+    "49": { "title": "Sneaking Ahead", "content": "<p>While the main uprising creates chaos as a diversion, you slip through the shadows, bypassing the main battle. You find a less-guarded servant's entrance to the central tower.</p>", "options": [{ "text": "Enter the tower stealthily", "next": 50 }], "illustration": "secret-passage" },
+    "50": { "title": "Cautious Entry", "content": "<p>You ease open the hidden door and step into the base of the central tower. A grand staircase spirals upwards into oppressive darkness. The very air hums with palpable dark energy.</p>", "options": [{ "text": "Ascend the tower carefully", "next": 48 }], "illustration": "final-confrontation" }, # Head to final battle
+    "51": { "title": "Ritual Information", "content": "<p>Your resistance guide explains the Master is performing a ritual tied to a rare cosmic alignment to achieve immense power, possibly immortality. The dark crystal in his chamber is the focal point.</p>", "options": [{ "text": "Enter the tower now", "next": 50 }, {"text": "Ask for additional backup", "next": 52}], "illustration": "secret-passage" },
+    "52": { "title": "Requesting Help", "content": "<p>The resistance leader nods grimly. 'Take Kaelen,' she says, gesturing to a scarred warrior armed with a blessed axe. 'May their strength aid yours.' Kaelen gives a curt nod.</p>", "options": [{ "text": "Accept Kaelen's help and enter", "next": 48 }], "addItem": "Resistance Ally", "illustration": "secret-passage" }, # Add ally and go to fight
+    "53": { "title": "Crystal Location", "content": "<p>The resistance sage confirms the crystal is kept in the Master's main audience chamber, at the very top of the central tower. It reputedly floats above his throne, radiating immense power.</p>", "options": [{ "text": "Prepare and head to the tower", "next": 48 }], "illustration": "knowledge-sharing" }, # Go to final battle
+    "54": { "title": "Alignment Timing", "content": "<p>'The alignment is upon us!' the sage gasps, pointing to strange lights in the sky visible even through the fortress windows. 'It may already be too late! You must hurry!'</p>", "options": [{ "text": "Race to the tower immediately!", "next": 48 }], "illustration": "knowledge-sharing" }, # Go to final battle
+    "55": { "title": "Crystal Weakness", "content": "<p>They mention ancient texts hinting that the crystal, forged in darkness, is vulnerable to sources of pure light or concentrated holy energy. Perhaps your Healing Light spell, if focused, or the Shield of Faith could disrupt it?</p>", "options": [{ "text": "Remember this and head to the tower", "next": 48 }], "illustration": "knowledge-sharing" }, # Go to final battle
 
-    # --- Endings (already defined) ---
     "56": { # Direct Confrontation Battle
         "title": "Direct Confrontation",
-        "content": """<p>You charge at the Evil Power Master, drawing on all your courage and strength. He meets your attack with dark magic, the air between you distorting with energy.</p>
-        <p>The battle is intense, pushing you to your limits. Each blow you land seems to be absorbed by his power, while his attacks grow increasingly dangerous.</p>
-        <p>As the fight continues, you realize that as long as the crystal empowers him, this might be an unwinnable battle.</p>""",
+        "content": """<p>You charge at the Evil Power Master, drawing on all your courage and strength. He meets your attack with blasts of dark magic, the air between you crackling and distorting with raw energy.</p>
+        <p>The battle is fierce, pushing you to your absolute limits. Each blow you land seems partially absorbed by the dark energy surrounding him, while his counter-attacks grow increasingly powerful and difficult to evade.</p>
+        <p>As the fight rages, you realize that as long as the dark crystal pulses behind him, this might be an unwinnable war of attrition.</p>""",
         "challenge": {
             "title": "Battle with the Evil Power Master",
-            "description": "You must overcome his dark magic through sheer determination and skill.",
-            "stat": "strength", # Strength check
+            "description": "You must overcome his dark magic through sheer determination, skill, and perhaps exploiting a weakness.",
+            "stat": "strength", # Primary check is Strength
             "difficulty": 9, # High difficulty
             "success": 59, # Hero's Victory
             "failure": 60 # Darkness Prevails
@@ -1058,77 +1133,89 @@ game_data = {
     },
     "57": { # Crystal Destruction Attempt
         "title": "Crystal Destruction",
-        "content": """<p>Recognizing the true source of his power, you ignore the Evil Power Master and lunge toward the floating crystal. He shouts in alarm, desperately trying to stop you.</p>
-        <p>"No! Stay away from that, you fool! You have no idea what forces you're tampering with!"</p>
-        <p>As you get closer to the crystal, its energy intensifies, creating a barrier of dark magic that you must break through.</p>""",
+        "content": """<p>Recognizing the crystal as the true source of his overwhelming power, you feint an attack and then lunge towards the malevolently pulsing gem floating above the throne. The Evil Power Master shouts in alarm and fury, desperately trying to intercept you.</p>
+        <p>"No! Stay away from that, you insignificant fool! You have no conception of the forces you're tampering with!"</p>
+        <p>As you get closer, the crystal's energy intensifies dramatically, throwing up a shimmering barrier of pure dark magic that you must break through to reach it.</p>""",
         "challenge": {
             "title": "Breaking the Crystal Barrier",
-            "description": "You must overcome the crystal's protective magic to reach and destroy it.",
-            "stat": "wisdom", # Wisdom check
+            "description": "You must overcome the crystal's protective magic using wit, willpower, or perhaps a specific counter-energy.",
+            "stat": "wisdom", # Primary check is Wisdom
             "difficulty": 8, # Slightly lower difficulty than direct fight
             "success": 61, # The Crystal Shatters
             "failure": 62 # A Desperate Gambit (leads to sacrifice ending)
         },
         "illustration": "crystal-barrier"
     },
+    "58": {
+         "title": "Attempt to Reason",
+         "content": """<p>You hold up a hand, trying to speak to the Evil Power Master, appealing to any possible reason or shred of humanity that might remain within the darkness. He pauses, then throws back his head and laughs – a chilling, hollow sound.</p>
+         <p>"Humanity? Reason? Such fleeting, petty concerns! Power is the only truth, the only reason! And soon, I shall have ultimate power!" he snarls, launching a devastating bolt of dark energy directly at you.</p>
+         <p>Clearly, negotiation was never an option.</p>""",
+         "options": [
+             { "text": "Attack the Evil Power Master directly", "next": 56 },
+             { "text": "Try to destroy the crystal", "next": 57 }
+         ],
+         "illustration": "final-confrontation"
+    },
     "59": {
         "title": "A Hero's Victory",
-        "content": """<p>Through sheer determination and skill, you manage to overcome the Evil Power Master's defenses. As he staggers backwards from your decisive blow, his connection to the crystal weakens momentarily.</p>
-        <p>Seizing the opportunity, you strike the crystal with all your remaining strength. It cracks, then shatters in a blinding flash of light and energy.</p>
-        <p>The Evil Power Master screams as his power dissipates. "Impossible! I was so close to ultimate power!"</p>
-        <p>As the light fades, you stand victorious. The land will heal from his corruption, and the people are free once more.</p>""",
+        "content": """<p>Through sheer determination, skill, and perhaps exploiting a momentary weakness, you manage to overcome the Evil Power Master's formidable defenses. As he staggers backwards from your decisive blow, his concentration wavers, and his connection to the crystal weakens for a critical instant.</p>
+        <p>Seizing the opportunity, you strike the dark crystal with all your remaining might (or perhaps channel pure energy into it). It cracks visibly, then shatters in a blinding flash of light and concussive energy that throws you back.</p>
+        <p>The Evil Power Master screams a final, agonized cry as his borrowed power dissipates like smoke. "Impossible! I was... so close... to ultimate power!"</p>
+        <p>As the blinding light fades, you stand victorious amidst the crumbling chamber. The dark magic recedes from the land, and the people are free once more.</p>""",
         "gameOver": True,
-        "ending": "You've defeated the Evil Power Master and destroyed the source of his power. Songs will be sung of your bravery for generations to come. The land begins to heal, and you are hailed as a hero throughout the realm.",
+        "ending": "You have defeated the Evil Power Master and destroyed the source of his terrible power. Songs will be sung of your bravery and skill for generations to come. The land slowly begins to heal from his corruption, and you are hailed as the Hero of Silverhold throughout the recovering realm.",
         "illustration": "hero-victory"
     },
     "60": {
         "title": "Darkness Prevails",
-        "content": """<p>Despite your best efforts, the Evil Power Master's power is too great. His dark magic overwhelms your defenses, bringing you to your knees.</p>
-        <p>"Valiant, but futile," he says, looking down at you. "You could have joined me, you know. Now you'll witness my ascension to godhood before your end."</p>
-        <p>As your vision fades, you see the crystal's glow intensifying. You've failed, and darkness will soon cover the land.</p>""",
+        "content": """<p>Despite your bravery and best efforts, the Evil Power Master's command over dark magic, amplified by the crystal, is simply too great. His relentless attacks overwhelm your defenses, shattering your weapon or shield, and bringing you crashing to your knees.</p>
+        <p>"Valiant, perhaps, but ultimately futile," he says, looking down at you with cold contempt. "You could have served me, you know. Gained power beyond your imagining. Now... you will simply serve as a warning." He raises a hand, dark energy coalescing.</p>
+        <p>As your vision fades into darkness, you see the crystal's evil glow intensifying, the alignment reaching its peak. You have failed. Darkness will cover the land, and the Master's reign is absolute.</p>""",
         "gameOver": True,
-        "ending": "The Evil Power Master was too powerful, and your quest ends in defeat. Darkness spreads across the land as he completes his ritual and ascends to even greater power. Perhaps another hero will rise in the future to challenge his reign.",
+        "ending": "The Evil Power Master proved too powerful, and your heroic quest ends in tragic defeat. Darkness spreads unchallenged across the land as he completes his ritual and ascends to even greater, terrifying power. Hope fades, but perhaps, someday, another hero will rise to challenge his eternal reign.",
         "illustration": "dark-victory"
     },
     "61": {
         "title": "The Crystal Shatters",
-        "content": """<p>Drawing on all your wisdom and willpower, you break through the crystal's barrier. Reaching out, you touch its surface, which burns cold against your skin.</p>
-        <p>The Evil Power Master shrieks in desperation, "Stop! You'll doom us all!"</p>
-        <p>With a final effort, you channel your energy into the crystal. Cracks appear across its surface, spreading rapidly until it shatters with a deafening explosion of light and sound.</p>
-        <p>When your vision clears, the Evil Power Master lies defeated, his power broken along with the crystal. Peace can now return to the land.</p>""",
+        "content": """<p>Drawing on all your wisdom and inner willpower (or perhaps using a specific magical counter), you manage to push through the crystal's defensive barrier. Reaching out, you touch its vibrating surface, which burns with an unnatural cold against your skin.</p>
+        <p>The Evil Power Master shrieks in mingled fury and desperation, "Stop! Stop, you fool! You'll doom us all!"</p>
+        <p>With a final, concentrated effort, you channel your own life force or focused energy into the dark gem. Cracks spiderweb across its obsidian surface, spreading rapidly until it detonates with a deafening implosion of light and sound, sucking the dark energy from the room.</p>
+        <p>When your vision clears, the Evil Power Master lies broken and powerless on the floor, his power utterly broken along with the crystal. The oppressive atmosphere lifts, and peace can finally begin to return to the land.</p>""",
         "gameOver": True,
-        "ending": "By destroying the source of the Evil Power Master's strength, you've saved the realm from his tyranny. The fortress begins to crumble as its dark magic fades, but you escape to tell the tale. Your name becomes legend throughout the land.",
+        "ending": "By cleverly targeting and destroying the source of the Evil Power Master's augmented strength, you have saved the realm from his tyranny. The fortress itself begins to shake and crumble as its dark magic foundations unravel. You escape just in time, leaving the ruin behind. Your name becomes a legend associated with wisdom and decisive action.",
         "illustration": "crystal-destroyed"
     },
     "62": {
         "title": "A Desperate Gambit",
-        "content": """<p>The crystal's barrier proves too strong, repelling your attempts to break through. As you struggle against it, the Evil Power Master regains his composure and approaches.</p>
-        <p>"Did you really think it would be that easy?" he mocks. "The crystal has existed for millennia. It cannot be destroyed by someone like you."</p>
-        <p>In a final, desperate move, you use all your remaining strength to hurl your most powerful weapon or spell at the crystal.</p>
-        <p>To your surprise and the Evil Power Master's horror, this creates a resonance effect. The crystal begins to vibrate violently, its energy becoming unstable.</p>
-        <p>"What have you done?" he cries as the crystal's energy spirals out of control, engulfing both of you in blinding light.</p>""",
+        "content": """<p>The crystal's protective barrier proves too strong, violently repelling your attempts to break through. As you struggle against its crushing force, the Evil Power Master regains his composure and approaches, a cruel smile playing on his lips.</p>
+        <p>"Did you truly think it would be that easy?" he mocks, preparing a final, devastating spell. "This crystal has endured for millennia. It cannot be destroyed by a pathetic mortal like you."</p>
+        <p>Seeing no other option, in a final, desperate move, you gather all your remaining strength and hurl your most powerful weapon or focus your strongest spell directly at the unstable crystal.</p>
+        <p>To your surprise and the Evil Power Master's horror, this doesn't break the barrier but instead creates a catastrophic resonance effect within the overloaded gem. The crystal begins to vibrate violently, its contained energy spiraling wildly out of control.</p>
+        <p>"What have you done?!" the Master cries in terror as the crystal's energy erupts outwards, engulfing both of you, the chamber, and the entire tower top in blinding, destructive light.</p>""",
         "gameOver": True,
-        "ending": "Your desperate attack destabilized the crystal, causing a catastrophic release of energy that destroyed the Evil Power Master and his fortress. Though you didn't survive, your sacrifice saved the realm from darkness. Bards sing of your heroism for generations to come.",
+        "ending": "Your desperate, final attack destabilized the dark crystal, causing a catastrophic release of uncontrolled energy that utterly annihilated the Evil Power Master, his chamber, and tragically, yourself. Though you did not survive, your ultimate sacrifice shattered his power and saved the realm from imminent darkness. Bards will forever sing of your selfless heroism.",
         "illustration": "heroic-sacrifice"
     }
 }
 
+
 # --- Item Data ---
 items_data = {
-    "Flaming Sword": {"type": "weapon", "description": "A sword wreathed in magical fire. +3 Attack.", "attackBonus": 3},
-    "Whispering Bow": {"type": "weapon", "description": "A bow that fires silent arrows. +2 Attack.", "attackBonus": 2},
-    "Guardian Shield": {"type": "armor", "description": "A sturdy shield blessed with protective magic. +2 Defense.", "defenseBonus": 2},
-    "Healing Light Spell": {"type": "spell", "description": "A spell that can mend minor wounds."},
-    "Shield of Faith Spell": {"type": "spell", "description": "A spell that creates a temporary magical shield."},
-    "Binding Runes Scroll": {"type": "spell", "description": "A scroll containing runes to temporarily bind an enemy."},
-    "Secret Tunnel Map": {"type": "quest", "description": "A map marking a hidden entrance to the fortress."},
-    "Poison Daggers": {"type": "weapon", "description": "Daggers coated with a fast-acting poison. +1 Attack.", "attackBonus": 1},
-    "Master Key": {"type": "quest", "description": "A key said to unlock any non-magical lock."},
-    "Water Spirit's Blessing": {"type": "spell", "description": "A blessing from the river spirit, enhancing wisdom."},
-    "Ancient Amulet": {"type": "quest", "description": "An amulet radiating ancient protective magic. +1 Defense.", "defenseBonus": 1},
-    "Guard Disguise": {"type": "quest", "description": "A uniform worn by the fortress guards."},
-    "Healing Potion": {"type": "consumable", "description": "A potion that restores some health."}, # Placeholder
-    "Resistance Ally": {"type": "quest", "description": "A brave resistance fighter accompanying you."}, # Placeholder
+    "Flaming Sword": {"type": "weapon", "description": "A sword wreathed in magical fire. Looks dangerous to friend and foe. +3 Attack.", "attackBonus": 3},
+    "Whispering Bow": {"type": "weapon", "description": "A finely crafted bow enchanted for silence. Favored by assassins. +2 Attack.", "attackBonus": 2},
+    "Guardian Shield": {"type": "armor", "description": "A sturdy shield blessed with protective magic. Glows faintly. +2 Defense.", "defenseBonus": 2},
+    "Healing Light Spell": {"type": "spell", "description": "A basic clerical spell that can mend minor wounds."},
+    "Shield of Faith Spell": {"type": "spell", "description": "A protective spell that creates a temporary shimmering barrier."},
+    "Binding Runes Scroll": {"type": "spell", "description": "A scroll containing complex runes to temporarily immobilize an enemy."},
+    "Secret Tunnel Map": {"type": "quest", "description": "A crudely drawn map marking a hidden tunnel entrance near the fortress's north wall."},
+    "Poison Daggers": {"type": "weapon", "description": "A pair of wicked-looking daggers coated with a fast-acting paralytic poison. +1 Attack.", "attackBonus": 1},
+    "Master Key": {"type": "quest", "description": "A heavy iron key with intricate wards. Said to unlock any non-magical lock."},
+    "Water Spirit's Blessing": {"type": "spell", "description": "A lingering blessing from the river spirit, enhancing clarity and insight."},
+    "Ancient Amulet": {"type": "quest", "description": "A heavy stone amulet radiating ancient protective magic. Seems to resist dark energy. +1 Defense.", "defenseBonus": 1},
+    "Guard Disguise": {"type": "quest", "description": "A slightly ill-fitting uniform worn by the fortress guards."},
+    "Healing Potion": {"type": "consumable", "description": "A vial containing a sparkling red liquid. Restores 10 HP.", "hpRestore": 10, "useOnAdd": True}, # Added HP restore value and use flag
+    "Resistance Ally": {"type": "quest", "description": "Kaelen, a grim resistance fighter armed with a blessed axe, fights alongside you."}, # Added name
 }
 
 # --- Enemy Data ---
@@ -1136,69 +1223,72 @@ enemies_data = {
     "Scout": {"hp": 15, "attack": 4, "defense": 1},
     "Dark Mage": {"hp": 20, "attack": 6, "defense": 2},
     "Fortress Guard": {"hp": 25, "attack": 5, "defense": 3},
-    # Add more enemies as needed
+    "Shadow Hound": {"hp": 18, "attack": 5, "defense": 2},
+    "Animated Armor": {"hp": 30, "attack": 4, "defense": 4},
 }
 
 
 # --- SVG templates for illustrations ---
 # Helper function for placeholder SVGs
 def create_placeholder_svg(text="Placeholder", color="#cccccc"):
+    # Basic SVG with a rectangle and centered text
     return f"""<svg viewBox="0 0 200 100" xmlns="http://www.w3.org/2000/svg" width="100%" height="100%">
-                 <rect width="200" height="100" fill="{color}" />
+                 <rect width="200" height="100" fill="{color}" rx="5" ry="5"/>
                  <text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-family="monospace" font-size="14px" fill="#000">{text}</text>
+                 Sorry, your browser does not support inline SVG.
                </svg>"""
 
 illustrations = {
     "default": create_placeholder_svg("Default Scene", "#aaaaaa"),
     "game-over": create_placeholder_svg("Game Over", "#ffaaaa"),
     "city-gates": """
-        <svg viewBox="0 0 400 250" xmlns="http://www.w3.org/2000/svg">
-            <rect x="0" y="0" width="400" height="150" fill="#6b88a2" />
-            <rect x="0" y="150" width="400" height="100" fill="#7d6c54" />
-            <rect x="50" y="50" width="300" height="100" fill="#c9c0a8" />
-            <rect x="150" y="80" width="100" height="120" fill="#5a3c28" />
-            <rect x="195" y="80" width="10" height="120" fill="#3a281e" />
-            <rect x="50" y="30" width="40" height="120" fill="#d6cdb7" />
-            <rect x="310" y="30" width="40" height="120" fill="#d6cdb7" />
-            <polygon points="50,30 70,10 90,30" fill="#bf9969" />
-            <polygon points="310,30 330,10 350,30" fill="#bf9969" />
-            <path d="M150,250 C 170 220, 230 220, 250 250 Z" fill="#a89783" /> 
-            <line x1="200" y1="200" x2="200" y2="250" stroke="#a89783" stroke-width="100" />
-            <rect x="70" y="10" width="2" height="20" fill="#222" />
-            <rect x="72" y="10" width="10" height="5" fill="#bf2121" />
-            <rect x="330" y="10" width="2" height="20" fill="#222" />
-            <rect x="332" y="10" width="10" height="5" fill="#bf2121" />
-        </svg>
+<svg viewBox="0 0 200 125" xmlns="http://www.w3.org/2000/svg" width="100%" height="100%">
+  <rect width="200" height="75" fill="#87CEEB" />
+  <rect y="75" width="200" height="50" fill="#8B4513" />
+  <rect x="25" y="25" width="150" height="50" fill="#A9A9A9" stroke="#696969" stroke-width="1"/>
+  <rect x="25" y="15" width="20" height="60" fill="#A9A9A9" stroke="#696969" stroke-width="1"/>
+  <rect x="155" y="15" width="20" height="60" fill="#A9A9A9" stroke="#696969" stroke-width="1"/>
+  <path d="M 25 25 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 Z" fill="#A9A9A9" stroke="#696969" stroke-width="0.5"/>
+  <path d="M 25 15 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 Z" fill="#A9A9A9" stroke="#696969" stroke-width="0.5"/>
+  <path d="M 155 15 h 5 v -5 h 5 v 5 h 5 v -5 h 5 v 5 Z" fill="#A9A9A9" stroke="#696969" stroke-width="0.5"/>
+  <rect x="75" y="40" width="50" height="60" fill="#654321" />
+  <path d="M 75 40 Q 100 30 125 40 Z" fill="#654321"/>
+  <rect x="98" y="40" width="4" height="60" fill="#402000" />
+  <circle cx="90" cy="70" r="2" fill="#402000" />
+  <circle cx="110" cy="70" r="2" fill="#402000" />
+  <path d="M 75 125 Q 100 100 125 125 Z" fill="#A0522D" />
+  <path d="M 75 100 L 125 100 L 100 75 Z" fill="#A0522D" opacity="0.5"/>
+   <line x1="35" y1="0" x2="35" y2="15" stroke="black" stroke-width="1"/>
+  <polygon points="35,0 45,5 35,10" fill="#DC143C"/>
+  <line x1="165" y1="0" x2="165" y2="15" stroke="black" stroke-width="1"/>
+  <polygon points="165,0 175,5 165,10" fill="#DC143C"/>
+</svg>
     """,
     "weaponsmith": """
-        <svg viewBox="0 0 400 250" xmlns="http://www.w3.org/2000/svg">
-            <rect x="0" y="0" width="400" height="250" fill="#3d3123" />
-            <rect x="250" y="100" width="100" height="70" fill="#8c5b3f" />
-            <rect x="270" y="120" width="60" height="30" fill="#e63d16" />
-            <ellipse cx="300" cy="135" rx="25" ry="10" fill="#f7d046" />
-            <rect x="180" y="160" width="40" height="20" fill="#888888" />
-            <rect x="190" y="150" width="20" height="10" fill="#999999" />
-            <rect x="195" y="140" width="10" height="10" fill="#aaaaaa" />
-            <line x1="50" y1="60" x2="90" y2="70" stroke="#c0c0c0" stroke-width="4" />
-            <line x1="120" y1="50" x2="150" y2="70" stroke="#c0c0c0" stroke-width="3" />
-            <rect x="60" y="90" width="30" height="80" fill="#814d2b" />
-            <rect x="65" y="90" width="20" height="5" fill="#c0c0c0" />
-            <rect x="140" y="90" width="5" height="100" fill="#814d2b" />
-            <ellipse cx="142.5" cy="90" rx="15" ry="3" fill="#c0c0c0" />
-            <rect x="30" y="180" width="120" height="10" fill="#8c5b3f" />
-            <circle cx="220" cy="120" r="25" fill="#d8a77a" />
-            <rect x="210" y="145" width="20" height="35" fill="#603813" />
-            <rect x="205" y="110" width="30" height="20" fill="#d8a77a" />
-            <circle cx="213" cy="115" r="3" fill="#000" />
-            <circle cx="227" cy="115" r="3" fill="#000" />
-            <path d="M215,125 Q220,130 225,125" fill="none" stroke="#000" stroke-width="1" />
-            <rect x="60" y="60" width="10" height="30" fill="#603813" />
-            <rect x="62" y="30" width="6" height="30" fill="#ff5722" opacity="0.7">
-                <animate attributeName="opacity" values="0.7;1;0.7" dur="2s" repeatCount="indefinite" />
-            </rect>
-            <rect x="130" y="50" width="6" height="40" fill="#603813" />
-            <ellipse cx="133" cy="50" rx="15" ry="3" fill="#c0c0c0" /> 
-        </svg> 
+<svg viewBox="0 0 200 125" xmlns="http://www.w3.org/2000/svg" width="100%" height="100%">
+  <rect width="200" height="125" fill="#6B4226"/>
+  <rect x="125" y="50" width="50" height="35" fill="#8B4513"/>
+  <rect x="135" y="60" width="30" height="15" fill="#FF4500"/>
+  <ellipse cx="150" cy="67.5" rx="12.5" ry="5" fill="#FFD700" opacity="0.8"/>
+  <path d="M 90 80 L 110 80 L 115 75 L 105 70 L 95 70 L 85 75 Z" fill="#708090"/>
+  <rect x="95" y="80" width="10" height="10" fill="#778899"/>
+  <line x1="25" y1="30" x2="45" y2="35" stroke="#C0C0C0" stroke-width="2"/> <line x1="60" y1="25" x2="75" y2="35" stroke="#A0522D" stroke-width="1.5"/> <polygon points="75,35 78,33 80,35 78,37" fill="#C0C0C0"/> <path d="M 30 45 C 35 40, 45 40, 50 45 L 50 85 L 30 85 Z" fill="#808080"/> <circle cx="40" cy="65" r="3" fill="#696969"/> <line x1="70" y1="45" x2="70" y2="85" stroke="#A0522D" stroke-width="1.5"/>
+   <path d="M 65 45 Q 70 40, 75 45 Q 80 55, 70 60 Z" fill="#C0C0C0"/>
+  <rect x="15" y="90" width="60" height="5" fill="#8B4513"/>
+  <rect x="20" y="95" width="5" height="10" fill="#8B4513"/>
+  <rect x="65" y="95" width="5" height="10" fill="#8B4513"/>
+  <circle cx="110" cy="60" r="12.5" fill="#DEB887"/> <rect x="100" y="72.5" width="20" height="17.5" fill="#A0522D"/> <rect x="95" y="70" width="30" height="10" fill="#D2691E"/> <circle cx="106.5" cy="57.5" r="1.5" fill="#000"/> <circle cx="113.5" cy="57.5" r="1.5" fill="#000"/> <path d="M 107.5 62.5 Q 110 65 112.5 62.5" fill="none" stroke="#000" stroke-width="0.5"/> <rect x="115" y="70" width="10" height="3" fill="#808090"/>
+   <rect x="118" y="73" width="4" height="15" fill="#A0522D"/>
+  <line x1="20" y1="90" x2="20" y2="75" stroke="#603813" stroke-width="2"/>
+   <line x1="18" y1="75" x2="22" y2="75" stroke="#603813" stroke-width="1"/>
+   <path d="M 20 75 L 19 70 L 20 65 L 21 70 Z" fill="#FF4500" opacity="0.7">
+      <animate attributeName="opacity" values="0.7;1;0.7" dur="1s" repeatCount="indefinite" />
+   </path>
+   <path d="M 40 90 C 35 80, 35 70, 40 60" stroke="#556B2F" stroke-width="1.5" fill="none"/>
+   <line x1="40" y1="90" x2="40" y2="60" stroke="#8FBC8F" stroke-width="0.5"/>
+   <path d="M 55 90 C 58 85, 62 85, 65 90 L 65 80 L 55 80 Z" fill="#B0C4DE" stroke="#708090" stroke-width="1"/>
+    <circle cx="60" cy="85" r="2" fill="#F0F8FF"/>
+</svg>
     """,
     # --- Add other placeholders ---
     "temple": create_placeholder_svg("Ancient Temple", "#fffde7"),
@@ -1239,7 +1329,6 @@ illustrations = {
     "heroic-sacrifice": create_placeholder_svg("Heroic Sacrifice", "#ffcc80"),
 
 }
-
 </gradio-file>
 
         </gradio-lite>