TBH Tool Repository

Swarm

Easy puppet prep for raiding, and more!

Swarm is an application created by Sweeze primarily for getting nations ready for a raid. It takes a list of nations and password, applies them to the World Assembly, and moves them to a designation region (i.e. your jump point). It also has a feature for easy poll raiding, puppet login, and finding your WA among your puppets. Swarm development has ceased but the tool remains maintained at present.

Use

Swarm is available on Github as a Windows executable, Linux binary, Mac executable, and Python source code (requires Python 3.10 or newer), as detailed in "Downloads" below. Once installed, on first run, it will not launch fully, but will create a file named "config.json" in the same folder. Edit this file (such as with the default Notepad app on Windows, Notepad++, or similar editor) to contain the puppets you want Swarm to process, and their passwords, in the format demonstrated.

When you have completed filling the config.json with your relevant puppets, run Swarm again, and it will launch a GUI window. Complete the fields as directed (i.e. enter your main nation and the Jump Point on the "Prep" tab to prepare puppets), and then click the button repeatedly to execute the prep actions. This button will lock out momentarily after each click, until the action is complete, to comply with NationStates coding rules. For the same reason, each nation you prep will require 4 clicks to complete all actions.

After clicking through prep for all of the nations in the config.json file, Swarm will show an "out of nations" status. Explore the other tabs to see other features!

Downloads

You can download the latest version of Swarm from Github here, and view the complete documentation here. DO NOT USE RELEASES PRIOR TO 1.1.2!! NationStates' script rules were revised in 2023, and v1.1.2 brings Swarm into compliance with the rules revision.

Most releases should icnlude a Windows .exe, a Linux binary, and a Mac executable. The documentation page also describes how to run Swarm from source and install the required dependencies.

(c) 2023 The Black Hawks.