Project Terminus is a command-line based extension written in Python for Anacreon 3, which is an online 4X game produced by Kronosaur Productions, LLC.
The aim of this project is to provide a user-friendly front-end interface for using pre-packaged scripts that make use of the Anacreon API, to automate some micromanagement aspects of the game, as well as providing some additional features not present in the vanilla game client.
This project is currently in an Alpha state. Please report bugs on the Issues page, and note that additional scripts will be added in the future. Participate in discussion of this project on the Kronosaur Forums.
-
Download and install Python 3.7.0. During installation, ensure that the option to "Add Python 3.7.0 to PATH" is checked.
-
Open a terminal session (Command Prompt or PowerShell on Windows, Terminal on OS X or similar). Input:
python -V. The response should be:Python 3.7.0. If not, Python was not installed correctly. -
Input:
python -m pip install requests. This will install the "requests" module, required for anacreonlib functionality. -
Download this repository and save it to an easily accessible directory on your machine (e.g.
Desktop/terminus) -
Download the anacreonlib repository and save it to the Terminus directory (e.g.
Desktop/terminus/anacreonlib) -
Input:
python Desktop/terminus/terminus.py.
-
It is assumed that the user is playing on the latest Anacreon Beta game. At time of writing, this is the "Fallen Worlds: Era 4" scenario.
-
It is assumed that the user inputs valid commands (at least during the project's Alpha state). For example: if a world name is inputted, and no such world exists, Terminus will crash.
-
It is assumed that the user refreshes the game client page after running a script. Updates occur instantaneously, but often a refresh is required to view changes in game. Alternatively, updates will also be visible after watch change when the game client updates.
-
It is assumed that the user does not use the scripts provided with malicious intent.
The user is prompted to login once to their Multiverse account, after which their username and password is stored on a plaintext file to use with future logins. If login is successful, the main menu reports some statistics about their Empire, along with options to navigate to the following submenus:
Consolidate all fleets over a world: Transfers all fleets belonging to the player to a single one. Optionally, also transfer this merged fleet down to the world the individual fleets were previously orbiting.
Reinforce a world with fleets from shipyards: Deploy all units from each one of either: jumpship yards, starship yards or ramjet yards belonging to the player. Send each of these reinforcement fleets to a designated world.
Deploy a fleet with standing orders (coming soon): Deploy a fleet which will perform an action (at present, either "attack" or "invade") upon arrival at its destination. Requires script to keep running for at least as long as the fleet's transit time.
Purchase fleets from a Trader World: Purhase any number of ships of any class from a Mesophon Traders Union and deploy this new fleet to a designated world.
Create trade routes to import 100% of demand (coming soon): Create new import trade routes for a world or trade hub to be 100% of demand, importing the maximum possible amount for each supplier world within a 200 LY radius.
Build spaceports on all Imperial worlds: As described, starts construction of a spaceport on all owned worlds which are at or above TL5 (spacefaring) that still don't have one.
Transfer fleet to a non-Imperial world or fleet: Transfer a fleet to the world it orbits, even if the world belongs to another sovereign or is independent (i.e. a mechanism for "gifting" units to other players). Optionally, transfer this fleet to another non-Imperial fleet orbiting the same world.
Dispatch diplomatic envoys to all Sovereign Capitals: Deploys small fleets of explorers from an "embassy" world, to be sent to the Capital Worlds of all discovered Sovereigns. Note: this is common practice among players in the current meta.
Send a message to all Sovereigns: Relays a message from the player to all other players. At time of writing, the API limits this action to 120 calls per hour. Please use responsibly.
Dismiss all notifications: Clears all messages and notifications from the game client screen.
Display a list of all active Sovereigns: Print a list of all other players present in the game, sorted by relative Imperial Might, regardless if their capital has been discovered.
Display a list of Sovereigns in stagnation (coming soon): Print a list of all inactive players (defined as whose 'fleets' and 'worlds' statistics have not increased since the last update), sorted by Imperial Might.
Display the valid Rivals of our Empire: Print a sorted list of all players within 50% and 200% of the player's Imperial Might. Sovereigns with equal or greater Imperial Might are indicated with a warning icon.
"anacreonlib" by Ritik Mishra is used as a framework to make API calls.