PipBoyBridge (Phase 1)

This bridge is split into two parts:

• Lua addon (Interface/AddOns/PipBoyBridge) samples position and writes JSON files with ExportFile.
• DLL (PipBoyBridge.dll) runs in the game process, hosts a UDP endpoint, and broadcasts position updates to subscribers.

Runtime Files

The addon writes the following files into WoW's imports/ folder:

• pipboy_ctrl.json: bridge control (enabled, bind_ip, bind_port)
• pipboy_pos.json: latest position payload

The DLL reads these files and sends packets to clients that register with hello.

UDP Protocol

Client -> server:

{"type":"hello","proto":1,"client":"pipboy-test","want":"pos"}

Server -> client:

{"type":"hello_ack","proto":1,"server":"pipboy-bridge","tick_hz":10}

Position stream:

{"type":"pos","ts":123456,"player":"Name","map":"Elwynn","zone":"Elwynn Forest","x":0.1,"y":0.2,"hp":1000,"hp_max":1200,"level":30}

Optional discovery:

{"type":"discover","proto":1}

Response:

{"type":"discover_ack","proto":1,"server":"pipboy-bridge","port":38442}

Build

./pipboybridge/build.sh

Integrate

1. Ensure PipBoyBridge.dll exists in the WoW root directory.
2. Add PipBoyBridge.dll to dlls.txt.
3. Enable the PipBoyBridge addon in-game.
4. Use /pipboy status to verify settings.