Skip to content

Overhead replacement

dpooley edited this page Sep 2, 2026 · 7 revisions

Overhead replacement

Why the plugin redraws your prayer icon, skull, hitsplats and overhead chat text, and how closely they match the game's own.

The client hides them as one bundle

Everything a player has floating above their head - health bar, prayer icon, skull, hitsplats and overhead chat text - is drawn by the client as a single overhead unit, and a plugin can only answer yes or no to the whole unit per actor. There is no way to hide the health bar and keep the rest.

So for any player it draws a bar over, the plugin hides the whole native bundle and redraws every part of it.

NPCs work differently. Their native health bar is hidden by swapping that bar's sprites for blank ones, which touches nothing else, so NPC hitsplats and overhead text are always the game's own.

Who it applies to

Actor Native overhead hidden when
You Player Bar — Style — Show for Self is on
Another player They are tracked in combat, covered by an always-show setting, or carrying a skull or overhead prayer icon
A blacklisted player Never - they keep the client's own rendering
NPCs Never for hitsplats or chat text; only the bar sprites are hidden

The skull-or-icon rule is why a stranger walking past with a skull still has their overhead handled: their native icon is hidden, so the plugin draws the replacement. Blacklisted players are left alone, since hiding an overhead the plugin has chosen not to draw would leave them with nothing.

What gets redrawn

Prayer icon. All 15 protection and overhead icons, at their natural size, matching the client, which never scales them.

Skull. The plain white skull, plus the loot-key and Forinthry Surge skulls, which in game replace the plain skull rather than sitting beside it. Other skull variants fall back to the plain white one.

Layout runs bottom to top: bar and name, then skull, then prayer icon, each making room for the one below.

Hitsplats. Drawn with the client's own hitsplat sprites, so poison, venom, heal and block splats look like themselves rather than a generic number. The layout mirrors vanilla: at most four at a time in the fixed diamond - below centre, above centre, left, right - with the newest replacing the oldest rather than growing a row. Numbers use the game's small font, white with a drop shadow.

Overhead chat text. Read fresh each frame, formatting tags stripped, drawn in the game's bold font in yellow with a shadow, at the position the client would have used.

Things you will notice

  • Vertical Offset does not move chat text. Chat sits where the game puts it, so raising or lowering your bar changes the gap between the two rather than the text's position.
  • One set of overhead icons per tile. When players stack on a tile, only the tile owner's icons are drawn, hoisted above the whole stack. Your own icons always draw.
  • Hotkeys leave overheads alone. Toggle Names and Toggle HP Bars hide names and bars only; hitsplats, chat text, the prayer icon and the skull keep drawing.
  • Turning the feature off restores the client's version immediately. Unticking Show for Self hands your overheads straight back.

See also: Known limitations.

Clone this wiki locally