war_alerts

Create and configure alerts for:

• War declarations
• War status updates
• Espionage
• Target availability
• Militarization
• Activity

Prerequisites

Register your alliance

/settings_default registeralliance alliances:

War Declarations

Defensive Wars

`/settings_war_alerts defense_war_channel`

### `/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

A discord channel name or mention

---

Configure defensive wars

Set the milcom role to ping

/role setalias locutusrole: MILCOM discordrole: @milcom

---

`/settings_war_alerts mention_milcom_filter`

### `/settings_war_alerts mention_milcom_filter` A nation filter to apply to limit what wars milcom gets pinged for.

Arguments:

<value> - NationFilter

A comma separated list of filters (can include nations and alliances)

---

`/settings_war_alerts show_ally_defensive_wars`

### `/settings_war_alerts show_ally_defensive_wars` Whether to show defensive war alerts for allies (true/false)

Arguments:

<enabled> - boolean

---

`/settings_war_alerts war_alert_for_offshores`

### `/settings_war_alerts war_alert_for_offshores` Whether to do war alerts for offshore alliances

Arguments:

<enabled> - boolean

---

`/settings_war_alerts hide_applicant_wars`

### `/settings_war_alerts hide_applicant_wars` Whether to hide war alerts for applicants

Arguments:

<value> - boolean

---

Offensive wars

`/settings_war_alerts offensive_war_channel`

### `/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

A discord channel name or mention

---

Configure offensive wars

Ping the foreign affairs role when there is a Locutus/Wiki/do_not_raid violation

/role setalias locutusrole: FOREIGN_AFFAIRS discordrole: @foreign_affairs

---

`/settings_war_alerts show_ally_offensive_wars`

### `/settings_war_alerts show_ally_offensive_wars` Whether to show offensive war alerts for allies (true/false)

Arguments:

<enabled> - boolean

---

War Status Updates

Peace

`/settings_war_alerts war_peace_alerts`

### `/settings_war_alerts war_peace_alerts` The #channel to receive alerts for changes to any war peace offers

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

Win/Lose

`/settings_war_alerts lost_war_channel`

### `/settings_war_alerts lost_war_channel` The #channel to post wars when our side loses a war

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

`/settings_war_alerts won_war_channel`

### `/settings_war_alerts won_war_channel` The #channel to post wars when our side wins a war (only includes actives)

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

Blockade

See: Locutus/Wiki/blockade_tools

Espionage

`/settings_default registerapikey`

### `/settings_default registerapikey` API key found at the bottom of: 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]

Multiple words or text separated by spaces Use quotes for multi-word arguments

---

`/settings_war_alerts espionage_alert_channel`

### `/settings_war_alerts espionage_alert_channel` The channel to get alerts when a member has their units spied successfully

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

Target alerts

Enemy Leaving Beige Alerts

`/settings_beige_alerts enemy_alert_channel`

### `/settings_beige_alerts enemy_alert_channel` The #channel to receive alerts when an enemy nation leaves beige

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

`/settings_beige_alerts enemy_alert_channel_mode`

### `/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

An alert mode for the ENEMY_ALERT_CHANNEL when enemies leave beige

---

`/settings_beige_alerts enemy_alert_filter`

### `/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

A comma separated list of filters (can include nations and alliances)

---

To opt out of enemy alerts:

/alerts enemy optout

Raiding Beige Alerts (raid targets)

/role setalias locutusrole: BEIGE_ALERT discordrole: @member

`/settings_beige_alerts beige_alert_channel`

### `/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

A discord channel name or mention

---

`/alerts beige beigealertoptout`

### `/alerts beige beigealertoptout` Opt out of beige alerts

This command has no arguments

---

`/alerts beige beigealertmode`

### `/alerts beige beigealertmode` Set the types of nations to receive automatic beige alerts for

Arguments:

<mode> - BeigeAlertMode

A mode for receiving alerts when a nation leaves beige

---

`/alerts beige beigealert`

### `/alerts beige beigealert` Set a reminder for when a nation leaves beige or VM

Arguments:

<targets> - Set

A comma separated list of nations, alliances and filters

[requiredLoot] - Double

Require targets to have at least this much loot Resources are valued at weekly market average prices (A decimal number)

[-s allowOutOfScore] - boolean

Allow targets this much ns below your score range

---

`/alerts beige beigealertrequiredloot`

### `/alerts beige beigealertrequiredloot` Set the required amount of loot for automatic beige alerts Defaults to $15m

Arguments:

<requiredLoot> - double

Require the target to have at least this much estimated loot Resources are valued at weekly market average prices (A decimal number)

---

`/alerts beige beigealertrequiredstatus`

### `/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

A discord status for receiving alerts when a nation leaves beige

---

`/alerts beige beigereminders`

### `/alerts beige beigereminders` List your current beige reminders

This command has no arguments

---

`/alerts beige removebeigereminder`

### `/alerts beige removebeigereminder` Remove your beige reminders

Arguments:

<nationsToRemove> - Set

A comma separated list of nations, alliances and filters

---

`/alerts beige setbeigealertscoreleeway`

### `/alerts beige setbeigealertscoreleeway` Allow receiving automatic beige alerts a certain nation score below your current war range

Arguments:

<scoreLeeway> - double

A decimal number

---

Treasure alerts

Militarization

`/settings_orbis_alerts activity_alerts`

### `/settings_orbis_alerts activity_alerts` The #channel to receive alerts for activity (e.g. pre blitz)

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

`/settings_orbis_alerts orbis_officer_mmr_change_alerts`

### `/settings_orbis_alerts orbis_officer_mmr_change_alerts` The #channel to receive alerts when gov members increase MMR (top 80)

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

`/settings_orbis_alerts aa_ground_unit_alerts`

### `/settings_orbis_alerts aa_ground_unit_alerts` The channel to send alerts when alliance ground units increase by 10% or more. See also setting `AA_GROUND_TOP_X` and coalition: `GROUND_ALERTS` and role alias: `GROUND_MILITARIZE_ALERT`

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

`/settings_orbis_alerts aa_ground_top_x`

### `/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

A whole number

---

`/settings_war_alerts enemy_mmr_change_alerts`

### `/settings_war_alerts enemy_mmr_change_alerts` The #channel to receive alerts when a member in `enemies` coalitions changes MMR

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

`/settings_orbis_alerts activity_alerts`

### `/settings_orbis_alerts activity_alerts` The #channel to receive alerts for activity (e.g. pre blitz)

Arguments:

<channel> - MessageChannel

A discord channel name or mention

---

Login Alerts

`/alerts login`

### `/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

nation id, name or url

[-w doNotRequireWar] - boolean

---