Skip to content

deposits

Jump to bottom
xdnw edited this page Oct 3, 2023 · 16 revisions

Member balances are determined by what they deposit into the bank, as well as funds they receive from the alliance. Offshores/Training alliances etc.

Viewing balances

The deposits check command can be used to view the account balance of nations, tax brackets as well as the alliance or guild offshore account

  • Nation e.g. Borg - Net funds a nation has deposited/received with the alliance bank
  • Tax bracket e.g. #tax_id=1234 - Net funds a from tax records
  • Alliance e.g. AA:Rose - Net funds the alliance has deposited/received with the offshore
  • Guild ID e.g. 647252780817448972 - Net funds the #guild has deposited/received with the offshore

Nation and Tax Bracket deposits can be adjusted by econ or admin, however alliance/guild accounts can only be set in the offshore server

📚 Displays the account balance for a nation, alliance or guild...
/deposits check

Displays the account balance for a nation, alliance or guild
Balance info includes deposits, loans, grants, taxes and escrow

Arguments:

<nationOrAllianceOrGuild> - NationOrAllianceOrGuildOrTaxid

Account to check holdings for
(A nation or alliance name, url or id, or a guild id, or a tax id or url)

[-a offshores] - Set

The alliances to check transfers from
Otherwise the guild configured ones will be used
(A comma separated list of alliances)

[-c timeCutoff] - Long[Timestamp]

Only include transfers after this time
(A unix timestamp, a DMY date or a time difference that will resolve to a timestamp from the current date)

[-b includeBaseTaxes] - boolean

Include all taxes in account balance

[-o ignoreInternalOffsets] - boolean

Do NOT include manual offsets in account balance

[-t showCategories] - Boolean

Show separate sections for taxes and deposits

[-d replyInDMs] - boolean

[-e includeExpired] - boolean

Include expired transfers

[-i includeIgnored] - boolean

Include transfers marked as ignore

[-z allowCheckDeleted] - boolean

[-h hideEscrowed] - boolean

Hide the escrow balance
📚 Get a sheet with member nations and their deposits...
/deposits sheet

Get a sheet with member nations and their deposits
Each nation's safekeep should match the total balance given by deposits commandAdd -b to
Add -o to not include any manual deposit offsets
Add -d to not include deposits
Add -t to not include taxes
Add -l to not include loans
Add -g to not include grants
Add -p to include past depositors
Add -f to force an update

**Arguments:**

nations]` - [Set

A comma separated list of nations, alliances and filters

[offshores] - Set

The alliances to track transfers from
(A comma separated list of alliances)

[-b ignoreTaxBase] - boolean

use 0/0 as the tax base

[-o ignoreOffsets] - boolean

Do NOT include any manual deposit offesets

[-t noTaxes] - boolean

Do NOT include taxes

[-l noLoans] - boolean

Do NOT include loans

[-g noGrants] - boolean

Do NOT include grants

[-d noDeposits] - boolean

Do NOT include deposits

[-p includePastDepositors] - Set

Include past depositors

[-e noEscrowSheet] - boolean

Do NOT include escrow sheet

[-n useFlowNote] - DepositType

Only show the flow for this note
i.e. To only see funds marked as #TRADE
This is for transfer flow breakdown internal, withdrawal, and deposit
(A note to use for a bank transfer)

[-f force] - boolean

See also:Locutus/Wiki/bank_flows

Changing how balances are displayed

Use the argument in the deposits command, or set the following

📚 Display deposits in a condensed format
/settings_bank_info display_condensed_deposits

Display deposits in a condensed format

Arguments:

<enabled> - boolean

📚 Whether members's deposits are displayed by default with a breakdown of each category (true/false)
/settings_bank_info display_itemized_deposits

Whether members's deposits are displayed by default with a breakdown of each category (true/false)

Arguments:

<enabled> - boolean

Listing records

📚 Get a sheet of a nation or alliances transactions (excluding taxes)
/bank records

Get a sheet of a nation or alliances transactions (excluding taxes)

Arguments:

<nationOrAllianceOrGuild> - NationOrAllianceOrGuild

A nation or alliance name, url or id, or a guild id

[timeframe=%epoch%] - long[Timestamp]

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

[useTaxBase=false] - boolean

[useOffset=true] - boolean

[-s sheet] - SpreadSheet

A google spreadsheet id or url

[-o onlyOffshoreTransfers] - boolean

📚 Get a sheet of a nation tax deposits over a period...
/tax deposits

Get a sheet of a nation tax deposits over a period
If a tax base is set for the nation or alliance then only the portion within member holdings are included by default

Arguments:

<nations> - Set

A comma separated list of nations, alliances and filters

[baseTaxRate] - TaxRate

Set to 0/0 to include all taxes
(A tax rate in the form of `money/rss`)

[startDate] - Long[Timestamp]

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

[endDate] - Long[Timestamp]

[-s sheet] - SpreadSheet

A google spreadsheet id or url
📚 Get a sheet of a nation tax deposits over a period
/tax records

Get a sheet of a nation tax deposits over a period

Arguments:

<nation> - DBNation

nation id, name or url

[startDate] - Long[Timestamp]

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

[endDate] - Long[Timestamp]

[-s sheet] - SpreadSheet

A google spreadsheet id or url

Transfer Notes

Notes can be used in the transfer commands, as well as when sending in-game

Multiple notes can be used at a time

Notes with values go in the form #expire=60d

Primary Notes

  • #deposit: For funds directly deposited or withdrawn
  • #tax: For city raw consumption or taxes
  • #loan: For funds members are expected to repay at some date in the future
  • #grant: Can be excluded from withdrawal limit, considered a loan if no time is specified e.g. #expire=60d
  • #ignore: Excluded from deposits
  • #trade: Sub type of deposits, earmarked as trading funds

Modifier Notes

These notes are used in addition to a primary note, and usually have a value

Tracking alliances

This applies for guilds with a registed alliance

📚 Your alliance id
/settings_default registeralliance

Your alliance id

Arguments:

<alliances> - Set

A comma separated list of alliances

By default, any alliance alliance registered to the guild is tracked for member deposits.

Removing an alliance from being tracked will remove all those transfers from a member's balance

The following coalitions are also tracked:

  • TRACK_DEPOSITS
  • OFFSHORE

See: Locutus/Wiki/coalitions

Tax accounts & Including taxes in deposits

See: Locutus/Wiki/tax_automation

Manually adding/subtracing balances

Use negative amounts to subtract

Nation or tax brackets can be adjusted for a server

Offshore balances for alliances or guilds are managed in the offshore's server

📚 Add or subtract from a nation, alliance, guild or tax bracket's account balance...
/deposits add

Add or subtract from a nation, alliance, guild or tax bracket's account balance
note: Mutated alliance deposits are only valid if your server is a bank/offshore
Use #expire=30d to have the amount expire after X days

Arguments:

<accounts> - Set

A comma separated list of nations, alliances, guild ids and tax ids or urls

<amount> - Map

A comma separated list of resources and their amounts

<note> - String

A single line of text

[-f force] - boolean

Bulk add balance

Specify multiple nations for the command above, or use add balance sheet

📚 Add account balance using a google sheet of nation's and resource amounts...
/deposits addsheet

Add account balance using a google sheet of nation's and resource amounts
The google sheet must have a column for nation (name, id or url) and a column named for each in-game resource

Arguments:

<sheet> - SpreadSheet

A google spreadsheet id or url

<note> - String

The transaction note to use
(A single line of text)

[-f force] - boolean

[-n negative] - boolean

Subtract the amounts instead of add

Shifting balance notes

For example, moving #loan to #deposit

📚 Bulk shift resources in a nations holdings to another note category
/deposits shift

Bulk shift resources in a nations holdings to another note category

Arguments:

<nation> - DBNation

nation id, name or url

<from> - DepositType

The note to change FROM
(A note to use for a bank transfer)

<to> - DepositType

The new note to use
(A note to use for a bank transfer)

[timediff] - Long[Timestamp]

Only transfers after this timeframe
(A unix timestamp, a DMY date or a time difference that will resolve to a timestamp from the current date)

Converting negative deposits

📚 Adjust nation's holdings by converting negative resource values of a specific note to a different resource or money
/deposits convertnegative

Adjust nation's holdings by converting negative resource values of a specific note to a different resource or money

Arguments:

<nations> - Set

A comma separated list of nations, alliances and filters

[negativeResources=manu,raws,food] - List

A comma separated list of resource types

[convertTo=money] - ResourceType

The name of a resource

[-g includeGrants] - boolean

[-t depositType] - DepositTypeInfo

Convert transfers of this note category
(A DepositType optionally with a value and a city tag)

[-f conversionFactor] - Double

What factor to multiple the converted resources by
e.g. Use a value below 1.0 to incur a fee
(A decimal number)

[-s sheet] - SpreadSheet

A google spreadsheet id or url

[-n note] - String

The transfer note to use for the adjustment
(A single line of text)

Resetting deposits

Set the arguments for the categories you do not wish to reset to false

/deposits reset nations: ignoregrants: true ignoreloans: true ignoretaxes: true ignorebankdeposits: true ignoreescrow: true

📚 Resets a nations deposits to net zero (of the specific note categories)
/deposits reset

Resets a nations deposits to net zero (of the specific note categories)

Arguments:

<nations> - NationList

A comma separated list of nations, alliances and filters

[-g ignoreGrants] - boolean

Do NOT reset grants

[-l ignoreLoans] - boolean

Do NOT reset loans

[-t ignoreTaxes] - boolean

Do NOT reset taxes

[-d ignoreBankDeposits] - boolean

Do NOT reset deposits

[-e ignoreEscrow] - boolean

Do NOT reset escrow

[-f force] - boolean

Allow members to withdraw or offshore

See: Locutus/Wiki/banking

Resource conversion

Allow members to withdraw any resource as long as their balance has a positive market value

📚 If members can convert resources to cash....
/settings_bank_access resource_conversion

If members can convert resources to cash.
This is done virtually in Resources are converted using market average
Use #cash as the note when depositing or transferring funds

Arguments:

<enabled> - boolean

Alerts

📚 The #channel to receive alerts when there is a large tranfer in the game or a nation VMs with resources
/settings_bank_info addbalance_alert_channel

The #channel to receive alerts when there is a large tranfer in the game or a nation VMs with resources

Arguments:

<channel> - MessageChannel

A discord channel name or mention

/role setalias locutusrole: ECON_WITHDRAW_ALERTS discordrole: @Econ Withdraw Alerts

📚 The #channel to receive alerts when a nation requests a transfer
/settings_bank_info withdraw_alert_channel

The #channel to receive alerts when a nation requests a transfer

Arguments:

<channel> - MessageChannel

A discord channel name or mention

/role setalias locutusrole: ECON_DEPOSIT_ALERTS discordrole: @Econ Deposit Alerts

📚 The #channel to receive alerts when a nation makes a deposit (this will no longer reliably alert)
/settings_bank_info deposit_alert_channel

The #channel to receive alerts when a nation makes a deposit (this will no longer reliably alert)

Arguments:

<channel> - MessageChannel

A discord channel name or mention
📚 The #channel to receive alerts e.g. for custom !BankAlerts
/settings_bank_info bank_alert_channel

The #channel to receive alerts e.g. for custom !BankAlerts

Arguments:

<channel> - MessageChannel

A discord channel name or mention

Transfer command arguments

/transfer resources

Transfer from the alliance bank (alliance deposits)

Arguments:

<receiver> - NationOrAlliance

A nation or alliance name, url or id. Prefix with AA: or nation: to avoid ambiguity if there exists both by the same name or id

<transfer> - Map<ResourceType, Double>[AllianceDepositLimit]

A comma separated list of resources and their amounts, which will be restricted by an alliance's account balance

<depositType> - DepositTypeInfo

A DepositType optionally with a value and a city tag

[-n nationAccount] - DBNation

The nation account to deduct from (nation id, name or url)

[-a senderAlliance] - DBAlliance

The alliance bank to send from Defaults to the offshore (An alliance name id or url)

[-o allianceAccount] - DBAlliance

The alliance account to deduct from Alliance must be registered to this guild Defaults to all the alliances of this guild (An alliance name id or url)

[-t taxAccount] - TaxBracket

The tax account to deduct from (A tax id or url)

[-ta existingTaxAccount] - boolean

Deduct from the receiver's tax bracket account

[-m onlyMissingFunds] - boolean

Only send funds the receiver is lacking from the amount

[-e expire] - Long[Timediff]

Have the transfer ignored from nation holdings after a timeframe (A time difference or unix timestamp which will resolve as a difference relative to the current date)

[-g token] - UUID

Universally Unique IDentifier

[-c convertCash] - boolean

Transfer valued at cash equivalent in nation holdings

[-em escrow_mode] - EscrowMode

The mode for escrowing funds (e.g. if the receiver is blockaded) Defaults to never (The mode for escrowing funds for a transfer, such as when a receiver is blockaded)

[-b bypassChecks] - boolean

[-f force] - boolean

Clone this wiki locally