Plugin_InventoryViewV5

The Inventory View plugin for Genie 5 — a port of Etherian's InventoryView (v1.8) for the Genie 5 platform.

It records what each of your characters owns — on their person, in a vault (if you have a vault book), a deed register, a home, and Trader storage — into a per-character tree saved to InventoryView.xml, and lets you search that catalog across all of your characters. Results render into the plugin's own Inventory View dock window:

Inventory catalog — 2 character(s), 214 items
──────────────────────────────────────
Renucci  (192 items)
  Inventory  (180)
    a darkened leather backpack
      a tarnished silver ring
      a small healing potion
    a woolen cloak
  Vault  (12)
    a reinforced iron strongbox
      a stack of documents

v2.1: handles the current DragonRealms INV LIST output, which sends the whole list as one long line (the per-item newlines are gone, but each item keeps its old leading indent). The scan re-splits that line into the proper item tree, and a catalog saved by an older version with merged entries is repaired automatically the next time the plugin loads. If a scanned tree ever looks flat, run /iv debug then /iv scan and watch the [IV dbg] trace.

Requirements

• .NET 8 SDK (to build).
• A Genie 5 install with the plugin system (host version ≥ 5.0).

Build

dotnet build -c Release

Output: bin/Release/net8.0/Plugin_InventoryViewV5.dll.

The project references the Genie 5 plugin contract (Genie.Plugins.Abstractions) from a committed copy in lib/, so no NuGet feed is required to compile.

Install

Copy Plugin_InventoryViewV5.dll into your Genie 5 plugins folder:

• Windows: %APPDATA%\Genie5\Plugins\
• macOS: ~/Library/Application Support/Genie5/Plugins/
• Linux: ~/.local/share/Genie5/Plugins/ (or $XDG_DATA_HOME/Genie5/Plugins/)

Then in Genie 5 either:

• Reconnect — plugins load on connect, or
• Plugins → Load → Plugin_InventoryViewV5.dll (menu), or
• #plugin load Plugin_InventoryViewV5 (command bar).

Commands

Command	What it does
/iv scan	Scan the current character (inventory → vault → deed register → home → Trader storage) and save. The Inventory View window pops up with the result when the scan finishes.
/iv open [character] (or /iv list)	Show the catalog — every scanned character, or just the one named — with per-source item counts in the Inventory View dock window.
/iv search <text>	Show every catalogued item matching <text> (each by its full path) in the Inventory View window.
/iv reload	Reload InventoryView.xml from disk (run after scanning on another running instance).
/iv wiki <item>	Search Elanthipedia for <item> in your OS-default browser.
/iv export [path]	Export the whole catalog to a CSV file (defaults to {AppData}/Genie5/InventoryView_export.csv).
/iv debug	Toggle a per-line scan trace (handy for diagnosing indentation).

/inventoryview is accepted as the long form of /iv.

At the end of a scan the plugin prints Scan Complete. and re-emits InventoryView scan complete through the parse pipeline, so a login/automation script can wait on it:

send /iv scan
waitforre ^InventoryView scan complete

Manage

From the Plugins menu: Enable / Disable, Unload, Load. Or from the command bar:

#plugin list
#plugin disable Inventory View
#plugin enable  Inventory View
#plugin unload  Inventory View
#plugin load    Plugin_InventoryViewV5
#plugin reload

Show/hide the window via Window → Plugin Windows → Inventory View.

How it works

/iv scan walks the same sequence the Genie 4 plugin did — inventory list → vault book → deed register → home → Trader storage book — parsing each list by its leading-space indentation into a nested item tree, and saving on completion. The trigger strings and the commands it sends to the game are unchanged from the Genie 4 original.

Since the Genie 4 plugin was written, DR changed INV LIST (and potentially the vault/Trader book reads) to concatenate the whole list onto a single raw line. Every item still carries its original leading indent ( item = top level, -item = nested, -item = nested deeper), so the plugin treats each run of 2+ spaces as the indentation of the item that follows it and re-splits the line — the classic one-item-per-line output parses identically through the same path. Catalogs saved by pre-2.1 versions (where a merged line became one giant entry) are detected and re-split on load.

The plugin has no UI dependency — it writes formatted text to a named window via the host API (SetWindow("Inventory View", …)), and the host surfaces that window as a dock panel.

What changed from the Genie 4 plugin

• Its own dock window instead of a WinForms form. Genie 5 plugins are UI-free and reference only Genie.Plugins.Abstractions, but they create their own panel through the host's named-window seam. The old TreeView form (search/expand/collapse/wiki/export/reload buttons) becomes the /iv commands plus the monospace text tree.
• Non-blocking roundtime wait. The Genie 4 code blocked the parse thread with Thread.Sleep(rt * 1000) after the inventory list; this port schedules the follow-up with a non-blocking Task.Delay, so a scan never stalls the game loop.
• End-of-home on the prompt. Genie 4 watched for a bare > text line to end the home scan; Genie 5 surfaces that as OnPrompt().
• Cross-platform. Wiki lookups open the OS-default browser via Process.Start(url, UseShellExecute) (works on Windows/macOS/Linux), and InventoryView.xml resolves under {AppData}/Genie5 (honoring macOS/Linux paths), not the Windows-only Genie config dir.
• Persistence rewritten by hand (XLinq), same file format. XmlSerializer cannot be used from a DLL plugin — it emits a dynamic (non-collectible) serialization assembly that references the plugin's collectible load context, which .NET forbids. The hand-rolled reader/writer produces the exact element shape XmlSerializer did, so an existing InventoryView.xml from the Genie 4 plugin still loads and files written here remain readable by it. Saves are atomic (write .tmp, then move over the real file), a zero-byte file is treated as a silent first run, and a corrupt file is kept aside as InventoryView.xml.bad instead of crashing the load.

License

GPL-3.0 — same as Genie 5 and the Genie 4 ecosystem.

Credits

Behaviour ported from Etherian's Plugin_InventoryView for Genie 4 (itself forked from EtherianDR/InventoryView).