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

📚 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
A discord channel name or mention

---

Configure defensive wars

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
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

---

📚 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

---

📚 Whether to hide war alerts for applicants

/settings_war_alerts hide_applicant_wars

Whether to hide war alerts for applicants

Arguments:

<value> - boolean

---

Offensive wars

📚 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
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

---

📚 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

---

War Status Updates

Peace

📚 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
A discord channel name or mention

---

Win/Lose

📚 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
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
A discord channel name or mention

---

Blockade

See: Locutus/Wiki/blockade_tools

Espionage

📚 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]
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
A discord channel name or mention

---

Target alerts

Enemy Leaving Beige Alerts

📚 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
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
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
A comma separated list of filters (can include nations and alliances)

---

Roles

/role setalias locutusrole: BEIGE_ALERT discordrole: @member

Opt out of enemy alerts:

/alerts enemy optout

Raiding Beige Alerts (raid targets)

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

---

📚 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
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
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
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
A decimal number

---

Treasure alerts

📚 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
A discord channel name or mention

---

Roles

/role setalias locutusrole: TREASURE_ALERT discordrole: @treasure-alert

/role setalias locutusrole: TREASURE_ALERT_OPT_OUT discordrole: @no-alerts

Bounty 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
A discord channel name or mention

---

Roles

/role setalias locutusrole: BOUNTY_ALERT discordrole: @bounty-alert

/role setalias locutusrole: BOUNTY_ALERT_OPT_OUT discordrole: @no-alerts

Militarization

📚 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
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
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
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
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
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
A discord channel name or mention

---

Login Alerts

📚 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
nation id, name or url
[-w doNotRequireWar] - boolean

---