Skip to content

war_alerts

xdnw edited this page Sep 5, 2023 · 14 revisions

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
Api Key Example

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

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)

To 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


📚 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

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 10% or more....
/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

📚 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


Clone this wiki locally