Your gear, your enemy, your best kit. Pick a monster and Loadout Lab computes the strongest set you actually OWN for every combat style - exact DPS included - from live knowledge of your bank, inventory, and equipment.
- Best owned set per style (melee / ranged / magic) vs any monster, with exact DPS, max hit, and accuracy - engine verified against the official wiki DPS calculator across a scenario battery (known deltas tracked in docs/ENGINE-GAPS.md).
- Game-best comparison: see the true ceiling set and how close your gear is, with gold borders on slots where you already own best-in-slot (stat-identical analogs count).
- What to bring: the prayer and boost the numbers assume (icons), the spell to autocast, the special-attack weapon to weave, and what to PRAY against the boss - including bosses whose attacks partially pierce protection prayers.
- Incoming damage: how hard the boss hits YOU in that set, with curated per-boss attack data (GWD, Zulrah, Vorkath, Cerberus, the wilderness ring, and more).
- Optimize modes: Max DPS (maximize output), Balanced (maximize dps-out^1.2 / dps-in - exact math in the feature guide), or Tanky (minimize damage taken).
- Wilderness risk: low-risk sets built around the items-kept-on-death rules - your 3-4 most valuable items ride protected, everything else stays under an adjustable gp risk cap, with per-item death fates (halo = protected, skull = lost, coins = repair fee) and honest gp totals including untradeable repair/mangle fees.
- Simulated items and upgrade budgets: consider unowned gear ("what if I had a tbow?") or let a gp budget suggest buyable upgrades - quest rewards join free with their source quest named.
- Bank tools: "Show in bank" outlines the set's items; "Filter bank" shows only them (uses the core Bank Tags plugin).
- Exclusions: right-click any suggestion to protect rare supplies (dragon darts) from being recommended.
- Mob profiles: per-monster pins ("always bring my Bracelet of slaughter HERE"), your own notes, and trip supplies that join the bank Show/Filter views - remembered per mob.
- UIM storages: the looting bag, POH costume room, sailing cargo holds, and STASH units (one read of the chart) are tracked automatically - no extra plugin needed. Anything else (cold storage, nest storage) can be counted as owned by name, or imported from the Dude, Where's My Stuff plugin (togglable under the plugin's settings, in the Connections section).
- Open your bank once so the plugin can learn what you own.
- Search a monster in the sidebar panel and pick a style card.
- Right-click items for exclusions, simmed items, and stored-elsewhere marks; use the toggles for slayer tasks, spellbook locks, wilderness risk, and optimize modes.
Everything is local. The plugin writes two files under
.runelite/loadout-lab/ on your machine only: profile.json (your
levels/bank snapshot, useful for bug reports) and usage.tsv (your own
search history). Nothing is ever sent anywhere.
Loadout Lab's owned-gear data is deliberately readable by other plugins, two ways.
Preferred - ask over the PluginMessage bus (the same bidirectional request/response shape DWMS answers under its namespace):
- Request: namespace
loadoutlab, namestorages-request, data{"source": "<your plugin's display name>"}(required; unattributed requests are ignored). - Response (posted on the client thread): name
storages-response, datasource("Loadout Lab"),target(yoursourceechoed back - filter on it),version(Integer1), andstorages- a List of Maps, one per non-empty source, each withcategory(String,collectionormanual),name(String, the source key below),lastUpdated(Long,-1; the ledger keeps no timestamps), anditems(List of{"id": Integer canonical item id, "quantity" Long}).
Fallback - read the persisted config through the public ConfigManager API, which works even while Loadout Lab is disabled. No reflection needed:
- Config group:
loadoutlab - Keys:
<world>.<accountHash>.collection.<source>, where<world>isstdorseasonal,<accountHash>isClient.getAccountHash(), and<source>isequipment,inventory,bank, orlootingBag. The user's manually marked items live at<world>.<accountHash>.manualOwned. - Values: JSON. Collection keys hold
{"<itemId>": <quantity>, ...}maps (raw item ids, not canonicalized);manualOwnedis a JSON array of ids.
Stability promise: these semantics never change silently. If the message or config schema ever has to change, the new shape gets a new version / a NEW key, and existing shapes keep their meaning.
BSD 2-Clause. DPS engine derived from best-dps (BSD-2-Clause); monster and gear data from the OSRS Wiki.
One section per user-facing feature. Each heading below is mirrored in
docs/features.json; ./gradlew checkDocs audits the two against the
source tree and flags drift or missing screenshots.
Pick a monster and Loadout Lab computes the strongest set you actually OWN for melee, ranged, and magic - with exact DPS, max hit, and accuracy, verified against the official wiki calculator. When poison tiers of the same weapon tie on stats, the strongest venom wins the suggestion (dragon dagger p++ over plain, main hand and spec alike).
Every style card can show the true best-in-slot ceiling set beside yours, so you see how close your kit is. Slots where you already own the best (or a stat-identical analog) get a gold border.
Exact definitions - dps_out is your damage per second into the monster;
dps_in is the monster's expected damage per second into YOU wearing that
set, at your real defence/magic levels with the best protection prayer up.
- Max DPS - maximize
dps_out. Incoming damage is ignored entirely. - Tanky - minimize
dps_in, full stop. Ties go to the higher-dps set. - Balanced - maximize the ratio
dps_out^1.2 / dps_in. The 1.2 exponent slightly favors output: a 10% dps gain is worth taking ~12% more damage. Balanced considers the Max DPS and Tanky sets too, so its ratio is always >= both by construction. Ties go to the higher-dps set.
How the candidates are found: the optimizer re-runs its search five times
with the beam scored as dps_out - w * dps_in for
w = a * dps_out0 / dps_in0, a in {0.3, 0.7, 1.5, 3.0, 10.0} (scaled
so the weights are comparable across monsters). That traces the
(dps out, dps in) frontier from full glass-cannon to full turtle; each
mode then picks its point off that frontier. The card's sword/shield note
shows the trade the pick made vs the Max DPS set ("10%- / 56%+" = 10%
less dps for 56% less damage taken).
Your owned gear is learned from your bank, inventory, equipment, and looting bag as you play, and remembered per account so suggestions always reflect what THIS character actually has.
See how hard the boss hits YOU in the chosen set, from curated per-boss attack data, plus which protection prayer to use - including bosses whose attacks partially pierce prayer.
On the magic card, Loadout Lab shows the spell to autocast. Lock the spellbook to your setup and the suggested spell and set adjust to match.
Right-click any suggestion you do not own ("what if I had a tbow?") to sim it - considered as owned - and see the set it would build. Any item can be simmed proactively from the green + chip above the search bar or the header "..." menu ("Sim an item"), both of which also list your current simmed items so one that never wins a slot can still be removed.
Enter a gp budget and Loadout Lab suggests buyable upgrades within it; use "-" for the unlimited ceiling. Quest rewards join for free with their source quest named.
Gear kept where no plugin can see it - an Ultimate Ironman's cold or nest storage, a friend's holding, anything untracked - can still count as owned: right-click an unowned suggestion and pick "Stored elsewhere", or add any item by name from the header Options menu. The list is kept per account, marked items join suggestions, bank borders, and the exported profile exactly like banked gear, and the green "Stored elsewhere" line in the panel manages them. (The looting bag, POH costume room, STASH units, and cargo holds need no marking - see the next sections.)
These storages track natively, the same way the bank does - open each once and the contents count as owned from then on:
- STASH units: read the STASH unit chart (the noticeboard by Watson's house) once. Every filled unit across all tiers counts its stored items as owned in that single read - no visiting each unit.
- POH costume room: open a costume storage (armour case, wardrobe, treasure chest, cape rack) in your house once.
- Cargo holds: open a boat's cargo hold once - cannonballs stored there count for ranged setups.
The ledger remembers which storage each item was seen in, not just that you own it. Suggested items that need a fetch trip - a STASH, the POH costume room, a cargo hold, the looting bag - carry a small colored dot in the cell corner naming the storage, with a "Stored:" legend under the cards that lists only the sources actually on screen. Gear at hand (equipped, inventory, bank) stays unmarked, so an all-bank set shows no dots and no legend at all. The tooltip spells it out too ("stored in STASH"), and the profile export carries the same per-source breakdown for bug reports.
Every monster remembers your preferences for it - scoped to one combat set or all of them. PIN an item (right-click a cell's Pin submenu, or the card's dots menu, both opening the native in-game item search) - a Bracelet of slaughter stretching that slayer task - and that card always brings it, owned or not, with the optimizer building the best set around it; a melee-only pin never touches your ranged card. Pins outrank exclusions, budgets, and the low-risk safety vetoes while the risk numbers stay honest, and game best stays unpinned so you can see what the preference costs. The mob's NOTE is a collapsible post-it under the storage lines, edited inline - click, type, click away. BANK-FILTER ITEMS are per-set trip supplies (a super combat on the melee card, a ranged potion on ranged, sharks everywhere) that join that card's "Show in bank" and "Filter bank" views. The "This mob: ..." line manages everything, and each style card collapses to its DPS header - sets a standard deviation under your best start collapsed. The magic card hosts its own controls: PIN THE SPELL ("I am casting Wind Bolt") and the gear optimizes around it, with the spellbook lock shown while the spell is on Auto.
If you run the Dude, Where's My Stuff plugin, the gear storages it has seen are also counted as owned - useful for death storage (which Loadout Lab does not track) and for instantly seeding storages you opened before installing Loadout Lab. With a DWMS version that supports the storages PluginMessage contract, Loadout Lab asks DWMS directly and gets its exact tracked items back (the panel line shows "(live)"); with older versions it falls back to a best-effort read of the data DWMS has already saved (that even works while DWMS is disabled), with strictly defensive parsing: if a future DWMS update changes its format, items quietly stop importing rather than ever miscounting. Either way the stored-elsewhere list remains the manual override, and a muted panel line shows how many items came in this way.
Build low-risk sets around the items-kept-on-death rules: your most valuable items ride protected while everything else stays under an adjustable gp risk cap. Per-item death fates and honest kept/lost gp totals include untradeable repair and mangle fees - and curated "rebuild errand" friction for gear that is gp-free to replace but costs a real trip (the salve line's tomb-and-re-imbue run, an imbued ring's re-imbue visit). Low-risk sets NEVER put such an item at risk: it may ride a kept slot (a protected slayer helmet is standard practice), but if it would be lost or broken it is swapped out of the suggestion entirely, no matter the risk cap.
You can extend that treatment to any item yourself: right-click a suggestion shown with the death skull and pick "Only bring if protected on death". The optimizer then keeps that item protected or leaves it out of the set - never risking it - just like the rebuild-friction gear.
Charged wilderness weapons (Craw's bow, Webweaver bow, the chainmaces, the sceptres) get their +50% accuracy and damage against wilderness monsters. The Amulet of avarice boosts you against revenants - and the risk model knows it keeps you skulled, so your usual three protected items drop to zero (one with Protect Item). A charged Bracelet of ethereum zeroes the revenant incoming-damage line. All verified against the official wiki calculator's engine.
Monsters that also live outside the Wilderness (hellhounds, dust devils, green dragons...) get an "In the Wilderness" checkbox: the +50% and the risk options apply only when you say the fight is actually happening there. Wilderness-exclusive monsters (revenants, the boss ring) are always "in".
Flip the slayer-task toggle to fold in slayer-helm bonuses; bosses locked behind an active task are greyed out.
Right-click a suggestion to protect rare supplies (like dragon darts) so the optimizer stops recommending them - everywhere, only against this monster, or only against this monster's melee/ranged/magic set. Per-mob exclusions are managed from the "This mob" line.
The header's back/forward arrows walk your last 50 steps - monster searches, panel settings, AND edits in one history: search Zulrah, flip the slayer toggle, search Vorkath - back, back, back retraces each of those in turn. Steps cover: monster selections; the toggles (F2P, slayer task, wilderness, low-risk, Protect Item); the optimize mode, spellbook and risk-cap dropdowns; the upgrade budget; the antifire flip; and every edit (exclusions, pins, notes, simmed items, stored-elsewhere marks, protect-only flags, pinned spells, trip supplies). Hover for exactly what's next ("Back: Optimize: Balanced"). Scan-driven changes (bank snapshots, storage captures) are never steps - only what you deliberately did. History is per-session and resets on profile switch.
"Show in bank" outlines the set's items in your bank; "Filter bank" shows only them. Uses the core Bank Tags plugin.
Right-click a monster in the world and choose "Search in Loadout Lab": the panel opens and computes the best owned set for it. Other plugins can send a monster the same way (Goal Planner's boss cards are rolling it out).
The header Options menu has a "Join our Discord" link to the plugin's community server.
