Custom swaps - geheur/More-menu-entry-swaps GitHub Wiki

Custom swaps quick start examples:

Each line prioritizes a certain menu entry to the top of the menu. Separate lines with a newline (enter key).

catch,eclectic impling

attack,mutated bloodveld* - * is to avoid writing out the (level-123) text.

use,cannonball -> dwarf multicannon

view tag tabs - no 2nd section means this will only match entries with no target.

use,grimy* - changes the left-click on all "grimy" herbs.

take,*,attack,brutal black dragon* - pick up items that are under a brutal black dragon.

bank,banker,*,banker - use the bank option on the banker, but only if a banker option was already at the top of the menu (i.e. nothing is inbetween the banker and your camera).

More formally, each line has 1-4 comma-separated bits of text. 1st is the "option" of the menu entry to swap to the top, 2nd is the "target" of that menu entry. Generally, you can tell where the "option" ends and the "target" begins by the color or capitalization of the text, although sometimes it may be hard to tell, such as when useing an item on something else (see above for how to swap this). The 3rd and 4th cause the swap to only activate when the top menu entry matches them in option and target.

* can be used to represent any text, e.g. if you want a swap to apply to multiple similarly named items/npcs, or you don't care what a particular option or target contains, or you don't want to write out the entire menu text.

Custom hides are done similarly, but do not support the top entry conditional (3rd and 4th sections).

Priority

Lines lower in the list have higher priority. So you can create a ranking of e.g. npc priority by ordering several lines in the correct order:

attack,npc1*
attack,npc2*

This will prefer npc2 above all npcs, and npc1 above all npcs except for npc2.

Custom swap limitations:

Jagex's rules limit the swapping and hiding of some entries:

  • Lure/Knock-out in blackjacking.

  • Player entries, including non-combat entries such as "trade with".

  • Manual spell cast onto npcs/players (e.g. cast ice barrage -> nylocas matomenos).