Updated level creation documentation. Fixed a couple bugs in weapon overrides.

levels/README.md

@@ -422,6 +422,33 @@ Override weapon sounds and names globally for an entire level:
 - `attack_sound`: Sound played when attacking
 - `hit_sound`: Sound played when hitting an enemy
 
+**Weapon Override Persistence:**
+Weapon overrides set in **level 1** automatically persist throughout the entire level pack! You only need to define `weapon_sound_overrides` in your first level (1.json) and all subsequent levels will inherit these themed weapon names.
+
+```json
+// In levels/Wicked Christmas/1.json - Sets theme for entire pack
+{
+    "level_id": 1,
+    "weapon_sound_overrides": {
+        "rusty_shovel": { "name": "rusty snow shovel" },
+        "witch_broom": { "name": "decorated witch's broom" },
+        "nunchucks": { "name": "candy cane nunchucks" }
+    }
+}
+
+// In levels/Wicked Christmas/2.json - No overrides needed!
+{
+    "level_id": 2,
+    // Weapons automatically use themed names from level 1
+}
+```
+
+**How it works:**
+- Level 1 overrides persist across all levels in the same play session
+- Switching to a different level pack resets weapons to their original names
+- Later levels can still override weapons if you want to change themes mid-pack
+- The system stores the original weapon names internally for proper lookups
+
 #### Object Sound Overrides
 
 Override sounds for individual objects in your level: