by Max Barry

Latest Forum Topics

Advertisement

56

DispatchMetaReference

by August. . 1,477 reads.

AugustinAndroid: World's First Global RMB Bot

Last updated on Saturday, August 28th, 2021. If you find this dispatch helpful, please upvote.


| ABOUT | CREATIVE USES | OPEN SOURCE | NSNEXUS | NSVERIFY | PRIVACY | PSEUDO-API | RMB COMMANDS | STATISTICS | STOCK EXCHANGE |



Wait, really?

Yes! AugustinAndroid v2 now responds to some of its commands when they are used on an RMB.

How does it work?

Any nation in any region in the world can use RMB commands. Just link The moose with [nation][/nation] tags in a post, and anything after the link will be interpreted as a command. You can use multiple commands at once by putting each one on a separate line in your post!

Once you have submitted the post, you will need to wait up to thirty seconds. You should receive a notification. Click it to go straight to the command response!

If nothing happens, there are two possibilities.
1. The command failed. Check your syntax, and make sure you were not requesting the endorsement list for a non-WA nation, or something of the sort.
2. You are not subscribed to RMB mentions. Go to your Subscriptions page and check the box for "RMB Mention." Then, go to AugustinAndroid and scroll to the most recent RMB post to see the response to your command.

Are there any limitations?

This system uses the NS API, which is subject to a rate limit. If the bot takes a little longer than usual to respond, it is probably handling a lot of commands at once, onsite and on Discord.

For now, a nation or region may not use more than 50 commands per hour, though it is possible to use more than that in a single message. This limit may be changed in the future.

I have a suggestion / I found a bug!

Please join the bot's Linksupport server, or use the ticket command on Discord or on an RMB. I am happy to add more commands to the list below if doing so is practical.

Return to top



nation [nation name]

Display general information about a nation.

Example: nation august


region [region name]

Display general information about a region.

Example: region cape of good hope


tgq

Display the number of stamp, API, and manual telegrams currently in the queue.


tgq_graph [start] [end] [query]

Graph the number of stamp, API, and manual telegrams in the queue over time.

Example: tgq_graph 01-08-21 now $a $m

Usage: The [start] argument can be "foundation" (for the foundation date of the oldest included region) or a date. The [end] argument can be "now" or a date. These arguments set the chronological boundaries of the graph. Dates must be formatted as DD-MM-YYYY, DD-MM-YY, DD/MM/YYYY, or DD/MM/YY, and can be no earlier than 22 Jun 2021. The [query] argument can include the following flags:
$a shows API telegrams.
$m shows manual telegrams.
$s shows stamp telegrams.
$c shows the combined queue (all telegrams).


endo [nation name]

List the nations endorsing and not endorsing a specific nation.

Example: endo augustin proxy


swap [nation name]

List the nations that a given nation is not endorsing.

Example: swap augustin proxy


del_swap [nation name]

List the nations that a given nation is not endorsing, that are also endorsing their delegate.

Example: del_swap augustin proxy


ncensus [census ID] [nation name]

Display a nation's World Census statistics.

Example: ncensus 3 august

Usage: Census IDs range from 0 to 86. Use the command world census for a list of all censuses by ID.


rcensus [census ID] [region name]

Display a region's World Census statistics.

Example: rcensus 3 cape of good hope

Usage: Census IDs range from 0 to 86. Use the command world census for a list of all censuses by ID.


world [query]

Display general information about the world.

Examples:
world
world rankings

Usage: The [query] argument is optional. If it is included, it can be "power" (view the boundaries of each Regional Power bracket and the number of regions in each), "census" (view a list of World Census statistics), "rankings" (view a list of all regions of High Regional Power and above sorted by influence and other metrics), or "delegates" (view a list of all delegates sorted by endorsements). If [query] is not included, the bot will display general information about the world.


votes_from_region [region name]

List the nations in the given region that are voting for or against the current WA proposal(s).

Example: votes_from_region ridgefield


reference

List reference materials from various parts of the game.


region_graph [start] [end] [census ID] [region names]

Graph aggregate census statistics over time for a region or regions.

Example: region_graph foundation 01-01-2017 66 ridgefield,,cape of good hope,,conch kingdom,,lands end $c

Usage: The [start] argument can be "foundation" (for the foundation date of the oldest included region) or a date. The [end] argument can be "now" or a date. These arguments set the chronological boundaries of the graph. Dates must be formatted as DD-MM-YYYY, DD-MM-YY, DD/MM/YYYY, or DD/MM/YY, and can be no earlier than 29 Feb 2016. The [census ID] argument can be any integer corresponding to a World Census. Not all censuses, such as Civil Rights, actually make sense as aggregates. The [region names] argument can be any region or group of regions, separated by double commas (,,). This argument can include the following flags:
$c adds together the data for all included regions and plots the combined data as its own series in addition to those of the individual regions.
$w samples the data once per week instead of once per day.
$d displays the delta between the values for each day (or week, if the $w flag is included) instead of the values themselves.


region_csv [census ID] [region names]

Generate a CSV file containing a region's (or regions') aggregate census statistics over time.

Example: region_csv 65 conch kingdom

Usage: The [census ID] argument can be any integer corresponding to a World Census. Not all censuses, such as Civil Rights, actually make sense as aggregates. The [region names] argument can be any region or group of regions, separated by double commas (,,). This argument can include the following flags:
$c adds together the data for all included regions and plots the combined data as its own series in addition to those of the individual regions.
$w samples the data once per week instead of once per day.
$d displays the delta between the values for each day (or week, if the $w flag is included) instead of the values themselves.


region_activity [region name]

Graph a region's login activity distribution.

Example: region_activity lands end

Usage: By default, this data includes all nations in the given region. To remove non-WA nations, include the $wa flag anywhere in the [region] argument. To display percentages instead of absolute values, include the $per flag anywhere in the [region] argument.


world_graph [query]

Graph worldwide statistics over time.

Example: world_graph wa_nations

Usage: [query] can be "wa_nations," "nations," "delegates," "delegate_votes," "total_voting_power," "wa%," "endos," "influence," "regions," "population," "economic_output," or one of the Regional Power ratings ("moderate," "high," "very_high," or "extremely_high").


world_csv [query]

Generate a CSV file containing the world's aggregate census statistics over time.

Example: world_csv endos

Usage: [query] can be "wa_nations," "nations," "wa%," "endos," "influence," "regions," "population," "economic_output," or one of the Regional Power ratings ("moderate," "high," "very_high," or "extremely_high").


world_activity [query]

Graph the world's login activity distribution.

Example: world_activity $wa $per

Usage: The [query] argument is optional. If it includes the flag $wa, only WA nations will be included in the data. If it includes the flag $per, percentages will be displayed instead of absolute values.


warn [nation: reason]

Record a warning for a nation, notifying them.

Example: warn august: Spamming the RMB

Usage: The reason is optional. A nation's warning history in a particular region can be retrieved by calling casefile [nation name] in that region. Only a nation with Executive, Appearance, Border Control, or Communications authority can warn other nations. Only a nation residing in a region can be warned in that region.


casefile [nation name]

View a nation's RMB moderation record in the region.

Example: >casefile august

Usage: Only a nation with Executive, Appearance, Border Control, or Communications authority can retrieve a nation's casefile.


ticket [description]

Submit a support ticket to the developer.

Example: ticket The nation command failed to respond.

Usage: Please be clear and precise when reporting errors. Avoid saying things like "the bot broke."


rng [lower bound] [upper bound]

Choose a random number between two numbers.

Example: rng 10 100

Usage: Arguments must be non-negative integers, to a maximum of 1E308. Both numbers are included in the selection range. The lower bound must be less than the upper bound.


rmb_rankings [region name]

Rank the top ten nations of all time in a region by RMB post count, RMB likes given, and RMB likes received.

Example: rmb_rankings cape of good hope

Return to top

Created by August. Do not reproduce, in whole or in part, without explicit permission.

August

Edited:

RawReport