TBH Tool Repository

YAFFeather

Streamlined keybinds for NationStates

YAFFeather is a keybinding browser extension written by Alex, based off the original Feather script by Sweeze. It is designed to allow raiders to perform various actions, including endorsing, joining/resigning from the WA, appointing a nation as RO, and other related activities via a series of keystrokes.

Use

YAFFeather is available as a browser extension and can be installed directly from wherever you normally get browser extensions on either Firefox or Chrome-based browsers (i.e., almost every modern browser on the planet). It also can be sideloaded from the source code found on GitHub. (Instructions for sideloading vary depending on browser - if you need to, search "Sideload extension [your browser name]" for instructions)

Regardless of installation method, YAFFeather begins listening for keystrokes on all NationStates pages. These keys, once pressed and subsequently released, perform a variety of actions as listed below. (While remapping is rare, note that these may be remapped over time, as the tool remains in active development. The GitHub and extension pages will remain up-to-date with any remappings.)

Note that some of these keybinds must be pressed twice - once to prepare the action, another to submit. This is due to NationStates script rules. Further note that some other keybinds will only work on certain pages - e.g., moving regions only works if you are currently looking at a region page.

  • A - Refresh page
  • T - Set template-overall=none for faster pageloads
  • Q - Go back to the previous page
  • S - Endorse. Must be looking at a nation page. This does not toggle endorsements - pressing S on an already endorsed nation does nothing. This allows the user to spam S in move+endorse or similarly fast-paced situations without regard to whether a nation is already endorsed.
  • L - Unendorse nation. Follows the same rules as endorsing a nation, but removes the endorsement rather than endorsing.
  • O - Ban nation. Must be looking at a nation page.
  • K - Eject nation. Must be looking at a nation page.
  • E - Depending on the page, this key will either accept an invitation to the WA, request an invitation to the WA, or resign from the WA. Note that resignation requires two keystrokes - one to navigate to the WA page, a second to initiate the resignation. The confirmation popup for WA resignation is removed. Further note that, when accepting a WA invitation with YAFFeather, the URL to the invited nation is copied to the clipboard automatically. This is to allow the user to quickly paste the URL in a discord chat during point races.
  • F - Move to region. Must be looking at a region page.
  • B - Move to suspicious (or the jump point as specified in YAFFeather's settings)
  • R - This keystroke's functionality was migrated to E - it remains for muscle memory compatability. When pressed, it will accept an opened WA invitation, but has none of the other functionality of the E key.
  • Z - Open the page of the region the users nation is currently in.
  • X - Copy the URL of the current nation to clipboard. Note that accepting a WA invitation with YAFFeather does this automatically.
  • D - Appoint yourself as RO, then dismiss other ROs, then rename the governor. Note that each of these actions requires two keystrokes - two to appoint, two per RO dismissed, and finally two more to rename the governor.

While strictly optional, YAFFeather supports custom RO/Successor/Governor titles, as well as alternate jump points, in the extension settings. The process to access extension settings varies depending on browser, but is usually straightforward. The RO title is the title the raider nation will be appointed with, successor is the title to rename successors to when stripping their office (successors cannot be dismissed by a delegate, but can have all other rights revoked and their office renamed) and similarly the governor title is what to rename the region's governor's office to. Finally, jump_point can be set to a different region name to change what region B navigates to - useful if you operate from other JPs from Suspicious, or the inevitable update reshuffle that will leave us all scrambling for a new base of operations.

(c) 2024 The Black Hawks.