Cavero Plugins
Docs / Achievement Diaries

// plugin guide

Achievement Diaries

The complete guide: everything you need to set the plugin up, configure your loadouts, and get all 12 diaries cleared hands-off.

12 regions377 tasks automated91% coverage · See per-diary coverage →
Jump to section

Overview

Achievement Diaries is an end-to-end diary completer. It picks the next task, fetches the items from your bank or the GE, equips the right combat loadout, travels there, executes the action, and moves on — repeating until the diary (or every diary) is done.

The plugin covers 12 regions across Easy, Medium and Hard tiers, and currently automates 377 of 415 tasks (91% overall coverage). For a task-by-task view, see the diaries page.

Main accounts only

Achievement Diaries requires Grand Exchange access to source missing items on-demand. Ironman, Hardcore Ironman and Ultimate Ironman accounts are not supported — see Account compatibility.

What it does for you

  • Reads which tasks you've done from the in-game varbits and resumes where it left off
  • Prepares inventory & equipment from your bank (or buys via the GE)
  • Equips your configured combat loadout — separate sets for the Wilderness
  • Travels using jewellery, tabs, fairy rings, spellbook swaps, etc.
  • Handles farming: plants crops early, hops back to harvest when ready
  • Remembers its place — close RuneLite and it resumes the same task on relaunch

What you still do manually

  • Meet the underlying quest & skill requirements for each task (the plugin doesn't quest or skill-train for you)
  • Configure combat loadouts for Melee, Ranged and Magic — at least once per account
  • Pick an execution mode (Random / Sequential / Custom) and start the plugin

Quick start

First run, in the order you should do it:

  1. Open the side panel — click the Cavero Achievement Diaries icon on the RuneLite sidebar.
  2. Configure your combat loadouts — scroll to Combat Loadouts and click CONFIGURE on the General card. Add Melee, Ranged and Magic gear sets. Repeat for the Wilderness card with your risk-safe kit.
  3. Pick an execution mode — click Configure Diaries and choose Random (hands-off, everything), Sequential (diary-by-diary queue) or Custom (cherry-pick individual tasks).
  4. Get your bank ready — see Bank preparation below. Most items the plugin can buy on the GE; quest-locked or untradeable items you'll need to provide yourself.
  5. Hit ▶ START — the status dot turns green, the runtime clock starts, and the plugin picks up the next task.

It's safe to pause at any point — ⏸ PAUSE finishes the in-flight action and halts. Progress and the current task index are saved, so ▶ RESUME picks up exactly where you were.

Requirements

The plugin never quests or skills for you. If a task wants Fairy Tale II and Magic 51, you need both before it'll run. Tasks whose requirements you don't meet are marked red in the Custom task picker and will be skipped in Random/Sequential modes.

Account compatibility

Mains only — no Ironman support

The plugin relies on the Grand Exchange to source missing items, so Ironman, Hardcore Ironman and Ultimate Ironman accounts are not supported. Running on an iron account will cause tasks to stall the moment any required item is missing from your bank.

Supported

  • Main accounts
  • Pures (if you have the stats/quests for the tasks you target)

Not supported

  • Ironman (all variants — standard, HCIM, UIM)
  • Elite tier — currently only Easy, Medium & Hard are automated
  • Accounts that can't access a bank during the run

Bank preparation

You don't need to pre-stage every item — the plugin buys whatever is missing from the Grand Exchange as tasks come up.

What helps to have ready anyway:

  • Jewellery teleports — Amulet of Glory (any charge), Ring of Dueling, Ring of Wealth, Combat Bracelet, Skills Necklace, Games Necklace, Necklace of Passage
  • Teleport tabs — Ardougne, Watchtower, Camelot, Trollheim and other POH tabs as tasks demand them
  • Fairy-ring access — Dramen Staff or Lunar Staff (requires Fairy Tale II part 2)
  • Stamina potions — tasks that need them auto-withdraw the required count
  • Graceful / Grace of the Elves — worn automatically on long walks to keep run energy up
  • Runes — a stocked rune pouch for teleport spells and combat casts

Enable Fairy Rings in Storm's Path Finder

Several tasks route through the fairy-ring network. Make sure Fairy Ring (and any other POH-related options you want — Jewellery Box, POH Fairy Ring, etc.) is ticked under Storm Settings > Path Finder. If those are off, the plugin will walk the long way round instead.

Tip

Easy tiers are mostly short, prep-light tasks and finish fastest — running Easy → Medium → Hard in that order gives you the quickest visible progress per session.

The side panel

Everything you configure lives in the RuneLite side panel. Here's what each section does, top to bottom.

The header card shows the Cavero logo, plugin version, a status dot, a status label and the runtime clock.

  • Yellow dot + PAUSED — the plugin is idle; click ▶ START to begin
  • Green dot + RUNNING — the plugin is working; click ⏸ PAUSE to stop after the current action

Right under the header are two secondary buttons:

  • BUG REPORT / DEBUG CONSOLE — opens a log viewer with everything the plugin has printed this session. If anything's going wrong, open this first.
  • Track all your stats here — opens the public stats site at cavero-plugins.com.

Status card

Three labels update live (every ~200ms):

  • STATUS — what the plugin is currently doing: "Banking items", "Walking to task", "Executing task", "Waiting for GE offer" etc.
  • CURRENT TASK — the diary task description, shown in blue.
  • PRE-TASK — only appears when the current task has prerequisite steps. Shows e.g. [1/3] Light the light source.

Configure diaries dialog

Click Configure Diaries to open the 780×600 dialog. The three tabs at the top pick your execution mode.

Mode summary

  • Random — no setup; plugin hops between all incomplete tasks across every diary
  • Sequential — build an ordered queue of diaries (e.g. Ardougne Easy → Medium → Hard)
  • Custom — build a playlist of individual tasks across any diaries/tiers

Random and Sequential both include a Plant farming tasks upfront toggle — see Plant farming upfront.

Progress

Back on the main panel, the Progress section shows two cards: COMPLETED and TOTAL TASKS for the currently-loaded diary — updated live as the plugin ticks through tasks.

Combat loadouts

Two cards side-by-side: GENERAL and WILDERNESS. Each shows how many of the three styles (Melee / Range / Magic) are configured: 3/3 styles: Melee, Range, Magic in green when all set, or Not configured in grey.

Click CONFIGURE to open the loadout editor — see Combat loadouts below for what to put in there.

Farming tracker

Once you've planted a crop, it shows up in the tracker: crop name, diary it belongs to, a progress bar, and time remaining. Rows sort by time-remaining (soonest first). Ready crops flip to a READY badge and the plugin harvests them automatically — even if it's mid-way through a different diary (see Cross-diary harvests).

System info

Collapsible, informational only: heap memory usage, active threads, CPU cores, Java version, OS. Useful when filing bug reports.

Execution modes

Three modes, picked in the Configure Diaries dialog. You can switch freely — the plugin saves your mode and resumes with it on the next restart.

Random

The truly hands-off option. The scheduler scans every incomplete task across all 36 diary/tier combinations and picks one at random. When that task is done, it picks another. Keeps going until everything is complete.

Pick this if you want to leave it running and come back to a finished account. Pair with Plant farming upfront so crops are growing while you clear short tasks.

Sequential

You build an ordered list of diary/tier entries. The plugin works through them in order: clears every task in entry 1, moves to entry 2, and so on.

The queue editor supports:

  • Add — pick an area and a difficulty, add to the list
  • Up / Down — reorder the selected entry
  • Remove — delete the selected entry
  • Clear All — wipe the queue

Pick this if you want to clear diaries in a specific order — e.g. rush Fremennik Hard for the helm, then Ardougne Hard for the cloak.

Custom

A playlist of individual tasks, not whole diaries. Pick an area, a difficulty, and a specific task; add to the list. Reorder and remove like in Sequential.

Tasks in the dropdown are colour-coded:

  • Green — requirements met (or none), safe to add
  • Red — requirements not met; blocked from adding
  • Orange — requirements unknown (not logged in yet)

Pick this if you want to do a narrow slice — e.g. every Slayer-related diary task across regions, or just the three tasks you need for the next diary cape tier.

Combat loadouts

Any diary task that involves combat (kill an NPC, cast a combat spell, etc.) needs a configured loadout. The plugin keeps two sets independently:

  • General — used for everything outside the Wilderness
  • Wilderness — used when a task is flagged for the Wilderness (e.g. Wilderness diary combat tasks)

Setting them up

  1. Scroll to the Combat Loadouts cards.
  2. Click CONFIGURE on the General card.
  3. The loadout editor opens with three tabs: Melee, Ranged, Magic.
  4. Fill in the gear slots for each style you want to support. Not every account needs all three — see below.
  5. Save and close. The card label flips to "3/3 styles: Melee, Range, Magic" in green.
  6. Repeat for the Wilderness card with your risk-safe kit.

How tasks pick a loadout

Each task declares one or more preferred styles. The plugin walks them in order and uses the first style you have configured. If a task says "Melee preferred, Ranged OK" and you've only set up Ranged, it uses Ranged.

If a task only accepts styles you haven't configured, the task is skipped (logged in the debug console). This is by design — you don't want the plugin to wander into a Slayer boss with a starter scimitar.

Wilderness-specific tasks

Tasks flagged wilderness pull from the Wilderness loadout only. An empty Wilderness loadout will skip those tasks — keep a cheap but viable setup there even if you're happy risking gear elsewhere.

Recommended setups

You don't need endgame BiS — the plugin only needs gear that completes the task. A few starter ideas:

Style Weapon Body / legs Notes
Melee (General) Abyssal whip / Dragon scimitar Rune / Bandos / Torva Berserker-style kit clears every non-Wilderness melee task in the diaries.
Ranged (General) Toxic blowpipe / Rune crossbow Karil's / Void / Armadyl Bolts and darts are auto-purchased from the GE when needed.
Magic (General) Trident / Ancient staff / Mystic staff Mystic / Ahrim's / Ancestral Needed for spell-cast tasks like Teleport to Ardougne or Sedridor teleport.
Wilderness (any style) Whatever you'd PK with Low-risk — rune/blessed Mirror your usual anti-PK setup; the plugin won't auto-hop, so dress for risk.

Exact gear isn't matched fuzzily — if you equip Amulet of glory (t) but the loadout has Amulet of glory, the glory is still fine (they're treated as variants). Uniques like Slayer helmets are also variant-matched.

Supported diaries

All 12 regions, Easy through Hard. Elite is on the roadmap but not live. For a task-by-task breakdown (including the few unsupported ones inside each tier), open the diaries page.

Ardougne Easy · Medium · Hard
Desert Easy · Medium · Hard
Falador Easy · Medium · Hard
Fremennik Easy · Medium · Hard
Kandarin Easy · Medium · Hard
Karamja Easy · Medium · Hard
Kourend & Kebos Easy · Medium · Hard
Lumbridge & Draynor Easy · Medium · Hard
Morytania Easy · Medium · Hard
Varrock Easy · Medium · Hard
Western Provinces Easy · Medium · Hard
Wilderness Easy · Medium · Hard

Advanced features

Plant farming upfront

Farming tasks (herbs, allotments, trees) take real-world hours to grow. Toggled on, the scheduler plants every in-scope farming task before working anything else. By the time you've churned through the short tasks, the crops are ready.

Available in Random and Sequential modes via the checkbox on each panel. Off by default.

Cross-diary harvests

Planted a tree 16 hours ago? While you're mid-run on Varrock Medium, the plugin will notice a ready Apple tree from Ardougne Easy, save its place, fly over to harvest, and return. You don't configure anything — it happens automatically whenever a tracked crop is ready.

Pre-tasks

Many diary tasks bundle sub-steps. "Light the candle inside the H.A.M. hideout" needs you to enter the hideout first — that's a pre-task. The status panel shows which pre-task is active: [1/3] Light the light source.

Some pre-tasks are recoverable: if you somehow lose the pre-condition mid-execution (e.g. die and respawn outside the dungeon), the plugin loops back and redoes it automatically.

Tips & gotchas

  • Elite isn't supported yet — don't queue Elite tiers; they'll be ignored.
  • Quest-locked tasks silently skip — check the Custom task picker (red items) if you're wondering why the plugin hasn't done a specific task.
  • Wilderness tasks run with your Wilderness loadout only — empty loadout = skipped task.
  • GE price spikes can stall the plugin — if the plugin keeps re-offering on an item that won't fill, buy it manually and resume.
  • Leave the bank accessible — at least one reachable bank (any) is assumed for item prep.
  • Start from anywhere — no fixed starting tile, but you'll save a few minutes if you start at a bank.
  • Pause is graceful, not instant — the plugin finishes its current in-flight action (finishing a walk, closing a dialog) before actually pausing.
  • Run energy matters — wear graceful or bring staminas; the plugin handles energy, but travel time grows a lot without.

Troubleshooting

The plugin paused itself mid-run

Most likely the scheduler ran out of work — everything in your current queue (Sequential/Custom) or every remaining diary task (Random) is complete. Check the status label; it'll say "Queue complete" or similar. Add more entries in Configure Diaries and hit START again.

A task keeps getting skipped

Open the Configure Diaries dialog in Custom mode and find the task in the dropdown. If it's red, you don't meet the quest or skill requirement. If it's green but still skipping, the task likely needs a combat style you haven't configured — check the debug console.

Status is stuck on "Waiting for GE offer"

The plugin bumps its bid on retries, but a heavily-spiked item can still fail. Open the GE, manually buy the item at market rate, and the plugin will pick up the item from your inventory and continue.

It's not using my new amulet/weapon

Loadouts use exact item IDs, with known-variant matching for Slayer helms, Glories, etc. If you swapped a weapon, re-open the loadout editor and reselect it. The plugin re-reads the loadout JSON at start.

Farming crops didn't auto-harvest

Check the Farming tracker on the panel — it reads from the plugin's own planted-timestamp log. If a crop isn't there, the plugin didn't register the plant (common if you teleported out before the plant animation finished). Replant, wait for the animation, and it'll show up.

It keeps trying the same task over and over

Open BUG REPORT / DEBUG CONSOLE at the top of the panel to see what it thinks is going wrong. Most often this is a dialog that changed in a game update or a pathfinding edge case. Drop a note on Discord and it'll get a fix.

Support

Bug reports, feature requests, or just want to share a setup that worked for you? The fastest path is the Cavero Discord:

Docs are a starting point, not a contract — behaviour can change as OSRS updates. If something reads out of date, let us know.