council treasury |
Discworld room help |
council treasury |
Name
Council Treasury
Syntax
deposit <string>
deposit <string> for <reason>
check balance
view transactions
view transactions by <player>
view transaction archive
view tax
withdraw <amount> <type> for <reason>
set sales tax <tax>
set housing tax <tax>
settings view
settings change tax cap [to] <percent>
settings change increase tax dates [to] <start date> and <end date> [of month]
settings change withdraw interval [to] <hours>
settings change single magistrate limit [to] <amount> [and] <percent>
settings confirm change
Description
This room allows people to deposit money to the treasury, check the balance, and allows magistrates to withdraw money from the treasury and view the most recent transactions.
Older transactions are written to an archive, which you can also view.
A quorum of magistrates may act together to change settings that place limits on the amounts and frequency of withdrawls, and changes to housing taxes.
Settings
There are 4 settings that a quorum of magistrates can change. One of these settings is used to derive a further 4 settings.
Tax cap - the housing tax cap is a limit on the maximum percentage of housing rental that is added as tax. The cap can not be set below the current housing tax value. Valid values are positive integers. Default is 10%.
Increase tax dates - defines a start and end date each month between which housing tax can be increased. Default values are 2 and 15, allowing the housing tax to be increased between the 2nd and 15th of each Disc month. Taxes are collected on the 1st of the month. Tax rates may be reduced at any time, this setting only controls when housing taxes may be increased.
Withdraw interval - defines a minimum period in real life hours which must elapse between the same magistrate making multiple withdrawls from the treasury.
Single magistrate limit - sets limits as an amount and as a percentage of total treasury balance that an individual magistrate may withdraw. If two magistrates are present, each can withdraw twice the limit. If three magistrates are present, each can withdraw four times the limit. If four magistrates are present, each can withdraw eight times the limit. If five magistrates are present, each can withdraw sixteen times the limit. The percentage limit is recalculated on each withdrawl.
Changing settings requires that a quorum of magistrates is present. The quorum is calculated from the number of magistrates on the council and may not be changed. One magistrate proposes a change using the "settings change" syntax. The other magistrates present are then informed of the proposed change and may then "settings confirm change". If sufficient magistrates confirm a change it is implemented. A proposed change will lapse after five minutes, or when it is implemented, and another change may then be proposed.
Note that the quorum must be maintained until a proposal is agreed by the quorum. The quorum is checked each time a magistrate uses "settings change ...." or "settings confirm change".
Magistrates may see the current settings and the quorum for the council with the "settings view" command.
Example
> withdraw 20 tooni for buying booze for our party
> deposit 1 penny
> check balance
> view transactions
> view transactions by carmine
> view transaction archive
> settings view
> settings change tax cap to 10
> settings change increase tax dates 2 and 15
> settings change withdraw interval 24
> settings change single magistrate limit 10000 dollars and 5
> settings confirm change
