Skip to content

Lich 5 Integration

monil2233 edited this page Jun 10, 2026 · 2 revisions

Lich 5 Integration

Lich 5 is a Ruby proxy engine for Simutronics games. It runs on top of a front-end client like Genie — it is not a competing client. Genie 5 is designed to work cleanly behind Lich, so your Lich scripts and Genie's own features coexist.

Genie 5 and Lich 5 are both GPL-3.0, deliberately aligning Genie with the broader DragonRealms tooling ecosystem.

Two ways to combine them

1. Lich proxy mode

Lich authenticates and connects to DragonRealms, then exposes a local game stream that Genie connects to.

  1. Start Lich 5 the way you normally do, so it logs in and listens locally (its default is 127.0.0.1:8000).
  2. In Genie, File → Connect… and choose Lich Proxy.
  3. Point it at Lich's host/port (127.0.0.1:8000 by default) and connect.

Genie receives a clean DragonRealms stream and renders it normally. Your Lich Ruby scripts keep running underneath — Genie simply sees their output as ordinary game text. You get Lich's automation plus Genie's UI, mapper, highlights, and .cmd scripts at the same time.

2. Direct login with Lich alongside

Genie can handle authentication itself (no Lich required) while you still run Lich-managed automation in parallel through Lich's own command channel. Use this when you want Genie to own the connection but still lean on specific Lich scripts.

Three script ecosystems, side by side

Genie 5 is built so all three of DragonRealms' scripting worlds coexist:

Ecosystem Language How Genie sees it
Native scripts Genie .cmd (Wizard dialect) Run directly by Genie's script engine.
Lich scripts Ruby (.rb) Run by Lich behind the proxy; transparent to Genie.
Plugins 🚧 .NET DLLs Loaded by Genie's plugin host.

You can mix them: a Lich script can be doing one thing while a Genie .cmd script and a highlight rule do others.

Notes & current limits

  • Manual Lich launch. Genie 5 doesn't auto-start Lich for you yet — start Lich first, then connect Genie to it. (Auto-launch is a possible future convenience.)
  • Policy still applies. Running behind Lich doesn't change DragonRealms' Scripting Policy. The responsiveness expectation in Policy Compliance applies to whatever automation you run, in either tool.

Related

Clone this wiki locally