What this is

The relay host engine. It advertises a tower-emulator the official companion app connects to (TowerEmulator), decodes every 20-byte command, broadcasts it to consumers (RelayServer), synthesizes the tower→app return traffic (NotificationSynthesizer), and can mirror a real master tower (RealTower) or replay canned data (MockTower). Also bundles the append-only EventLog, logging, and log-analysis helpers.

Building a consumer (visualizer, companion app)? You want the ultimatedarktowerrelay-client SDK, not this. This package is for running or embedding the host.

This is a Node package: it depends on @stoprocent/bleno for BLE peripheral mode (with @stoprocent/noble as an optional dependency for the real-tower central path). The companion app gates on the Device Information Service, which macOS cannot expose in peripheral mode — so a standalone emulator host needs Linux / Raspberry Pi or Windows. See SETUP.md.

Install

npm install ultimatedarktowerrelay-core

Usage

import { TowerEmulator, RelayServer } from 'ultimatedarktowerrelay-core';

For a ready-to-run daemon, see the CLI and Electron operator console in the main repo.

Documentation

• Architecture · Tower emulator behavior
• Per-platform setup · Troubleshooting
• Project overview: UltimateDarkTowerRelay

License

MIT. Unofficial, fan-made project; Return to Dark Tower is © Restoration Games.