Skip to content

Advanced systems

Create: Hydraulics edited this page Jul 13, 2026 · 1 revision

Advanced Systems

Trade Routes (Towny only)

A trade route is a formal agreement between two nations that reduces the exchange tax between their citizens specifically. Propose one with /exchequer traderoute propose <nation>, the other nation's leadership accepts with /exchequer traderoute accept. Either side can end an active route with /exchequer traderoute break <nation>.

If you're also running a separate diplomacy or politics addon, trade routes fire a custom event on propose, accept, and break, so that addon can listen and trigger trade routes automatically from treaty acceptance. Exchequer does not require that addon to exist and functions fully without it.

Town Shares (Towny only)

A nation can issue a fixed number of tradeable shares backed by their treasury with /exchequer shares issue <amount>. Other players buy in with /exchequer shares buy <nation> <amount> using their ledger balance. On a scheduled interval, a configured percentage of the nation's accumulated tax revenue since the last distribution is paid out proportionally to shareholders as a dividend.

This is equity, not debt. There is no repayment obligation and no way for a nation to go into negative balance through this system. Share price is calculated as treasury value divided by total shares outstanding, recalculated on the same schedule as GDP, so share value floats naturally with the nation's real economic performance rather than being fixed.

Sell shares back at any time with /exchequer shares sell <nation> <amount>, at the current share price, not the price you originally paid.

War and Raid Insurance

Pay a premium, a percentage of the amount you want covered, to protect that portion of your bank balance from seizure during a Towny war event for a fixed duration. Purchase with /exchequer insurance buy <amount>, check your active coverage with /exchequer insurance status.

The premium is paid into a separate risk pool, not into any nation's treasury, and functions independently of the tax and GDP systems. This is a risk management mechanic only, there is no lending or borrowing involved anywhere in this system.

Economic Events

Server triggered or admin triggered booms and shortages that temporarily adjust a material's AMM pool reserves to simulate a supply shock, reverting automatically after a configured duration. Trigger manually with /exchequer event trigger <boom|shortage> <material>.

If a separate politics or diplomacy addon is present and fires a sanctions or embargo event, Exchequer listens for it and can block direct exchange between the two sanctioned nations' citizens while the sanction is active, giving embargoes real mechanical weight rather than being flavor text only. This integration is optional and Exchequer does not require the other addon to function.

Clone this wiki locally