Skip to content

Settings

BrettG edited this page Nov 3, 2026 · 30 revisions

Settings

Every setting, in the order RuneLite shows them. Every section starts folded, so the settings open as a short list of headings. A setting moved or renamed in 2.3 says what it was called; moving or renaming one keeps its value. Can't find something? The sidebar panel's Tips tab has Find a setting.

Each entry says what it does, its default, and when you might want to change it.

Default notification

At the very top. How every notification in the plugin is sent, unless an alert's own setting is off or set to custom with its cog. Default: on, using RuneLite's own notification settings.

  • Make it custom once (sound, tray popup, flash, focus) and every alert follows it.
  • Switch it off to silence every alert that isn't set to custom.

Overlay

The panel at the top of the game. See The overlay.

  • Show overlay (Near wrecks): Near wrecks shows the timer, counter, hooks and wrecks lines only while a wreck site is in view, so sailing between ports stays clear. Always aboard shows them whenever you're on your boat. Alerts and banners show either way.
  • Show timer (on): the countdown to a full hold. Turn it off if you only want the counter and status; lines like "Waiting for a wreck" stay.
  • Show clock time (off; on before 2.3): also show the time of day the hold will be full. If you had the plugin before 2.3, your setting stays as it was.
  • Clock format (12-hour): 6:25 PM or 18:25.
  • Show cargo counter (on): used and total cargo slots.
  • Counter shows (used of total): 154/160, 6 left, or 96%. Slots left is handy when you deposit by hand and want to know how much room is left.
  • Show hooks line (off; on before 2.3): who's on each hook. If you had the plugin before 2.3, your setting stays as it was.
  • Show wrecks line (on): how many wrecks are in reach and how long the longest has left.
  • Text size (100%; 150% before 2.3): 100% is RuneLite's normal overlay size. Raise it on a big screen. If you had the plugin before 2.3, your setting stays as it was.
  • Countdown infobox (off): the time to a full hold as a small RuneLite infobox, hover for detail. Turn it on if you hide the overlay or play with lots of other overlays.

Cargo hold

The count written on the cargo hold. Count on the hold was under Overlay before 2.4; your choice carried over.

  • Count on the hold (on): writes the count on the cargo hold itself, in the middle of the hold, whenever you're on your own boat. Turn it off if you'd rather keep the deck clean.
  • Count shows (Used of total): what it reads: used of total (154/160), slots left (6 left) or percent full (96%).
  • Hold text size (100%): how big it's drawn; 100% is RuneLite's normal overlay text size.
  • Color style (Fade): Fade goes from the empty color through the nearly-full color (at half full) to the full color as the hold fills; Steps jumps from one color to the next at the two percentages below, with no fade in between; One color always shows the empty color.
  • Steps: nearly full at (75%), Steps: full at (100%): with Steps, how full the hold is when the count turns the nearly-full color, then the full color. Percentages of your hold's size, so every hold changes at the same point.
  • When empty, When nearly full, When full (neon green, yellow, red): the three colors. One color uses the When empty color all the time.

Full hold

  • Full-hold notification (on): sent when the hold is completely full. Use the cog to choose sound, tray popup, screen flash and focus. Called "Notification" before 2.3.
  • Repeat alert every (0, alert once): send the alert again this often while the hold stays full. Repeats wait while your boat is moving, so sailing to the bank is quiet. Set it if you tend to miss the first one. Called "Repeat every" before 2.3.
  • Warn with slots left (5): an early warning this many slots before full. 0 turns it off. Raise it if you like to start heading back early.
  • Play sound (on): whether the early warning makes a sound. Off keeps it silent while the popup, flash and banner still show. The full alert always follows its own setting.

Banner

The big banner at the top of the game.

  • Show banner (on): draw it while the hold is full or a hook needs you.
  • Flash banner (on): pulse it. Turn off if you find the flashing distracting.
  • Banner size (150%): 100% is RuneLite's normal overlay size.
  • Hide banner after (0, stays up): hide it this long after the alert. 0 keeps it up until the hold has space again.
  • Full color, Nearly full color, Reminder color: red, orange and amber by default, so you can tell them apart at a glance.

Crew and hooks

Split from Reminders in 2.3. See Alerts and reminders for how each one behaves.

  • Hook empty, crewmate free (on): a hook is standing empty and a crewmate aboard could work it.
  • Your hook is idle (on): a wreck is up and only you can take the empty hook.
  • Grace period (10 seconds): how long a hook may stand empty before the first reminder, sorting or not. Raise it if you take your time sorting; using the hold buys a little extra anyway.
  • Remind again every (60 seconds): how often the empty-hook reminder repeats. 0 reminds once. Called "Repeat every" before 2.3.
  • Crew stopped at a wreck (on): the crew stopped although a wreck is right there. Called "Crew stopped, wreck in reach" before 2.3.
  • Crew stopped: level too low (on): your Sailing level, boosted or not, dropped below the wreck's.
  • Boost warning (Both): warn just before a boost drops below the wreck's level (Before it ends), after the crew stop (After crew stop), or Both. Sent the way "Crew stopped: level too low" is set. Before 2.3 the choices had longer names.
  • Better crewmate free (on): a stronger crewmate is idle while a weaker one works a hook.
  • Swap on screen (On): a SWAP CREW notice mid-screen until you swap. On shows it steady, Flash makes it flash, Off leaves only the notification and the overlay line. It was the switch "Flash the swap on screen" before 2.3.1: on became On (steady), off stayed Off.
  • Hide crew text (Salvage spots): the text over every crewmate's head, yours and other boats' (hidden once the hold count has read it), players' orders to their crew over their heads, and your own orders in the chat box. At Salvage spots only, Everywhere you sail, or Off to see what the crews say. Before 2.3 it was the switch "Hide crew orders in chat" (your own orders in the chat box at a spot); off stays off.

Reminders

See Alerts and reminders and Timers. Before 2.3 this section also held everything now under Crew and hooks, and Empty hook crew highlight.

  • Idle logout coming (on): before the game logs you out for idling, while you're on your own boat.
  • Warn before logout (60 seconds): how long before. 0 never warns.
  • Danger (on): while parked at a spot on your own boat, the boat taking damage, you being hit, or poison, always with a sound, at most every 30 seconds.
  • Flash danger on screen (on): a red DANGER notice mid-screen while it lasts.
  • Waiting for a wreck (off): once every wreck in reach has been down ten seconds. Turn on if you AFK through quiet spells and want to know.
  • A wreck rose (off): a wreck came up after you waited. Turn on if you hook yourself, since your own hook won't start by itself.
  • Done sorting at the station (off): five seconds after you run out of salvage to sort, if you haven't clicked since. Turn on if you wander off mid-sort.

Wrecks

Called "Wrecks and parking" before 2.3, when Timers on wrecks and Show what the plugin sees had their own "Wreck tracking" section. See Parking and double spots and Timers.

  • Mark wrecks (tile and area): Tile puts a small box on the tiles the wreck stands on; Hull outlines the wreck itself instead, like the game's hover outline; Area boxes the water a hook can reach it from. Up wrecks in cyan (the tile or hull only when your level lets you salvage it), sunk ones in gray. Tile is lighter to draw than Hull; pick Hull if you like the bigger outline, or Area or Off if the timers are enough for you.
  • Timers on wrecks (on): "Sinks in ≤ 1:20" on wrecks that are up, "Sunk - next ≤ 0:45" on sunk ones.
  • Wreck reach color (yellow): the boxes round wrecks that are up. The fill is a fainter version.
  • Hide reach boxes once parked (on): the yellow boxes go while every hook is in a double spot, and come back when you drift.
  • Double spot boxes (on): the green boxes where one hook reaches two wreck sites.
  • Double spot color (green): while you're not parked in them.
  • Parked color (faint cyan): once every hook is inside.
  • Label double spots (on): "Double spot", the hook count, and "Parked".
  • Hide doubles after (10 seconds; 20 before 2.3): how long after the boat stops they go; they come back when it moves. 0 keeps them on screen. If you had the plugin before 2.3, your setting stays as it was. Called "Hide double spot boxes after" before 2.3.
  • Say "Parked" after hiding (on): keep "Parked in double spot" on your boat once the boxes have gone.
  • Fill the boxes (on): shade the inside of the boxes. Off draws outlines only, so nothing on the water is tinted.
  • Show what the plugin sees (off): a faint dashed square round the area the game has loaded. The plugin only knows about wrecks inside it. Turn it on if a far set of wrecks isn't being picked up: sail toward it until the square moves past it.

Salvaging worlds

See Timers.

  • Salvaging worlds (596, 597): worlds to treat as salvaging worlds. Worlds the world list labels as salvaging are always included. Add any you find busy.
  • Salvaging world tip (on): one line in chat after a long wait on an ordinary world.
  • Salvaging world alert (off; on before 2.3): a flashing notice mid-screen, after a quarter of a minute with no wreck up off those worlds, naming the worlds to hop to. It goes when a wreck is up or you hop. Turn it on if you want more than the tip. If you had the plugin before 2.3, your setting stays as it was.

Sidebar

See The sidebar panel.

  • Show sidebar (on): the AFK Shipwrecks panel.
  • Show nearest docks (on): the dock you can use and the dock where your crew bank, at the top.
  • Only docks I can use (on): only name docks whose Sailing level (unboosted) and quest you meet, and say what a nearer one needs. Off names the nearest whatever it needs.
  • Auto route when boarding (on): when you board from a dock, route to the spot marked Auto. The route clears when you reach the spot or leave your boat.

Inventory sorting

See Sorting and your next step.

  • Box inventory items (on): the colored boxes on your inventory.
  • Show boxes (Salvage spots): on your boat at a salvaging spot, On my boat whenever you're on your boat, or Everywhere.
  • Alch from (1,000 gp): an unmarked item that alchs for at least this gets the alch box. Raise it to alch less, lower it to alch more.
  • GE beats alch by (0, off): an item that would be alched gets the keep box instead when its Grand Exchange price beats its alch value by at least this much. Called "Keep if GE beats alch by" before 2.3.
  • Shift-right-click to mark (on): the AFK Shipwrecks entry in an item's menu, while Shift is held, on your own boat.
  • Box kept items (off): draw the keep box at all. Off leaves kept items plain so the rest stand out.
  • Box the last alch (off): box the last copy of each alch item in yellow instead of green: the one furthest along your inventory, left to right then top to bottom. An item you carry only one of is yellow too.
  • Keep color, Deposit color, Alch color, Drop color: sage, cyan, green and red by default.
  • Only the last alch (off): box only the last copy of each alch item, in yellow, and leave the earlier copies with no box, so you see one box per item. Works with or without Box the last alch.
  • Last alch color (yellow): the box on the last copy of each alch item, with Box the last alch on.
  • Box salvage in the hold (on): while the hold is open, box the salvage inside so it's easy to click.

Next step highlights

The outlines on your boat that show where to go next. Their own section from 2.3; before that the first two were under Inventory sorting and the third under Reminders. See Sorting and your next step. To turn every highlight off, set the first two to Off and switch the third off.

  • Salvage highlight (Automatic): your next step on deck. Automatic follows the whole loop; Station or Cargo hold lights only that one (pick Cargo hold if you never use the station); Off turns it off. Called "Highlight where salvage goes" before 2.3, with "Salvaging station" for Station.
  • Hook highlight (Free or weakest): with nothing left to sort or deposit and a wreck in reach, light a hook, unless the hold holds enough salvage to fill your free inventory (then the hold lights instead). Free only never points at a crewed hook; Off turns it off. Called "Point to a hook" before 2.3.
  • Empty hook crew highlight (on): flashing green boxes on each click to fill an empty hook, from the reminder on, or as soon as you start sorting after leaving the hook. Turn off once you know the way by heart. Called "Show where to click for an empty hook" before 2.3.

Dimmer

Darkens the game while nothing needs you, so it's easy to look away. Every "While" switch is off until you turn it on. It never dims while the boat is moving (only once it has stood still a few seconds), in danger, during the idle-logout warning, with the cargo hold or another window open, off your own boat, or while you're logged out or loading.

  • While the crew salvage (off): while you stand idle and your crew salvage a wreck. It clears when they stop or stall, or when the hold reaches Crew: undim at (100%).
  • While no wreck is up (off): while you wait at a salvaging spot with no wreck up, idle or at a hook. It clears when a wreck rises, even one above your level.
  • While you salvage (off), While you sort (off): while you work a hook or the station yourself. Sorting: undim early (0 s) clears it that many seconds before sorting is estimated to end.
  • Undim on alerts (on): clear while one of this plugin's banners is up, and for 10 seconds after any of its alerts that is switched on (not the waiting-for-a-wreck one, which is what While no wreck is up dims for).
  • Undim when inventory full (off): clear when your own hook fills your inventory, even with the crew still salvaging. Salvage you take out of the cargo hold to sort doesn't count, and sorting itself stays dimmed with While you sort.
  • Dimmer color (half see-through black): the picker's alpha slider sets how dark.
  • Dimmer covers (Game view): Game view darkens the game world only; the chat box, sidebar and open windows stay bright. All but chat darkens those too, except the chat box. Everything darkens the whole game. The plugin's own banners stay bright in all three.

The idea and the first version are trippy22's.

Chat messages

The plugin's own lines in the chat box. Before 2.4, Say when updated sat on its own at the very bottom.

  • Say when updated (on): one line in chat the first time you log in after an update, saying what's new.
  • Plugin conflicts (on): once each login, the first time you're on your boat at a salvaging spot, when the Sailing plugin shows the same things (its cargo hold count or its wreck outlines), one line says which of its settings to turn off to see only AFK Shipwrecks'. See Using it with other plugins.

Clone this wiki locally