Table of contents
Though these scripts are, to the best of my knowledge, legal, you should read the NationStates scripting rules BEFORE using them. The most important takeaway is that YOU, the user, shouldn't try to automate restricted actions.
When a script pauses and waits for your input, you should interact with
it manually.
That means no running another script to automate clicks or keypresses,
no placing water bottles on the keyboard, no yes | ./script.
For userscripts (.user.js extension) - the majority of this repo, you'll
just need a userscript manager, like
Violentmonkey
or
Tampermonkey.
Once you have the browser extension installed, you can click one of the
"Install" buttons below to install the script.
This is a repository of various scripts that I've coded in 2019/2020 to help with NationStates card farming.
Each userscript or utility is designed to be a self-contained module, so that the whole project can be mixed-and-matched.
Most of them have been created in mid- to late-2019 and have since evolved significantly. Some of them were previously scattered through Discord and various gists, notably:
I'm in the process of consolidating them into this repository to make management easier and for them to be available to a wider public.
This project is under the MIT License. However, some of the sources have previously been made available under the 0BSD license. All of the scripts included in the first repository commit are available, in that form, under the 0BSD license. Everything added or created in subsequent commits is available under the MIT license. For details, see LICENSE.md.
Additionally, any image resources in this repo, including (but not limited to)
those embedded in Guildies Auction Highlighter UwU and Gardener Highlighter
are NOT under the MIT license. You'll have to contact their respective
owners/creators for terms of use.
Please report any bugs you encounter by filing an issue. The UserScripts were tested with TamperMonkey but should also work with compatible engines (ex. ViolentMonkey).
May work with GreaseMonkey. GreaseMonkey is not supported. Bugs only appearing on GreaseMonkey are unlikely to be fixed.
I forgot. I like to invent acronyms and forget what they're all about.
Just open a pull request.
Install
For those more stats-oriented, or just not wanting to re-read each issue when it
pops up, this script will remember your previous choices and remind you of them
when answering issues.
These consist of three scripts. When used together, issue answering can be done just by pressing enter repeatedly:
- NsIssueOpener | Install
no more clicking! Just keep pressing enter to open links to unanswered issues in a new tab. - NsIssueCompactorRand | Install
NsIssueCompactorRand (GreaseMonkey) | GreaseMonkey Install
removes all the fluff and text around issue, focusing on a random option. Press enter and voilà: issue answered. The issue has to be opened using the previous script. - Autoclose:
- NsDilemmaAutoClose | Install
Offers to open the card pack the issue generated. If no pack was generated, closes the tab. The issue has to be answered using the previous script. - NsDilemmaAutoCloseAll | Install
Closes the tab after an issue has been answered. Even if a pack was generated. The issue has to be answered using the previous script
- NsDilemmaAutoClose | Install
Install
Pretty straightforward: change the default starting price when placing an ask or
bid. You'll have to edit the value in the script manually (for now).
Install
Contacts several Google Spreadsheets (that were totally never ever secret) with
known puppets and puppetmasters. Adds the puppetmaster's name next to the
puppet. The currently used spreadsheets are
9003's puppet reporting spreadsheet
and XKI's Card Co-op
spreadsheet.
Install
An alternate, wider auction layout better suited designed to minimize scrolling,
with some extra tweaks:
- The card, auction (bids/asks/matches) and information table (owners/copies...) will be displayed side-by side.
- The Sell and Buy buttons are located above the auction instead of below.
- Identical bids/asks (same nation and same amount) are collapsed into one.
- Exact matches (bid is equal to ask) will only display the match value.
Install
Synchronizes the localid across card pages. In short, you don't have to reload
the auction page anymore to avoid those security errors when you have multiple
tabs open.
Install
ViolentMonkey/TamperMonkey only. Should work on all userscript extensions. Best used on a modern one like VM/TM.
A universal highlighter. You can load various card organizations' configs
instead of having multiple highlighter scripts running. This also makes it much
easier for card organizations to have a highlighter, without having to duplicate
existing code. A curated list of configs is available here.
To add a config, navigate to the NS settings page and click the Universal Member Highlighter settings button. If using TM/VM, you can also do this through the extension menu on a card page.
Organization-specific highlighters
Install
Adds an icon of TNP's Cards Guild next to guild members during an auction.
Install
The same as the Guild Highlighter, except for members of the Card Gardening
Society.
Install
Highlighter for NASPAQ members.
Install
Tweaks the titles on card pages to be more descriptive instead of the default
"NationStates | Trading Cards".
Examples
NationStates | Trading Cards | Live AuctionsNationStates | Trading Cards | {nation}'s deckNationStates | Trading Cards | {nation}'s Trades | SalesNationStates | Trading Cards | {nation} (S{season})- etc.
Install
An early version of keybindings for the auction page. A more complete version is
being worked on. These are the available bindings for now:
- Ask / Sell
- Bid / Buy
- Match
- Gift
- Match
- Market Value match
- Remove ask/bid
- Change ask/bid
Install
Depending on NS theme, adds either a cards icon to the top banner or a link in
the menu. Both the link and icon redirect to the deck page.
Install
Adds nifty links next to nations on the card owners page. Clicking on them will copy the appropriate container link (for you to send when requesting cards from others).
Install Allows you to tweak the conditions for when a junking confirmation popup appears.
Install
Adds a link to the nation's trading card on the boneyard page. No longer
necessary, as it is implemented by NS.
Install
The hidden NationStates Intruder theme. For real GPers™.
Install
Would you like to know what kind of steak your card is?
Install
...
Downloads
A python script to generate a sheet of clickable links pointing to various
puppets. Best used with the Containerise extension for maximum efficiency. Also
generates rules for Containerise so you don't have to.
There's this guide for more information on the extension and how it's tied to farming.
By default, links to issues, the deck page (3 variants), telegrams,
settings, telegram settings and the nation itself. Configurable through the
config.txt file. Puppets (or future puppets) go in puppets_list.txt
Downloads
A python script that reads a list of cards and/or a list of puppets. It will
spit out the number of owners, number of copies and who the owners are for each
card. If provided with the list of puppets to check, it will do so for each card
on the puppets. Cards go in the cards.txt file, puppets in puppets.txt.
Use
This is a web version of
Valentine Z's goldretriever
Source is available here.