NATION

PASSWORD

5

DispatchMetaReference

by The Dichromatic Mechanism of August. . 104 reads.

Command Tables and Reference


server_edit

Attribute

Value

"name"

Any text of 100 characters or less that is not already the server's name.

"icon"

Any direct link to a hosted image with the file extension .png, .jpg, or .gif.

"afk_channel"

The name or ID of any voice channel on the server.

"afk_timeout"

1, 5, 15, 30, or 60 (minutes).

"verification" or "verification_level"

"None," "low," "medium," "high" or "table_flip," or "extreme" or "double_table_flip."

"default_notifications," "notifications," "default_notification," or "notification"

"All messages" or "only mentions."

"explicit_content_filter," "explicit_content," "content_filter," or "content"

"Disabled," "no role," or "all members."

"system_channel"

The name, #mention, or ID of any text channel on the server.

"vanity," "vanity_code," or "vanity_url"

Any text (special feature).

"description"

Any text (special feature).

"banner"

Any direct link to a hosted image with the file extension .png, .jpg, or .gif (special feature).

"splash" or "invite_splash"

Any direct link to a hosted image with the file extension .png, .jpg, or .gif (special feature).

"rules" or "rules_channel"

The name, #mention, or ID of any text channel on the server (special feature).

"updates," "public_updates," or "public_updates_channel"

The name, #mention, or ID of any text channel on the server (special feature).


alias

Flag

Effect

%suppress

Hides non-essential output from the command, such as "Done."

%delete

Instantly deletes the message containing the alias.

%admin

Limits the alias to members in the Administrator permissions tier, overriding the base command's normal permissions requirement. Permissions flags like this one cannot be combined with each other.

%mod

Limits the alias to Moderators and above.

%power

Limits the alias to Power Users and above.

%standard

Allows any member to use the alias.

%nospace

Causes the whitespace between the alias and any arguments provided to be removed. This is typically used in aliases that post a link that is modified by user arguments, because an ordinary space would break the link. This flag is incompatible with %noargs.

%noargs

Causes any arguments provided to the alias to be ignored. This flag is incompatible with %nospace.

%url

Causes any spaces in arguments provided to the alias to be replaced with the URL-friendly space character %20. This is typically used in aliases that post a link that is modified by user arguments, because an ordinary space would break the link. This flag can only be used in combination with the %nospace flag or the %argX substitution variables.

%hide_schedule

Prevents the scheduled command from appearing in the user's list of scheduled commands, as seen with >view_scheduled. This flag only has an effect on aliases of >schedule and >schedule_absolute. It is useful if a server's administrators want to set up an alias or trigger that causes standard users to schedule a task, and do not want those users to be able to cancel that task.

%toggle_mod_logs

Toggles the bot's Moderation Logging setting, just for that alias instead of server-wide. This flag only has an effect on aliases of >mute, >kick, and >ban. For example, if the setting is enabled and this flag is used with an alias of >mute, the bot skips the prompt for a reason, and simply mutes the target member. This is especially useful for creating triggers.

%toggle_hierarchy

Toggles the bot's Respect Hierarchy setting, just for that alias instead of server-wide. For example, if the setting is enabled and the flag is used with an alias of >remove_role, the bot will remove the given role even if it is above the command author's highest role.

%toggle_permissions

Toggles the bot's Respect Permissions setting, just for that alias instead of server-wide. For example, if the setting is enabled and the flag is used with an alias of >post, the bot will post a message in the given channel even if the command author does not have permission to send messages there.

If the %admin, %mod, %power, %standard, %suppress, %hide_schedule, %toggle_mod_logs, %toggle_hierarchy, or %toggle_permissions flags are used in an alias of >combine, or of any command that calls other commands, the flags will apply to those other commands as well. For example, >alias add test1 combine post here Testing,,react above ⏫ %standard would create an alias usable by any member, even though all three commands are normally limited to Power Users.

Substitution Variable

Replacement

%author_id

The ID of the user who called the alias

%author_name

The name of the user who called the alias

%channel_id

The ID of the channel where the alias was called

%channel_name

The name of the channel where the alias was called

%server_id

The ID of the server where the alias was called

%server_name

The name of the server where the alias was called

%message_id

The ID of the message containing the alias

%last_message_id

The ID of the last message in the current channel

%date

The current date, formatted like "Monday, October 07, 2019"

%time

The current date and time, formatted like "07 Oct 2019 14:34:09 UTC"

%member_count

The server's member count

%prefix

The bot's command prefix on the server

%%USER_ID:key%%

The value from one of a member's saved key/value pairs on the server, as set with >edit_user_data and viewed with >view_data. USER_ID should be replaced with the ID of a member of the server, and key should be replaced with one of their saved keys. If the ID does not belong to a server member, the substitution will not take place, and if the given key is not one of the member's saved keys, the phrase "(not found)" will be substituted. If the key is set to a null value, the phrase "(null)" will be substituted.

When the saved value is a list
If the list is empty, this variable will return "(empty list)". Otherwise, it will return all the values in the list, separated by double commas. If the flag ->first is placed at the end of the key, the first value of the list will be returned. If ->last is placed at the end, the last value will be returned.
key: "animals"
value: []
%%213088304537534464:animals%% ⇒ "(empty list)"
value: [dogs, cats, horses, pigs]
%%213088304537534464:animals%% ⇒ "dogs,,cats,,horses,,pigs"
%%213088304537534464:animals->first%% ⇒ "dogs"
%%213088304537534464:animals->last%% ⇒ "pigs"

%argX, where X is any integer greater than zero

The argument provided to the alias in position X. This allows you to reposition arguments and use them multiple times in a single command. When using these variables, arguments cannot contain spaces except for the last argument, which can have any number of words.

Many commands allow you to use object IDs instead of names in arguments. Unlike names, IDs never change and never contain spaces. If you need to mention a user, role, or channel, you can use the strings <@USER_ID>, <@&ROLE_ID>, or <#CHANNEL_ID> respectively, replacing the middle text with the actual ID.


text_trigger

Flag

Effect

%case_sensitive

Requires the message text to match the case of the trigger phrase. Without it, the text "abc" will match the trigger "B".

%message_equals

Requires the message text to match the trigger phrase exactly. Without it, the text "Bleep bloop!!" matches the trigger phrase "Bleep bloop".

%message_contains

Requires the message text to contain the trigger phrase. If neither %message_equals nor %message_in are included, this flag is implied, even if it is not included.

%is_word

Requires the message text to contain a word that exactly matches the trigger phrase. This flag cannot be used with a trigger phrase that contains spaces, or with the %message_equals or %message_in flags. Without it, the text "cat in the hat" will match the trigger word "at".

%message_in

Requires the message text to exist within the trigger phrase.


settings

Submenu

Settings

NSVerify

NSVerify (NSV) is a powerful feature that runs in the background and manages all your server's NS-related roles. You can change its settings here.

  • Assign regional resident roles

  • Assign standard NSV roles

  • Toggle whether verification is required for entry

  • Toggle whether residency in the server's region(s) is required for entry

  • Toggle whether unverified members are automatically kicked after one week

  • Toggle whether multiple accounts on the server may have the same nation verified

  • Toggle whether Watchlist alerts are sent to the server

Event Logging

The bot can log sixteen types of server events. You can choose the channel where each type of server event is logged, if any, or set or disable all the events at once. The events are as follows.

  • Message deleted

  • Message edited

  • Messages bulk-deleted

  • Channel created

  • Channel updated

  • Role created

  • Role deleted

  • Role updated

  • Server updated

  • Emojis updated

  • Member arrived

  • Member departed

  • Member updated (roles or nickname)

  • User banned

  • User unbanned

Arrivals, Departures, Returns, and Bans

The bot can act in response to member arrivals, departures, returns, and bans. You can choose these responses as follows.

  • Whether the bot restores a departed member's previous roles when they return to the server

  • Which roles, if any, the bot assigns automatically to all incoming members

  • What password, if any, the bot requires all incoming members to provide before they can see the server

  • The channel where arrival messages are sent, if any

  • The arrival message, which can include substitution variables

  • The channel where departure messages are sent, if any

  • The departure message, which can include substitution variables

  • The channel where return messages are sent, if any

  • The return message, which can include substitution variables

  • The channel where ban messages are sent, if any

  • The ban message, which can include substitution variables

Substitution Variables
$m ⇒ the name of the member who joined
$s ⇒ the server's name
$c ⇒ the server's member count
$d ⇒ the current date
$a ⇒ the member's age, formatted as "01 Aug 21 (25 days ago)"

Special Channels

You can choose which channels are designated as the following special channels, if any.

  • General, where the bot sends messages intended for the general public

  • Staff, where the bot sends messages intended for server staff

  • Lobby, where unverified members are confined if verification is required for entry

Permissions Roles

You can choose which roles fall into each of the following permissions tiers, which determine who can use higher-level commands.

  • Power User, for commands that require a small degree of trust

  • Moderator, for commands that can affect other members and require a medium degree of trust

  • Administrator, for commands that can affect all aspects of the server and require a high degree of trust

Request Roles

Members of the server can use the >request command to add or remove certain roles to or from themselves. You can choose which roles are available for use with that command. You can also create mutually-exclusive groups of roles (MuEx). If a member adds a MuEx role to themselves, they will lose all other roles in that group, if they had any. A role cannot be in more than one MuEx group, and if it is in one, it cannot be on the list outside that group.

Bot Settings

You can change the following miscellaneous settings.

  • Reset the bot's configuration for the server

  • Set the bot's command prefix for the server

  • Toggle whether commands respect server hierarchy

  • Toggle whether commands respect author permissions

  • Toggle whether logs are kept for >mute, >kick, and >ban

Custom Settings

If you have a custom bot, you can change the following account settings. The username and avatar settings are subject to a one-hour cooldown on every third change, and enabling message backups can only be done once every twelve hours.

  • Set the bot's username

  • Set the bot's avatar

  • Set the bot's activity, such as "Playing >help"

  • Set the bot's online/offline/idle/do-not-disturb status

  • Toggle message backup

  • Set a channel where the bot should forward its private messages

RawReport