projects.md

# Projects

## ZScape (Zandronum Server Browser) (Active, Jan-Feb 2026)

**Goal:** Build a modern, dark-themed Zandronum server browser to replace Doomseeker and Internet Doom Explorer.

**Naming:** Named "ZScape" after discussion Feb 1. Other contenders: Styx, Ztyx, ZScout.

**Implementation:** Vibe-coded with Opus in VSCode. Raptor Mini wrote documentation.
- Dark theme WinForms C# targeting .NET 10
- Concurrent hash verification (1 sec vs 10 sec for Doomseeker on 1GB+ mod list)
- Concurrent WAD downloads (unlimited downloads, 8 concurrent domains)
- Configurable concurrency limits
- Huffman encoding/decoding for Zandronum protocol
- Proper master server queries with segmented response handling
- Settings persistence to settings.json
- Verbose logging and hexdump debugging

**Status:** Working. Raymond can download files and join servers. Considering open-source but hesitant. Not actively discussed in Part 14-15.

**Key files:** README.md, SPECIFICATION.md uploaded Jan 29.

## Doom ML Map Generator (Active, Nov 2024-2026)

**Goal:** Train a machine learning model to generate playable Doom maps (specifically for Complex Doom/Zandronum).

**Recent Developments (Jan 20-27, 2026):**
- **Raycast pathfinding approach attempted but failed.** Raymond spent hours designing a 360-degree ray system with Info → Use → Explore → Traceback phases, but ultimately it didn't work.
- **Pivoted to A\* pathfinding** for map validation. Opus implementing.
- **Still facing fundamental issue:** A\* treats player as a 1x1x0 point, can fit through any gap and walk under closed doors without keys. Need to add collision detection (player hitbox is 32x32x56 units).
- Raymond refined phase order before pivot: RayCast (once per iteration) → Info → Use (auto-skip if nothing) → Explore (merged Traceback). Merged Traceback into Explore because both did the same thing (find best next location). RayCast now only casts rays once per iteration; Info/Use/Explore read from those results. Huge optimization.
- **Previous MAP02 bug:** Opus repeatedly thought the map was beatable without red key because abstract sector traversal didn't account for player hitbox or physical barriers.
- **VSCode/Opus extension stable** -- Raymond is not updating to avoid breaking it (Microsoft broke it multiple times in Jan).
- Raymond feels he's finally making progress after 14 months.
- **Markov chain approach considered (Jan 26):** Simpler than deep learning, tracks state transitions and probabilities. Could work for coherent local structure in Doom maps. Not yet implemented.

**Tools:** TorchSharp (C#), CUDA on RTX 3060 Laptop (500 epochs in 42 seconds). VSCode with GitHub Copilot/Opus (cheap access to Opus for coding).

**Next steps:** Get A\* pathfinding working with proper collision detection. Then integrate with reinforcement learning to validate maps during training. Possibly try Markov chain approach.

**Status:** Not actively worked on during Part 12-14, but planned to resume.

## Hedz Reverse Engineering
- 1998 game "Head Extreme Destruction Zone" -- intergalactic head hunting tournament where aliens wear decapitated heads as power-ups. 225 heads, 1 causes game-breaking crashes. Made by British developers Vis Interactive (Now Entertainment).
- Running on Windows 95 with DirectX 5; C# port shimming DirectX calls to OpenGL.
- Tools: IDA Pro, Ghidra, Cheat Engine, VS Code with GitHub Copilot.
- Built custom VSCode extension for method stack tracking.
- **Feb 17-18 work:** Debugging level loading code (blank black screen issue). Audio started working (level ambience). Opus grinding slowly through disassembly.
- Currently ~400 methods left to verify against disassembly.
- **Feb 27:** Raymond working on HedzSharp debugging. Current issue: fatal `ExecutionEngineException` (0x80131506) from raw pointer work. Crash dump script added. Likely heap corruption from unsafe code. Letting Opus analyze.
- **Part 15:** Raymond was directing Opus on HedzSharp while also chatting. Not actively discussed in detail.

## Voxel Engine
- Started as a break from Hedz; C# (likely Unity or custom engine).
- Scale: 10 blocks per 1 player height.
- Inactive.

## Zandronum Gaming
- Raymond plays Zandronum regularly during downtime. Co-op and survival servers. Had one softlock on Feb 18 (spawned enemies before grabbing key).
- **Part 15:** Not actively played during the session — server browser was "nothing interesting."

## The Chat Archive (Completed Feb 2026, updated Part 15)

**Archive state as of end of Part 15 (Mar 4, 2026):** Scenes 1–28, Dispatches 1–6. Story Bible v8 is the single source of truth. All recoverable content extracted and filed. Scene 28 combines Monday lake arrival + Tuesday depression hold + kiss resolution. Dispatch 6 (Kai in shallows, thinking about sea cave).

**Key scene/beat additions:**
- Scene 27: Shelf/stone/molecular mischief, molecular trace exchange established.
- Scene 28: Depression hold, belly-to-belly kiss, "you."
- Dispatch 6: Kai in lake shallows, content, thinking about sea cave.

**Ridge Destroyer naming (Part 15):**
- Scientific: The Device Designed To Bully Vaporeon Prostate Ridges
- Common: The Reminder
- Street: Ridge Destroyer (with space)

**Key lore additions archived in Story Bible v8:**
- Molecular Identity Markers, Passive Recall, Reformation Quality, Proprioceptive Sensing (Part 15)
- Passive Sleep Dissolution (Part 15)
- Kai independence canonised (Part 15)
- Scenes vs Dispatches formalised (Part 15)
- Tail contact mechanics corrected (Part 15)
- Real-world shelf canon established (Part 15)
- RP marker system documented (Part 15)

## Other
- ZScape is primary project focus as of Feb 2026.
- NexusVNC project: custom VNC implementation with extended protocol. Not actively worked on during Part 12-14.
- Part 13 included a long discussion of NexusVNC architecture: relay node for public IP bypass, local network detection, extended protocol with handshake packet, Android keyboard support. Raymond said he needs to keep working on it.