RCES

Table of contents

• RCES
  • DISCLAIMER
  • Usage
  • About
  • Licensing
  • Bugs
  • GreaseMonkey
  • What does RCES stand for?
  • Contributing
  • Description of all utilities
    • Issue Scripts
      • Remember Issue Choices
      • Cards issue answering scripts
    • Auction Utilities
      • Card Default Prices
      • Main Auction Displayer
      • Alternate Auction Layout
      • localid Synchronizer
      • Highlighters
        • Universal Member Highlighter
        • TNP Guild Highlighter
        • Gardener Highlighter
        • NASPAQ Highlighter
    • Miscellaneous
      • Better Card Page Titles
      • Auction Keybindings
      • Cards Icon / Deck page link
      • Container Owner Links
      • Junk Confirmation Changer
      • Puppet Creation Assistant
      • Boneyard Card Links
    • "Decoration"
      • IntruderNS
      • Steak Rarities
      • Zoomer Nation Creator
    • Puppet links sheet
    • Owner report
    • goldretriever-web

---

DISCLAIMER

⚠️ These scripts are not endorsed by NationStates nor by NationStates staff. ⚠️

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.

---

Usage

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.

---

About

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:

• Default Prices
• TNP Guild Highlighter
• Main Auction Displayer
• Gardener Highlighter

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.

---

Licensing

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.

---

Bugs

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).

GreaseMonkey

May work with GreaseMonkey. GreaseMonkey is not supported. Bugs only appearing on GreaseMonkey are unlikely to be fixed.

---

What does RCES stand for?

I forgot. I like to invent acronyms and forget what they're all about.

---

Contributing

Just open a pull request.

---

Description of all utilities

Issue Scripts

Remember Issue Choices

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.

Cards issue answering scripts

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

---

Auction Utilities

Card Default Prices

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).

Main Auction Displayer

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.

Alternate Auction Layout

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.

localid Synchronizer

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.

Highlighters

Universal Member Highlighter

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

TNP Guild Highlighter

Install
Adds an icon of TNP's Cards Guild next to guild members during an auction.

Gardener Highlighter

Install
The same as the Guild Highlighter, except for members of the Card Gardening Society.

NASPAQ Highlighter

Install
Highlighter for NASPAQ members.

---

Miscellaneous

Better Card Page Titles

Install
Tweaks the titles on card pages to be more descriptive instead of the default "NationStates | Trading Cards".

Examples

• NationStates | Trading Cards | Live Auctions
• NationStates | Trading Cards | {nation}'s deck
• NationStates | Trading Cards | {nation}'s Trades | Sales
• NationStates | Trading Cards | {nation} (S{season})
• etc.

Auction Keybindings

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

Cards Icon / Deck page link

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.

Container Owner Links

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).

Junk Confirmation Changer

Install Allows you to tweak the conditions for when a junking confirmation popup appears.

Boneyard Card Links

Install
Adds a link to the nation's trading card on the boneyard page. No longer necessary, as it is implemented by NS.

---

"Decoration"

IntruderNS

Install
The hidden NationStates Intruder theme. For real GPers™.

Steak Rarities

Install
Would you like to know what kind of steak your card is?

Zoomer Nation Creator

Install
...

---

Puppet links sheet

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

---

Owner report

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.

---

goldretriever-web

Use
This is a web version of Valentine Z's goldretriever

Source is available here.