Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

VellumFE

Play GemStone IV in a client you can shape around your character — and be hunting in about five minutes.

Why you’d use it

You already know the game. What you want is a screen that tells you what you need mid-swing: vitals where your eye already goes, spells and effects visible without a SPELL check, thoughts and combat in their own windows instead of scrolling past you in one column.

VellumFE gives you that on one core with five ways to play — a terminal client, a native desktop window, your phone’s browser, an Android app, and an iPhone app. The same character, the same highlights, the same settings, whether you’re at your desk or on a couch.

And you configure all of it inside the client. Every feature ships an editor. Hand-editing a config file is a thing you may do, not a thing you have to do.

📷 screenshot pending
The Desktop GUI mid-hunt: main text left, vitals and roundtime along the bottom, active spells and the room's creatures docked right.

Get playing

Pick how you want to start. All three paths reach the same client.

  1. Download the release for your platform and extract it — see Installation.
  2. Double-click vellum-fe (vellum-fe.exe on Windows). Running it with no arguments opens the graphical launcher.
  3. Click ➕ New connection. Choose Lich if you launch through Lich (fill in host and port), or Direct to reach the game without Lich (fill in account, game world, and character).
  4. Tick Save password if you want it remembered — it goes into your OS credential store, never into a file.
  5. Click Save, then Launch.

Saved connections run the Desktop GUI unless you change Frontend under the connection’s Advanced fold.

Expected result: a native VellumFE window opens, connects, and your character’s room description scrolls into the main text window.

📷 screenshot pending
The launcher's connection list, with one Lich connection and one Direct connection, each showing its character and game world.

What you get

  • Windows you place. Drag any window where you want it, size it, and it stays there. Add windows for thoughts, deaths, ESP, or any game stream you care about — see Text Windows.
  • Highlights that do more than color. A rule can recolor a line, play a sound, rumble your controller, replace the text, send the line to a different window, or hide it outright. See Set up highlights and sound alerts.
  • Connect your way. Through Lich as a detachable client, or directly to play.net with no Lich running.
  • 36 built-in themes, ten of them accessibility variants — high-contrast (light and dark), deuteranopia, protanopia, tritanopia, monochrome, low-blue-light, photophobia, ADHD-focus, and reduced-motion.
  • Speech built in. Windows can read new lines aloud, so a thought or a death reaches you without a glance. See Speech.
  • Rebindable keys, hotbars of command buttons, and gamepad support.
  • Graphics on the desktop — skins, per-window frames, an injury doll, hand icons — with the terminal and phone rendering the same information as text.

Where your settings live

Everything lands under ~/.vellum-fe. Two layers matter:

  • global/ — settings shared by every character: highlights, keybinds, colors, hotbars, skins and images.
  • profiles/<character>/ — that one character’s overrides of any of the above, plus their layout, history, and log.

Point the whole thing somewhere else with --data-dir or the VELLUM_FE_DIR environment variable — handy for a portable install on a stick.

You change all of this in-app: type .settings for the settings editor, or .help for every command. The full list is in the Command Reference.

Where to go next

  • Getting Started — download, launcher, first connection.
  • How-To Guides — build a hunting layout, make vitals flash when you’re hurt, wire a combat hotbar.
  • Frontends — what each of the five can and can’t do.
  • Widgets — every window type, one page each.

Getting help

Config reference (TOML)

You do not need this to play — every file below has an in-app editor. It’s here for troubleshooting and for people who like to read their config.

Base directory: ~/.vellum-fe, overridden by --data-dir <DIR> or the VELLUM_FE_DIR environment variable.

PathHolds
launcher.tomlSaved launcher connections. Never contains passwords.
global/config.tomlShared settings: connection, UI, sound, speech, web server
global/highlights.tomlShared highlight, sound, squelch and redirect rules
global/keybinds.tomlShared key bindings
global/colors.tomlShared color palette, stream presets, spell colors
global/hotbars.tomlShared hotbar button definitions
global/controller.tomlGamepad binds, wheels, rumble, tuning (base layer)
global/macros.tomlMacro buttons for the phone/web client (a character’s own copy overrides it)
global/skins/One folder per skin, each with a skin.toml manifest
global/images/Shared art pool: icons, frames, dolls, compass, backgrounds, statusicons, hands
profiles/<character>/config.tomlThat character’s overrides
profiles/<character>/highlights.tomlThat character’s own highlight rules
profiles/<character>/keybinds.tomlThat character’s own key bindings
profiles/<character>/controller.tomlThat character’s gamepad overrides
profiles/<character>/layout.tomlAuto-saved layout for that character
profiles/<character>/history.txtCommand history
profiles/<character>/debug.logThat session’s log — the first place to look when something breaks
layouts/Named layouts from .savelayout, shared by all characters
highlights/Named highlight sets from .savehighlights
keybinds/Named keybind profiles
themes/Custom themes as <name>.toml, alongside the 36 built in

Files are written atomically, and the previous version is kept alongside as <name>.toml.bak — so a bad edit is one rename away from being undone.