Skip to content

nation_placeholders

Jump to bottom
xdnw edited this page Dec 9, 2023 · 76 revisions

Placeholder Syntax

  • <arg> - A required parameter

  • [arg] - An optional parameter

  • <arg1|arg2> - Multiple parameters options

  • <arg=value> - Default or suggested value

  • [-f flag] - A optional command argument flag

Example discord usage

For placeholders {getLand}

For filters #getLand>30

Use round brackets for arguments #myFunction(123)

Placeholders

#allianceSeniority

Days since joining the alliance

This command has no arguments

Permission:

#allianceSeniorityMs

Milliseconds since joining the alliance

This command has no arguments

Permission:

#attritionBountyValue

This command is public

Sum of all attrition bounties placed on them

This command has no arguments

#avg_daily_login

This command is public

Decimal pct of days they login

This command has no arguments

#avg_daily_login_turns

This command is public

Decimal pct of turns they login

This command has no arguments

#avg_daily_login_week

This command is public

Decimal pct of days they login in the past week

This command has no arguments

#canBeDeclaredOnByScore

This command is public

Can be declared on by a nation of score

Arguments:

<score> - double

A decimal number

#canBeSpiedByScore

This command is public

Can be spied by a nation of score

Arguments:

<score> - double

A decimal number

#canDeclareOnScore

This command is public

Can declare war on a nation of score

Arguments:

<score> - double

A decimal number

#canSpyOnScore

This command is public

Can perform a spy attack against a nation of score

Arguments:

<score> - double

A decimal number

#cellLookup

Sheet lookup

Arguments:

<sheet> - SpreadSheet

A google spreadsheet id or url For shorthand, use a comma when specifying the sheet tab e.g. sheet:ID,TAB_NAMEFor a url, append #gid=1234 or #tab=tabName to specify the id of the tab to use

<tabName> - String

A single line of text

<columnSearch> - String

<columnOutput> - String

<search> - String

Permission:

#city

This command is public

Renamed to cityurl

Arguments:

<index> - int

A whole number

#cityUrl

This command is public

Get the city url by index

Arguments:

<index> - int

A whole number

#correctAllianceMMR

If on the correct MMR for their alliance (if one is set)

This command has no arguments

Permission:

#countWars

This command is public

Number of wars matching a filter

Arguments:

<warFilter> - Predicate<DBWar>

#daysSince3ConsecutiveLogins

This command is public

Days since the last three consecutive daily logins

This command has no arguments

#daysSince4ConsecutiveLogins

This command is public

Days since the last four consecutive daily logins

This command has no arguments

#daysSince5ConsecutiveLogins

This command is public

Days since the last five consecutive daily logins

This command has no arguments

#daysSince6ConsecutiveLogins

This command is public

Days since the last six consecutive daily logins

This command has no arguments

#daysSince7ConsecutiveLogins

This command is public

Days since the last seven consecutive daily logins

This command has no arguments

#daysSinceConsecutiveLogins

This command is public

Days since last specified consecutive daily logins

Arguments:

<checkPastXDays> - long

A whole number

<sequentialDays> - int

#daysSinceLastAircraftBuy

This command is public

Days since last aircraft purchase

This command has no arguments

#daysSinceLastBankDeposit

This command is public

Days since last bank deposit

This command has no arguments

#daysSinceLastDefensiveWarLoss

This command is public

Days since last defensive war

This command has no arguments

#daysSinceLastMissileBuy

This command is public

Days since last missile purchase

This command has no arguments

#daysSinceLastNukeBuy

This command is public

Days since last ship purchase

This command has no arguments

#daysSinceLastOffensive

This command is public

Days since their last offensive war

This command has no arguments

#daysSinceLastShipBuy

This command is public

Days since last ship purchase

This command has no arguments

#daysSinceLastSoldierBuy

This command is public

Days since last soldier purchase

This command has no arguments

#daysSinceLastSpyBuy

This command is public

Days since last spy purchase

This command has no arguments

#daysSinceLastTankBuy

This command is public

Days since last tank purchase

This command has no arguments

#daysSinceLastWar

This command is public

Days since last war

This command has no arguments

#equilibriumTaxRate

The alliance tax rate necessary to break even when distributing raw resources

This command has no arguments

Permission:

#estimateGNI

This command is public

Estimated daily Gross National Income (GNI)

This command has no arguments

#getActive_m

This command is public

Minutes since last active in-game

This command has no arguments

#getAgeDays

This command is public

Days since creation

This command has no arguments

#getAircraft

This command is public

Number of aircraft

This command has no arguments

#getAircraftPct

This command is public

Decimal ratio of aircraft a nation has out of their maximum (between 0 and 1)

This command has no arguments

#getAllTimeDefensiveWars

All time defensive wars involved in

This command has no arguments

Permission:

#getAllTimeOffDefWars

No description provided

This command has no arguments

Permission:

#getAllTimeOffensiveWars

All time offensive wars involved in

This command has no arguments

Permission:

#getAllTimeWars

All time wars involved in

This command has no arguments

Permission:

#getAllianceDepositValue

Net nation deposits with their alliance guild

This command has no arguments

Permission:

#getAllianceDepositValuePerCity

Net nation deposits with their alliance guild divided by their city count

This command has no arguments

Permission:

#getAllianceName

This command is public

Alliance Name

This command has no arguments

#getAlliancePositionId

This command is public

Globally unique id of the position in the alliance

This command has no arguments

#getAllianceRank

This command is public

Alliance rank by score

Arguments:

[filter] - NationFilter

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

#getAllianceUrl

This command is public

Game url for alliance

This command has no arguments

#getAlliance_id

This command is public

Alliance ID

This command has no arguments

#getAttacking

This command is public

Get the number of active offensive wars with a list of nations

Arguments:

<nations> - Set<DBNation>

A comma separated list of nations, alliances and filters

#getAvgBarracks

This command is public

Get number of barracks Shorthand for getAvgBuilding(barracks)

This command has no arguments

#getAvgBuilding

This command is public

Get number of buildings

Arguments:

<building> - Building

A city building type

#getAvgBuildings

This command is public

Number of buildings per city

Arguments:

[buildings] - Set<Building>

A comma separated list of building types

#getAvgDrydocks

This command is public

Get number of drydocks Shorthand for getAvgBuilding(drydock)

This command has no arguments

#getAvgFactories

This command is public

Get number of factories Shorthand for getAvgBuilding(factory)

This command has no arguments

#getAvgHangars

This command is public

Get number of hangars Shorthand for getAvgBuilding(hangar)

This command has no arguments

#getAvgLand

This command is public

Average land per city

This command has no arguments

#getAvg_infra

This command is public

average infrastructure in cities

This command has no arguments

#getBeigeAbsoluteTurn

This command is public

The absolute turn of leaving beige

This command has no arguments

#getBeigeLootTotal

Total stockpile value based on last war loss or espionage

This command has no arguments

Permission:

#getBeigeTurns

This command is public

Game turns left on the beige color bloc

This command has no arguments

#getBlockadedBy

This command is public

List of nation ids which are blockading this nation with their navy ships in-game

This command has no arguments

#getBlockading

This command is public

List of nation ids whuch are blockaded by this nation's navy ships in-game

This command has no arguments

#getBountySums

This command is public

Get a map of each war type to the total value of bounties for that type that this nation has

This command has no arguments

#getBuildings

This command is public

Number of buildings total

Arguments:

[buildings] - Set<Building>

A comma separated list of building types

#getCities

This command is public

Number of built cities

This command has no arguments

#getCitiesAt

This command is public

Number of cities at a date

Arguments:

<time> - long[Timestamp]

A unix timestamp, a DMY date or a time difference that will resolve to a timestamp from the current date

#getCitiesSince

This command is public

Number of cities built since date

Arguments:

<time> - long[Timestamp]

A unix timestamp, a DMY date or a time difference that will resolve to a timestamp from the current date

#getCityCostPerCitySince

This command is public

Cost of cities built since a date divided by the current city count

Arguments:

<time> - long[Timestamp]

A unix timestamp, a DMY date or a time difference that will resolve to a timestamp from the current date

<allowProjects> - boolean

#getCityCostSince

This command is public

Cost of cities built since a date

Arguments:

<time> - long[Timestamp]

A unix timestamp, a DMY date or a time difference that will resolve to a timestamp from the current date

<allowProjects> - boolean

#getCityGroup

This command is public

Get the min city count of the first matching city range c1-10, c11-15

Arguments:

<ranges> - CityRanges

A range of city counts (inclusive)

#getCityTimerAbsoluteTurn

This command is public

Absolute turn the city time ends before being able to buy a city

This command has no arguments

#getCityTurns

This command is public

Turns left on the city timer

This command has no arguments

#getColor

This command is public

Nation color bloc

This command has no arguments

#getColorAbsoluteTurn

This command is public

The absolute turn the color change timer expires

This command has no arguments

#getColorTurns

This command is public

The number of turns until the color timer expires

This command has no arguments

#getContinent

This command is public

Continent

This command has no arguments

#getDate

This command is public

Unix timestamp of date created

This command has no arguments

#getDaysSinceLastSpyReport

This command is public

Days since a nation posted a spy report

This command has no arguments

#getDc_turn

This command is public

The turn of the day (0-11) when their day change (DC) unit rebuy is available

This command has no arguments

#getDef

This command is public

Number of active defensive wars

This command has no arguments

#getDefending

This command is public

Get the number of active defensive wars with a list of nations

Arguments:

<nations> - Set<DBNation>

A comma separated list of nations, alliances and filters

#getDomesticPolicy

This command is public

Domestic policy

This command has no arguments

#getDomesticPolicyAbsoluteTurn

This command is public

The absolute turn the domestic policy change timer expires

This command has no arguments

#getDomesticPolicyTurns

This command is public

The number of turns until the domestic policy timer expires

This command has no arguments

#getEnemies

This command is public

Set of nation ids fighting this nation

This command has no arguments

#getEnemyStrength

This command is public

Estimated combined strength of the enemies its fighting

This command has no arguments

#getEntered_vm

This command is public

Absolute turn number when entering Vacation Mode (VM)

This command has no arguments

#getEspionageFullTurn

This command is public

Absolute turn when full espionage slots will reset

This command has no arguments

#getFighting

This command is public

Get the number of active wars with a list of nations

Arguments:

<nations> - Set<DBNation>

A comma separated list of nations, alliances and filters

#getFreeBuildings

This command is public

Get total free building slots in this nations cities

This command has no arguments

#getFreeOffensiveSlots

This command is public

Free offensive war slots

This command has no arguments

#getFreeProjectSlots

This command is public

Number of free project slots

This command has no arguments

#getGNI

This command is public

Their gross income (GNI)

This command has no arguments

#getGroundStrength

This command is public

Effective ground strength with munitions, enemy air control, and daily rebuy

Arguments:

<munitions> - boolean

<enemyAc> - boolean

[includeRebuy] - Double

A decimal number

#getId

This command is public

The nation id

This command has no arguments

#getInfra

This command is public

Total infra in all cities

This command has no arguments

#getLastUnitBuy

Get unix timestamp of when a unit was purchased last

Arguments:

<unit> - MilitaryUnit

Military unit name

Permission:

#getLeader

This command is public

Leader name

This command has no arguments

#getLeaving_vm

This command is public

Absolute turn number when leaving Vacation Mode (VM)

This command has no arguments

#getLootRevenueTotal

This command is public

No description provided

This command has no arguments

#getMMR

This command is public

Average military unit building capacity (unit mmr) in all cities as a whole number soldiers tanks aircraft ships Maximum is: 5553

This command has no arguments

#getMMRBuildingArr

This command is public

Array of the average military buildings (building mmr) in all cities as a decimal [barracks, factories, hangars, drydocks] e.g. [5.0,5.0,5.0,3.0]

This command has no arguments

#getMMRBuildingStr

This command is public

The average military buildings (building mmr) in all cities as a whole number barracks factories hangars drydocks Maximum is: 5553

This command has no arguments

#getMaxOff

This command is public

Maximum offensive war slots

This command has no arguments

#getMissiles

This command is public

Number of missiles

This command has no arguments

#getMoneyLooted

Total money looted

This command has no arguments

Permission:

#getName

This command is public

The nation name

This command has no arguments

#getNation

This command is public

Nation Name

This command has no arguments

#getNationUrl

This command is public

Game url for nation

This command has no arguments

#getNation_id

This command is public

Nation ID

This command has no arguments

#getNations

This command is public

Number of nations

This command has no arguments

#getNukes

This command is public

Number of nuclear weapons (nukes)

This command has no arguments

#getNumDefWarsSince

This command is public

Number of defensive wars since date

Arguments:

<date> - long

A whole number

#getNumOffWarsSince

This command is public

Number of offensive wars since date

Arguments:

<date> - long

A whole number

#getNumProjects

This command is public

Number of built projects

This command has no arguments

#getNumReports

This command is public

No description provided

This command has no arguments

#getNumWars

This command is public

Number of active offensive and defensive wars

This command has no arguments

#getNumWarsAgainstActives

This command is public

All time wars against active nations

This command has no arguments

#getNumWarsSince

This command is public

Number of offensive and defensive wars since date

Arguments:

<date> - long

A whole number

#getOff

This command is public

Number of active offensive wars

This command has no arguments

#getOffSpySlots

This command is public

Total offensive espionage spy slots

This command has no arguments

#getOnlineStatus

This command is public

Discord online status

This command has no arguments

#getPopulation

This command is public

Total population in all cities

This command has no arguments

#getPosition

This command is public

Raw positional value (0 = remove, 1 = app, 2 = member, 3 = officer 4 = heir, 5 = leader)

This command has no arguments

#getPositionEnum

This command is public

Alliance position enum id 0 = None or Removed 1 = Applicant 2 = Member 3 = Officer 4 = Heir 5 = Leader

This command has no arguments

#getPositionLevel

This command is public

Alliance unique id of the position level As shown in the position edit page

This command has no arguments

#getProjectAbsoluteTurn

This command is public

Turn epoch when project timer expires

This command has no arguments

#getProjectBitMask

This command is public

The projects built as a bitmask

This command has no arguments

#getProjectTurns

This command is public

Turns left on the project timer before being able to buy a project

This command has no arguments

#getProjects

Set of projects this nation has

This command has no arguments

Permission:

#getRads

This command is public

The radiation level of the nation

This command has no arguments

#getRelativeStrength

This command is public

Relative strength compared to enemies its fighting (1 = equal)

This command has no arguments

#getResource

This command is public

Gets a resource amount from a map of resources

Arguments:

<resources> - Map<ResourceType, Double>

A comma separated list of resources and their amounts

<resource> - ResourceType

The name of a resource

#getResourceValue

This command is public

Gets the total resource value for a map of resources

Arguments:

<resources> - Map<ResourceType, Double>

A comma separated list of resources and their amounts

#getRevenueConverted

This command is public

Daily revenue value of nation

This command has no arguments

#getScore

This command is public

Nation Score (ns)

This command has no arguments

#getShipPct

This command is public

Decimal ratio of ships a nation has out of their maximum (between 0 and 1)

This command has no arguments

#getShips

This command is public

Number of navy ships

This command has no arguments

#getSoldierPct

This command is public

Decimal ratio of soldiers a nation has out of their maximum (between 0 and 1)

This command has no arguments

#getSoldiers

This command is public

Number of soldiers

This command has no arguments

#getSpies

This command is public

Most recent spy count

This command has no arguments

#getSpyCap

This command is public

Maximum spies a nation can have

This command has no arguments

#getSpyReportsToday

This command is public

How many spy reports they have posted today

This command has no arguments

#getStrength

This command is public

Military strength (1 plane = 1)

This command has no arguments

#getStrongestEnemy

This command is public

Effective strength of the strongest nation this nation is fighting

This command has no arguments

#getStrongestEnemyOfScore

This command is public

Get the effective military strength of the strongegst nation within the provided score range

Arguments:

<minScore> - double

A decimal number

<maxScore> - double

#getStrongestEnemyRelative

This command is public

Relative strength of the strongest nation this nation is fighting (1 = equal)

This command has no arguments

#getStrongestOffEnemyOfScore

This command is public

Effective strength of the strongest nation this nation is attacking (offensive war)

Arguments:

<minScore> - double

A decimal number

<maxScore> - double

#getTankPct

This command is public

Decimal ratio of tanks a nation has out of their maximum (between 0 and 1)

This command has no arguments

#getTanks

This command is public

Number of tanks

This command has no arguments

#getTax_id

This command is public

ID of their in-game tax rate bracket

This command has no arguments

#getTotalLand

This command is public

Total land in their cities

This command has no arguments

#getTreasureBonusPct

This command is public

Treasure bonus decimal percent

This command has no arguments

#getTurnsFromDC

This command is public

No description provided

This command has no arguments

#getTurnsTillDC

This command is public

Turns remaining until their day change (DC)

This command has no arguments

#getUnits

Get units at a specific date

Arguments:

<unit> - MilitaryUnit

Military unit name

<date> - long

A whole number

Permission:

#getUserAgeDays

This command is public

Age of discord account in days

This command has no arguments

#getUserAgeMs

This command is public

Age of discord account in milliseconds

This command has no arguments

#getUserDiscriminator

This command is public

The registered discord username and user discriminator

This command has no arguments

#getUserId

This command is public

The registered discord user id

This command has no arguments

#getUserMention

This command is public

The registered discord user mention (or null)

This command has no arguments

#getVacationTurnsElapsed

This command is public

Number of turns since entering Vacation Mode (VM)

This command has no arguments

#getVm_turns

This command is public

Number of turns in Vacation Mode (VM)

This command has no arguments

#getWarPolicy

This command is public

War policy

This command has no arguments

#getWarPolicyAbsoluteTurn

This command is public

The absolute turn the war policy change timer expires

This command has no arguments

#getWarPolicyTurns

This command is public

The number of turns until the war policy timer expires

This command has no arguments

#getWars_lost

This command is public

Total wars lost

This command has no arguments

#getWars_won

This command is public

Total wars won

This command has no arguments

#hasAllPermission

This command is public

Check if the nation has all permissions

Arguments:

<permissions> - Set<AlliancePermission>

A comma separated list of In-game permission in an alliance

#hasAnyPermission

This command is public

Check if the nation has any permissions

Arguments:

<permissions> - Set<AlliancePermission>

A comma separated list of In-game permission in an alliance

#hasBoughtAircraftToday

This command is public

purchased aircraft today

This command has no arguments

#hasBoughtMissileToday

This command is public

purchased missiles today

This command has no arguments

#hasBoughtNukeToday

This command is public

purchased nuclear weapons today

This command has no arguments

#hasBoughtShipsToday

This command is public

purchased ships today

This command has no arguments

#hasBoughtSoldiersToday

This command is public

purchased soldiers today

This command has no arguments

#hasBoughtSpiesToday

This command is public

purchased spies today

This command has no arguments

#hasBoughtTanksToday

This command is public

purchased tanks today

This command has no arguments

#hasBounty

This command is public

Has any bounties placed on them to defeat them in war or detonate a nuke

This command has no arguments

#hasNukeBounty

This command is public

Has any bounties placed on them to detonate a nuke

This command has no arguments

#hasPermission

This command is public

Check if the nation has a permissions

Arguments:

<permission> - AlliancePermission

In-game permission in an alliance

#hasPriorBan

This command is public

If this nation has a previous ban attached to their nation or discord id

This command has no arguments

#hasProject

This command is public

If the nation has a project

Arguments:

<project> - Project

A project name. Replace spaces with _. See: https://politicsandwar.com/nation/projects/

#hasProjects

This command is public

If the nation has all of the specified projects

Arguments:

<projects> - Set<Project>

A comma separated list of nation projects

[any] - boolean

#hasTreasure

This command is public

If the nation has the treasure

This command has no arguments

#hasUnitBuyToday

This command is public

If there is remaining purchase for a unit today

Arguments:

<unit> - MilitaryUnit

Military unit name

#hasUnsetMil

This command is public

If they have undefined military values

This command has no arguments

#hasWarBounty

This command is public

Has any bounties placed on them to defeat them in war

This command has no arguments

#infraAttackModifier

This command is public

The modifier for infra damage

Arguments:

<type> - AttackType

An attack type

#infraDefendModifier

This command is public

The modifier for infra damage

Arguments:

<type> - AttackType

An attack type

#isAllianceColor

This command is public

If nation color matches the alliance color

This command has no arguments

#isAttackingEnemyOfCities

This command is public

If this nation has an offensive war against an enemy in the provided city range

Arguments:

<minCities> - double

A decimal number

<maxCities> - double

#isAttackingEnemyOfScore

This command is public

If this nation has an offensive war against an enemy in the provided score range

Arguments:

<minScore> - double

A decimal number

<maxScore> - double

#isBanEvading

This command is public

If this nation has a ban attached to their nation or discord id that has not expired

This command has no arguments

#isBeige

This command is public

If nation color is beige

This command has no arguments

#isBlitzkrieg

This command is public

Whether their war policy is blitzkrieg and within the first 12 turns of switching to it

This command has no arguments

#isBlockaded

This command is public

If blockaded by navy ships in-game

This command has no arguments

#isBlockader

This command is public

If blockading a nation in-game with navy ships

This command has no arguments

#isDefendingEnemyOfCities

This command is public

If this nation has a defensive war from an enemy in the provided city range

Arguments:

<minCities> - double

A decimal number

<maxCities> - double

#isEnemy

This command is public

If this nation is in the enemies coalition

This command has no arguments

#isEspionageAvailable

This command is public

If there are remaining espionage slots

This command has no arguments

#isEspionageFull

This command is public

If espionage slots are full

This command has no arguments

#isFightingActive

This command is public

If fighting a war against another active nation

This command has no arguments

#isFightingEnemyOfCities

This command is public

If this nation has an war with an enemy in the provided city range

Arguments:

<minCities> - double

A decimal number

<maxCities> - double

#isFightingEnemyOfScore

This command is public

If this nation has a war with an enemy in the provided score range

Arguments:

<minScore> - double

A decimal number

<maxScore> - double

#isGray

This command is public

If nation color is gray

This command has no arguments

#isIn

This command is public

If this nation is in a nation list

Arguments:

<nations> - Set<DBNation>

A comma separated list of nations, alliances and filters

#isInAllianceGuild

This command is public

If in the discord guild for their alliance

This command has no arguments

#isInMilcomGuild

This command is public

If in the milcom discord guild for their alliance

This command has no arguments

#isInSpyRange

This command is public

If a specified nation is within this nations espionage range

Arguments:

<other> - DBNation

nation id, name or url

#isInWarRange

This command is public

If this nation is in war declare range of the current attacking nation

This command has no arguments

#isOnline

This command is public

If online ingame or discord

This command has no arguments

#isPowered

This command is public

Are any cities powered

This command has no arguments

#isReroll

This command is public

Returns self nation ID if the nation is a reroll, otherwise 0

This command has no arguments

#isTaxable

This command is public

If the nation is taxable

This command has no arguments

#isVerified

This command is public

If registered with Locutus

This command has no arguments

#lastBankDeposit

This command is public

Unix timestamp when last deposited in a bank

This command has no arguments

#login_daychange

This command is public

Decimal pct of times they login during UTC daychange

This command has no arguments

#lootModifier

This command is public

The modifier for loot given when they are defeated in war

This command has no arguments

#lootTotal

This command is public

Estimated loot value including aliance bank loot when defeated in a raid war based on last war loss or espionage

This command has no arguments

#looterModifier

This command is public

The modifier for loot given when they defeat an enemy in war

Arguments:

<isGround> - boolean

#lostInactiveWar

This command is public

If this nation is not daily active and lost their most recent war

This command has no arguments

#maxBountyValue

This command is public

Maximum total bounty placed on them of any type

This command has no arguments

#maxCityInfra

This command is public

The infra level of their highest city

This command has no arguments

#maxWarBountyValue

This command is public

Maximum total bounty placed on them of any war type

This command has no arguments

#militaryValue

This command is public

Total monetary value of military units

This command has no arguments

#minWarResistance

This command is public

Minimum resistance of self in current active wars

This command has no arguments

#minWarResistancePlusMap

This command is public

Minimum resistance of self in current active wars, assuming the enemy translates their MAP into ground/naval with guaranteed IT

This command has no arguments

#nukeBountyValue

This command is public

Sum of all nuke bounties placed on them

This command has no arguments

#ordinaryBountyValue

This command is public

Sum of all ordinary bounties placed on them

This command has no arguments

#projectSlots

This command is public

Total project slots (used + unused)

This command has no arguments

#raidBountyValue

This command is public

Sum of all raid bounties placed on them

This command has no arguments

#treasureDays

This command is public

How many days the treasure is in said nation

This command has no arguments

Clone this wiki locally