make town hall offer

Author: Trolldemorted

src/SUMMARY.md

@@ -13,6 +13,7 @@
 - [Operations](./operations.md)
     - [Bath House Bribe Success](./operations/0042-bath-house-bribe-success.md)
     - [Bath House Bribe Failure](./operations/0043-bath-house-bribe-failure.md)
+    - [Make Town Hall Offer](./operations/0048-make-town-hall-offer.md)
     - [Tavern Interaction](./operations/0052-tavern-interaction.md)
 - [Scheduled Tasks](./scheduled-tasks/0000.md)
     - [Criminal Investigation](./scheduled-tasks/0005-criminal-investigation.md)

src/file-formats/rou.md

@@ -32,3 +32,5 @@ The "direction" of a transaction is encoded in the price and amount:
 |0|Positive|Office -> Ship|
 |Positive|Positive|Ship -> Town|
 |Negative|Positive|Town -> Ship|
+
+The "Max" amount is represented by `1_000_000_000` for both barrel and bundle wares.

src/operations.md

@@ -89,6 +89,7 @@ The following operations have been identified:
 |0x41|Form Militia Squad|
 |0x42|Bath House Bribe Success|
 |0x43|Bath House Bribe Failure|
+|0x48|Make Town Hall Offer|
 |0x52|Tavern Interaction|
 |0xc2|Autosave|
 |0xc4|Advance Time|

src/operations/0048-make-town-hall-offer.md

@@ -0,0 +1,24 @@
+# Make Town Hall Offer
+The `handle_operation_48_make_townhall_offer` function at `0x0053B010` handles proposed changes to a town's policy.
+
+```c
+struct operation_48_make_town_hall_offer
+{
+  signed __int32 field_0_meeting_timestamp;
+  signed __int32 field_4_extra_tax_amount;
+  unsigned __int8 field_8_town_index;
+  council_meeting_type field_9_meeting_type;
+  signed __int16 field_A_tax_per_head_amount;
+  char field_C_merchant_index;
+  char field_D;
+  char field_E;
+  char field_F;
+};
+```
+
+## Normal Towns
+For normal towns a *Council Meeting* scheduled is scheduled at `0xE00` ticks (14 days) ahead.
+
+## Hanseatic Settlements
+Hanseatic settlements have no council and expand military or enlarge town wall offers.
+A change to the head tax is applied immediately, and an *Extra Tax* scheduled task is scheduled at the next tick.