-
Notifications
You must be signed in to change notification settings - Fork 5
war_alerts
Create and configure alerts for:
- War declarations
- War status updates
- Espionage
- Target availability
- Militarization
- Activity
Register your alliance
/settings_default registeralliance alliances:
| 📚 The #channel to receive alerts for defensive wars... |
|---|
/settings_war_alerts defense_war_channel
The #channel to receive alerts for defensive wars
Members and MILCOM are pinged for defensive wars
To set the MILCOM role, see: /role setalias locutusrole: MILCOM discordrole:
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
Set the milcom role to ping
/role setalias locutusrole: MILCOM discordrole: @milcom
| 📚 A nation filter to apply to limit what wars milcom gets pinged for. |
|---|
/settings_war_alerts mention_milcom_filter
A nation filter to apply to limit what wars milcom gets pinged for.
Arguments:
<value> - [NationFilter](arguments#nationfilter)
A comma separated list of filters (can include nations and alliances)
| 📚 Whether to show defensive war alerts for allies (true/false) |
|---|
/settings_war_alerts show_ally_defensive_wars
Whether to show defensive war alerts for allies (true/false)
Arguments:
<enabled> - [boolean](arguments#boolean)
| 📚 Whether to do war alerts for offshore alliances |
|---|
/settings_war_alerts war_alert_for_offshores
Whether to do war alerts for offshore alliances
Arguments:
<enabled> - [boolean](arguments#boolean)
| 📚 Whether to hide war alerts for applicants |
|---|
/settings_war_alerts hide_applicant_wars
Whether to hide war alerts for applicants
Arguments:
<value> - [boolean](arguments#boolean)
| 📚 The #channel to receive alerts for offensive wars... |
|---|
/settings_war_alerts offensive_war_channel
The #channel to receive alerts for offensive wars
Members and FOREIGN_AFFAIRS role are pinged for Do Not Raid (DNR) violations
To set the FOREIGN_AFFAIRS role, see: /role setalias locutusrole: FOREIGN_AFFAIRS discordrole:
Wars against inactive nones do not create alerts
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
Ping the foreign affairs role when there is a Locutus/Wiki/do_not_raid violation
/role setalias locutusrole: FOREIGN_AFFAIRS discordrole: @foreign_affairs
| 📚 Whether to show offensive war alerts for allies (true/false) |
|---|
/settings_war_alerts show_ally_offensive_wars
Whether to show offensive war alerts for allies (true/false)
Arguments:
<enabled> - [boolean](arguments#boolean)
| 📚 The #channel to receive alerts for changes to any war peace offers |
|---|
/settings_war_alerts war_peace_alerts
The #channel to receive alerts for changes to any war peace offers
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The #channel to post wars when our side loses a war |
|---|
/settings_war_alerts lost_war_channel
The #channel to post wars when our side loses a war
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The #channel to post wars when our side wins a war (only includes actives) |
|---|
/settings_war_alerts won_war_channel
The #channel to post wars when our side wins a war (only includes actives)
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
See: Locutus/Wiki/blockade_tools
| 📚 API key found at the bottom of: https://politicsandwar.com/account/... |
|---|
/settings_default registerapikey
API key found at the bottom of: https://politicsandwar.com/account/
Be sure to enable all access you wish the bot to have, and have a sufficient position in-game (e.g. leader)
Needed for alliance functions and information access, such as calculating resource dispersal, sending mail
Arguments:
<apiKeys> - [List[TextArea]](arguments#liststringtextarea)
Multiple words or text separated by spaces
Use quotes for multi-word arguments
| 📚 The channel to get alerts when a member has their units spied successfully |
|---|
/settings_war_alerts espionage_alert_channel
The channel to get alerts when a member has their units spied successfully
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The #channel to receive alerts when an enemy nation leaves beige... |
|---|
/settings_beige_alerts enemy_alert_channel
The #channel to receive alerts when an enemy nation leaves beige
Requirements for receiving alerts:
- Must have the BEIGE_ALERT or ENEMY_ALERT_OFFLINE role
- Be in range (score)
- active in the past 24h- Have a free offensive war slot
- Have at least 70% of the target's military
- Are online, away, or DND on discord, or have the ENEMY_ALERT_OFFLINE role
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The mode for the enemy alert channel to determine what alerts are posted and who is pinged... |
|---|
/settings_beige_alerts enemy_alert_channel_mode
The mode for the enemy alert channel to determine what alerts are posted and who is pinged
Options:
- PING_USERS_IN_RANGE
- PING_ROLE_IN_RANGE
- PING_ROLE_ALL
Arguments:
<mode> - [EnemyAlertChannelMode](arguments#enemyalertchannelmode)
An alert mode for the ENEMY_ALERT_CHANNEL when enemies leave beige
| 📚 A filter for enemies to alert on when they leave beige... |
|---|
/settings_beige_alerts enemy_alert_filter
A filter for enemies to alert on when they leave beige
Defaults to #active_m<7200 (active in the past 5 days)
Arguments:
<filter> - [NationFilter](arguments#nationfilter)
A comma separated list of filters (can include nations and alliances)
/role setalias locutusrole: BEIGE_ALERT discordrole: @member
/alerts enemy optout
/role setalias locutusrole: BEIGE_ALERT discordrole: @member
| 📚 The #channel to receive alerts when a raid target leaves beige.... |
|---|
/settings_beige_alerts beige_alert_channel
The #channel to receive alerts when a raid target leaves beige./role setalias locutusrole: BEIGE_ALERT must also be set and have members in range
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 Opt out of beige alerts |
|---|
/alerts beige beigealertoptout
Opt out of beige alerts
This command has no arguments
| 📚 View and test that the current automatic beige alert settings allow for notification |
|---|
/alerts beige test_auto
View and test that the current automatic beige alert settings allow for notification
This command has no arguments
| 📚 Set the types of nations to receive automatic beige alerts for |
|---|
/alerts beige beigealertmode
Set the types of nations to receive automatic beige alerts for
Arguments:
<mode> - [BeigeAlertMode](arguments#beigealertmode)
A mode for receiving alerts when a nation leaves beige
| 📚 Set a reminder for when a nation leaves beige or VM |
|---|
/alerts beige beigealert
Set a reminder for when a nation leaves beige or VM
Arguments:
<targets> - [Set](arguments#setdbnation)
A comma separated list of nations, alliances and filters[requiredLoot] - [Double](arguments#double)
Require targets to have at least this much loot
Resources are valued at weekly market average prices
(A decimal number)[-s allowOutOfScore] - [boolean](arguments#boolean)
Allow targets this much ns below your score range
| 📚 Set the required amount of loot for automatic beige alerts... |
|---|
/alerts beige beigealertrequiredloot
Set the required amount of loot for automatic beige alerts
Defaults to $15m
Arguments:
<requiredLoot> - [double](arguments#double)
Require the target to have at least this much estimated loot
Resources are valued at weekly market average prices
(A decimal number)
| 📚 Only get the automatic beige alerts if you have the online status on discord... |
|---|
/alerts beige beigealertrequiredstatus
Only get the automatic beige alerts if you have the online status on discord
Note: You will still receive alerts for targets you have subscribed to via /alerts beige beigereminders
Arguments:
<status> - [BeigeAlertRequiredStatus](arguments#beigealertrequiredstatus)
A discord status for receiving alerts when a nation leaves beige
| 📚 List your current beige reminders |
|---|
/alerts beige beigereminders
List your current beige reminders
This command has no arguments
| 📚 Remove your beige reminders |
|---|
/alerts beige removebeigereminder
Remove your beige reminders
Arguments:
<nationsToRemove> - [Set](arguments#setdbnation)
A comma separated list of nations, alliances and filters
| 📚 Allow receiving automatic beige alerts a certain nation score below your current war range |
|---|
/alerts beige setbeigealertscoreleeway
Allow receiving automatic beige alerts a certain nation score below your current war range
Arguments:
<scoreLeeway> - [double](arguments#double)
A decimal number
| 📚 The channel to receive alerts when a treasure moves to another nation or is about to reset |
|---|
/settings_bounty treasure_alert_channel
The channel to receive alerts when a treasure moves to another nation or is about to reset
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
/role setalias locutusrole: TREASURE_ALERT discordrole: @treasure-alert
/role setalias locutusrole: TREASURE_ALERT_OPT_OUT discordrole: @no-alerts
| 📚 The channel to receive alerts when a bounty is placed |
|---|
/settings_bounty bounty_alert_channel
The channel to receive alerts when a bounty is placed
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
/role setalias locutusrole: BOUNTY_ALERT discordrole: @bounty-alert
/role setalias locutusrole: BOUNTY_ALERT_OPT_OUT discordrole: @no-alerts
| 📚 The #channel to receive alerts for activity (e.g. pre blitz) |
|---|
/settings_orbis_alerts activity_alerts
The #channel to receive alerts for activity (e.g. pre blitz)
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The #channel to receive alerts when gov members increase MMR (top 80) |
|---|
/settings_orbis_alerts orbis_officer_mmr_change_alerts
The #channel to receive alerts when gov members increase MMR (top 80)
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The channel to send alerts when alliance ground units increase by more than 2.5%... |
|---|
/settings_orbis_alerts aa_ground_unit_alerts
The channel to send alerts when alliance ground units increase by more than 2.5%
See also setting AA_GROUND_TOP_X and coalition: GROUND_ALERTS and role alias: GROUND_MILITARIZE_ALERT
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 Only do alliance ground unit alerts for the top X alliances (by active member score) |
|---|
/settings_orbis_alerts aa_ground_top_x
Only do alliance ground unit alerts for the top X alliances (by active member score)
Arguments:
<topX> - [int](arguments#int)
A whole number
📚 The #channel to receive alerts when a member in enemies coalitions changes MMR |
|---|
/settings_war_alerts enemy_mmr_change_alerts
The #channel to receive alerts when a member in enemies coalitions changes MMR
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 The #channel to receive alerts for activity (e.g. pre blitz) |
|---|
/settings_orbis_alerts activity_alerts
The #channel to receive alerts for activity (e.g. pre blitz)
Arguments:
<channel> - [MessageChannel](arguments#messagechannel)
A discord channel name or mention
| 📚 Get an alert on discord when a target logs in within the next 5 days... |
|---|
/alerts login
Get an alert on discord when a target logs in within the next 5 days
Useful if you want to know when they might defeat you in war or perform an attack
Arguments:
<target> - [DBNation](arguments#dbnation)
nation id, name or url[-w doNotRequireWar] - [boolean](arguments#boolean)