FAQ

General

What is VellumFE? A modern, multi-frontend client for GemStone IV built in Rust — terminal (TUI), desktop GUI, mobile web, and Android/iOS apps, all driving the same core. DragonRealms is supported by the parser and connection layer but less battle-tested.

Do I need Lich? No. VellumFE can connect through Lich (recommended, for scripting) or directly via eAccess with --direct. VellumFE itself doesn’t run scripts — use Lich for that.

Can I play without a PC at all? Yes — the Android or iOS app runs the whole client on your phone, or run --frontend headless on any machine and play from a browser. They connect via direct eAccess, or — for scripted characters — the login screen’s Lich tab attaches to a Lich session running on another machine (Lich itself never runs on the phone). See Mobile Web.

Is it free? Yes, open source: github.com/Nisugi/VellumFE.

Connection

How do I connect via Lich? Start Lich, then vellum-fe --port 8000 --character Name. VellumFE identifies as Stormfront to Lich, so scripts behave as they would under Wrayth. See First Launch.

Can I save my login credentials? Yes — use the Launcher: its “Save password” option stores the password in your OS’s secure credential store (keyring), never in a file. Storing a password in config.toml’s [connection] section also works but is plain text; if you store nothing, VellumFE prompts at startup.

Configuration

Where are config files stored? ~/.vellum-fe/ on every platform (Windows: C:\Users\you\.vellum-fe\). Override with --data-dir or the VELLUM_FE_DIR environment variable. See Configuration for the directory layout.

Can I have per-character settings? Yes — files in profiles/<name>/ override the global ones when you launch with --character (or --profile).

Can I have multiple layouts? Yes: .savelayout hunting, then .loadlayout hunting — in both the TUI and the GUI (each keeps its own set).

How do I reset to defaults? Delete the file (or the whole ~/.vellum-fe/ directory); defaults are recreated on next launch.

Features

Does VellumFE support macros? Two kinds: keyboard macros in keybinds.toml (f5 = { macro_text = "stance defensive\r" }), and tap-button macros for the phone in macros.toml.

Sound alerts? Yes — add sound = "alert.wav" to any highlight. See Sound Alerts.

Text-to-speech? Yes — set enabled = true in config.toml’s [tts] section. Navigation and volume/rate keys are in keybinds.toml.

Can I hide spammy lines? Yes — squelch = true on a highlight pattern. See highlights.toml.

Can I import my Wrayth highlights? Yes: vellum-fe import-highlights settings.xml. See the CLI Reference.

Where can I get help or show off my setup? The VellumFE Discord — help, bug reports, layout/skin/wheel showcases, beta testing, and release announcements. GitHub issues work too.