Skip to content
GitHixyPublic

Repository files navigation

LootView

See every item you and your party pick up, as it drops.

A loot tracker for Final Fantasy XIV, built on Dalamud. It shows drops live as they happen, keeps a permanent searchable history, and turns that history into statistics about where your loot actually comes from.

Website Patreon Discord

License Dalamud API Version


What it does

Works with every game language: English, Japanese, German and French clients are all supported. Loot is read from the game's own log messages, so nothing depends on the English wording of the chat.

Live loot overlay

Every drop appears the moment you get it, with its icon, rarity, quantity, who received it and how long ago. New items are highlighted with a brass sweep so you can catch them at a glance, and rarity is marked on each row.

The parser handles the awkward parts of FFXIV's chat messages:

  • Measure words such as "3 rolls of", "a bunch of" or "2 baskets of" are read as quantities, while genuine item names like Sack of Nuts and Basket of Flowers are left intact.
  • Multi-catch fishing ("You land 2 mossy globules…") records the full count.
  • Crafting, gathering, retainers, chests, duty rewards and roulette bonus gil are all tracked.
  • Duplicate chat messages for the same drop are collapsed rather than double-counted.

Estimated value

A strip above the list keeps a running market value of everything you've picked up, priced for your home world through Universalis. Two figures, because they answer different questions: Avg is what those items have actually been selling for, Now is what the cheapest listings are going for today.

Only sellable items are looked up — whether an item can reach the market board is answered from the game's own data, so nothing untradable ever costs a request. Prices are cached for 30 minutes. Figures exclude the 5% market board tax, and anything Universalis has no data for is counted separately rather than silently as zero.

Turn it off in Settings → General → Market prices if you'd rather the plugin made no network requests while you play.

Currencies

The coin button in the toolbar slides out a drawer beside the loot window, on the left or right as you prefer, listing every currency you hold: gil, tomestones, crafters' and gatherers' scrips, Grand Company seals, MGP, PvP marks, tribal currencies and the rest. Each one shows its cap, turning amber as you near it and red once you're there, and the weekly-limited tomestone carries a bar for the week's progress. Gains flash as they come in, and the button lights up when one lands while the drawer is closed. Currencies are read straight from the game, so new ones appear without an update.

Turn on Currencies on their own in Settings → General to give the currencies a small window of their own instead, a currency HUD that stays on screen even with the loot window closed: move it, resize it from its edges, lock it in place and set how see-through its background is. Show or hide it with the coin button or /lv currencies. In the drawer and on its own, drag a currency up or down to put them in your own order, or right-click one to hide it.

Ticker

Minimise the loot window with the arrows button in its toolbar and new drops slide in on a slim strip instead, stay a few seconds and fade out. Drag it anywhere: low on the screen new drops come in at the bottom, high up at the top, and it hugs the nearer side. Repeat drops add up on one row and hovering pauses it. Ctrl+click a drop (or right-click → Dismiss) to clear it early, or use the broom next to its controls to clear them all. It can also run beside the open loot window.

Loot jar

A second view for the loot window, where your drops fall into a glass jar. Each item is a token with its icon, a repeat drop merges into the one already there, and currencies and crystals settle as sand, one labelled layer each. Grab a token to toss it around, or move the window to slosh the jar. The jar always holds what the loot list shows, so clearing the list pours it out.

Turn on Jar on its own in Settings → General to keep just the jar on screen, without the loot window around it: move it, resize it from its edges and lock it in place. It fades back while nothing is happening and comes forward when something drops in.

Player commendations

When someone commends you, a large banner appears at the top of the screen with your new total. Commendations that arrive together are counted on one banner instead of stacking, and it waits for the loading screen to finish when you leave a duty. Resize it, preview it or turn it off in Settings → Effects.

Need / Greed rolls

A panel appears while rolls are open, with a card for every item on the loot list:

  • Time left to roll, as a countdown and a bar that turns amber and then red as it runs out.
  • Every result: Need and Greed rolls with their values, passes, items you aren't allowed to roll on, and party members who never chose. Your own choice shows the moment you make it; everyone else's is revealed by the game once the item is resolved.
  • Who is still deciding in your party while the item is open. In an alliance raid a counter ("7/24 decided") takes the place of the list, and once the item is resolved only the Need and Greed rolls are listed, with everyone else summed up in one line.
  • Weekly limits: in duties where you can only win one item a week, those items carry a Weekly limit tag, and a warning appears above the buttons if you've already rolled on another one. Whichever you win first is the one you keep, and the game decides that order.
  • The winner, crowned, with a burst of light and sparks on the card as the result comes in.
  • Need, Greed and Pass buttons, so you can roll without the game's loot window. Only the choices the game allows you are offered; Need is greyed out when your job can't use the item or the duty is Greed only.
  • Item details on hover and Try On on right-click, to judge an item by its stats or its look before you choose.
  • Collectibles you already have: minions, mounts, orchestrion rolls, Triple Triad cards, emotes, hairstyles and portrait frames show a check if they're already unlocked, or a gold star if they'd be new for you.
  • Buttons that stay put: Need, Greed and Pass sit right under the item name, above the rolls, so results coming in never push them away.
  • The game's Need/Greed window stays hidden, so every roll happens in LootView. A button in the panel's header brings it back when you want it, and you can turn this off in Settings → Tracking.

Each resolved item leaves the panel on its own after 20 seconds (adjustable in Settings → Tracking), and the panel closes when none are left. If you leave the duty before rolls finish, the open items wind down the same way. You can turn the panel off entirely in the settings.

Statistics and history

  • Overview — totals, rarity split, play streaks and your most common items, over today, this week, this month or all time.
  • History — every item ever tracked, filtered by name, rarity, zone, high quality or owner, and paged.
  • Trends — daily and hourly activity charts, plus your rarest finds.
  • Analytics — the last N days compared against the period before them, across items, rarity and zones.
  • Duties — a leaderboard of every duty you've run, with clear times, items per run and your personal bests.
  • Zone Finder — look up the loot table for any dungeon, trial or raid by name.
  • Blacklist — everything you've hidden from tracking, in one place.
  • Export — the whole history as JSON or CSV.

All of it is computed on a background thread, so opening the window or changing a filter never stalls the game, however large your history gets.

Loot tables

Open the loot table for the duty you're in from the overlay's toolbar, or search for any other duty from the Zone Finder tab. Data comes from the Garland Tools API.

Loot table data is still being corrected and expanded. Some entries may be incomplete or inaccurate.

Blacklist

Right-click any row in the loot list to stop tracking that item. Blacklisted items stay hidden across sessions and can be restored from Statistics → Blacklist.


Installing

  1. Open the plugin installer in game with /xlplugins.
  2. Search for LootView.
  3. Install and enable it.

Using it

Commands

Command What it does
/lv Toggle the loot overlay
/lv config Open the settings window
/lv currencies Show or hide the currencies

You can also toggle the overlay from the server info bar, next to the server name.

Overlay toolbar

Button What it does
People / person Switch between all party loot and only your own
Broom Clear the current list
Chart Open Statistics & History
Table Loot table for the duty you're in (only shown inside a duty)
Coins Slide the currency drawer in or out
Lock Pin the window's position and size
Cog Settings
Heart Support on Patreon

Hover a row for the full item details: item level, jobs, damage or defense, bonuses, materia slots and market price. Right-click it to try the item on, open it on Garland Tools or Universalis, copy its name or blacklist it.


Settings

Settings are grouped into sections down the left of the window.

Section What's in it
General Open on login, open when a duty starts, show only your loot, how many items the list keeps (10–200), currency drawer, the side it opens on or currencies on their own, loot jar and jar on its own, ticker, server info bar button, market price estimates
Tracking Track party loot, show the Need/Greed roll window, how long results stay on screen, Need/Greed/Pass buttons, hide the game's Need/Greed window
Appearance Lock position and size, loot window scale (60–140%), background opacity
Effects Item tooltips, marks on collectibles you already have, particle effects and their intensity, commendation banner and its size
History Keep a permanent history, auto-save every 5 minutes, save to history when clearing the list
Diagnostics LootView's live log, a one-click report to paste into a bug report, and buttons to report a bug or suggest a feature on GitHub, or to join the Discord
About Version, release notes, links

Your data

Your loot history lives in your Dalamud configuration folder as loot_history.json, alongside config.json. Nothing about your loot, your character or your play is uploaded anywhere.

Two features do make outbound requests, and both send only an identifier — never your character, your history or anything about you:

  • Market prices ask universalis.app for the going rate of item IDs currently in your loot list, along with your world's name. This runs automatically while the overlay is open; switch it off in Settings → General → Market prices.
  • Zone Finder / loot tables ask garlandtools.org for a duty's drop table, and only when you open one.

Use Statistics → Export to take a backup at any time. Statistics → Export → Delete all history removes everything permanently.


Building from source

You need the .NET 10 SDK and a working Dalamud install — the build finds Dalamud through your XIVLauncher directory.

git clone https://github.com/GitHixy/LootView.git
cd LootView
dotnet build -c Release

The built plugin lands in bin/Release/. To run it as a dev plugin, point Dalamud's dev plugin locations at that folder, or copy the output into %AppData%\XIVLauncher\devPlugins\LootView\.

icon.png and icon.svg are both generated from tools/make_icon.py, which shares its palette with src/UI/Theme.cs. Run python tools/make_icon.py . from the repo root after changing it, so the two files stay in step.


Release notes

The plugin shows what's new the first time you log in after an update, and you can reopen it any time from Settings → About → What's new.

1.6.6 lets the currencies stand on their own as a small HUD you can move, resize, lock and make see-through, and lets you reorder and hide currencies.

1.6.5 lets the loot jar live on its own, just the glass and no frame, fading back while nothing drops in. The jar now always matches the loot list, and drops on the ticker can be dismissed with Ctrl+click or all at once.

1.6.4 reveals roll results with dice that count up together, chimes when an item goes to someone else, reorders the roll window around what still needs your choice, and adds the ticker and the loot jar.

1.6.3 fixes overlapping text in the roll panel and other windows when Dalamud's UI scale is set above 100%, adds a preview of the roll panel to the settings, and moves routine log lines to Debug.

1.6.2 warns you about weekly loot limits in the roll panel: items that use up your one win of the week are tagged, and you're told when rolling on one puts another at stake. In alliance raids the panel shows a "7/24 decided" counter instead of a row for every player.

1.6.1 adds a currency drawer beside the loot window (every currency you hold, with caps and the weekly tomestone limit), a banner when you're commended, and a scale slider for the loot window. The Need/Greed/Pass buttons now sit above the rolls so they stay put, and locking the window from Settings works straight away.

1.6.0 makes LootView work with every game language (Japanese, German and French clients included), lets you roll Need, Greed or Pass straight from the roll panel (the game's own loot window now stays hidden), shows full item details on hover (stats, bonuses, materia, market price), marks collectibles you already have, and adds Try On and lookup links to the right-click menu. LootView also has a Discord server now.

1.5.1 replaces the Ko-fi links with Patreon.

1.5.0 rebuilds the roll panel around the whole life of a loot roll: a timer on every item, passes and non-rolls in the results, who is still deciding, a flourish for the winner, and results that clear themselves after a configurable time. It also adds a Diagnostics page for reporting bugs and suggesting features.

1.4.0 is a complete visual overhaul: one coherent theme across every window, a redesigned settings window, properly drawn statistics charts, and a rebuilt loot list and roll panel. The Compact and Neon layouts were removed — Classic is now the only view and received all of the design work. Statistics were also moved off the draw thread, so large histories no longer freeze the game.

Full history is on the Releases page.


Contributing

Issues, feature requests and pull requests are all welcome — use the issue tracker. If you're reporting a bug, the Dalamud log (/xllog) and what you were doing at the time help a lot.

Community

Questions, ideas, or just want to share a lucky drop? Join the LootView Discord. It's also where new versions are announced first.

Discord

Support the plugin

LootView is free and always will be. If it's saved you some time, support on Patreon is genuinely appreciated.

Patreon

Licence

GPL-3.0.

Thanks

  • The Dalamud team, for the plugin framework.
  • Universalis, for the market board data.
  • Garland Tools, for the loot table data.
  • The FFXIV plugin community, for the help and the example.

Not affiliated with Square Enix. FINAL FANTASY XIV © SQUARE ENIX CO., LTD.

Releases

Packages

Contributors

Languages