Progress on documentation

rooms/kq4-008-back-of-fishermans-shack/kq4-008-back-of-fishermans-shack.md

@@ -0,0 +1,53 @@
+# Room 8: Back of Fisherman's Shack
+
+This room is located behind the fisherman's shack (room 7). It is a peaceful meadow area with wildflowers. The player can view the back of the cottage, interact with windows (look through, try to open or break), and access other areas (north to room 2, south to room 14, east to room 9, west to room 7).
+
+## Look Description
+
+"A beautiful green meadow, dotted with wildflowers, serves as the fisherman's spacious back yard. The flowers' sweet scent fills the air." (Print 8 5)
+
+## Interactions
+
+| Status | Behavior Type | Command | Response |
+|--------|--------------|---------|----------|
+| TODO | Look | `look[<around]/room` `look[<around]` | "A beautiful green meadow, dotted with wildflowers, serves as the fisherman's spacious back yard. The flowers' sweet scent fills the air." (Print 8 5) |
+| TODO | Look | `look/cottage` | "You see the back of an old shack." (Print 8 4) |
+| TODO | Look | `look/door` | "You can't see the door from here." (Print 8 0) |
+| TODO | Look | `look/window` (when in position to see through) | "You peek through the window, but can make out no details." (Print 8 3) |
+| TODO | Look | `look/window` (when not in position) | "You're not close enough." (Print 800 1) |
+| TODO | Action | `open/window` | "The windows do not open." (Print 8 1) |
+| TODO | Action | `break/window` | "That's vandalism!" (Print 8 2) |
+
+## Scripts
+
+| Status | Behavior Type | Name | Trigger | Behavior |
+|--------|--------------|------|---------|----------|
+| TODO | Background | Region 506 | Continuous | Unknown region interaction - additional interactions may be defined in region script |
+| TODO | Background | Region 514 | Continuous | Unknown region interaction - additional interactions may be defined in region script |
+
+## Technical Notes
+
+- **Room Number**: 8
+- **Picture**: 8
+- **Region**: 506, 514 (setRegions)
+- **Exits**: north → 2, south → 14, east → 9, west → 7
+- **Horizon**: 68
+- **Overlay**: 108 (applied when global100 = 1)
+
+### State Variables
+
+| Variable | Values | Description |
+|----------|--------|-------------|
+| `global101` | 0 | Unknown - set to 0 on room init |
+| `global100` | 0, 1 | Door lock state from previous room - controls overlay 108 |
+| `global160` | varies | Hour from system time (used in newRoom for actor position transfer) |
+| `global159` | varies | Minute from system time |
+| `global211` | varies | Transferred to global160 when leaving room |
+| `global212` | varies | Transferred to global159 when leaving room |
+
+### Special Mechanics
+
+- **Window Interaction**: Can only look through window when in position (rect 10-57, 134-140).
+- **Door Visibility**: Door is not visible from this side of the cottage.
+- **Overlay System**: Room uses overlay 108 when global100 = 1 (likely indicating the door is locked).
+- **Actor Transfer**: When leaving room (if gNewAct_5 exists in cast), global160 and global159 are transferred to global211 and global212 for use in the destination room.