{"id":210,"date":"2026-04-30T04:20:02","date_gmt":"2026-04-30T04:20:02","guid":{"rendered":"https:\/\/worldofaetherra.com\/?page_id=210"},"modified":"2026-05-22T20:52:40","modified_gmt":"2026-05-22T20:52:40","slug":"kt-admin-guide","status":"publish","type":"page","link":"https:\/\/worldofaetherra.com\/?page_id=210","title":{"rendered":"KT Admin Guide"},"content":{"rendered":"\n

Overview<\/h2>\n\n\n\n

Kingdom Treasury gives kingdom leadership tools to manage:<\/p>\n\n\n\n

\u2022 Citizens
\u2022 Taxes
\u2022 Jobs
\u2022 Payroll
\u2022 Treasury balances
\u2022 Donations
\u2022 Royal payments
\u2022 Withdrawals
\u2022 Currency exchange
\u2022 Ledgers<\/code><\/pre>\n\n\n\n
Most leadership tools are available through:<\/p>\n\n\n\n
\/kt gui<\/code><\/pre>\n\n\n\n
The plugin uses the server\u2019s configured local kingdom, so most commands no longer require typing the kingdom name every time.<\/p>\n\n\n\n
\n\n\n\n
Local Kingdom Defaults<\/h1>\n\n\n\n
Each kingdom server should have a local kingdom configured in config.yml<\/code>.<\/p>\n\n\n\n
Example:<\/p>\n\n\n\n
settings:
  local-kingdom: firefly<\/code><\/pre>\n\n\n\n
When this is set, commands like these use the local kingdom automatically:<\/p>\n\n\n\n
\/kt gui
\/tax summary
\/tax due
\/tax collect
\/payroll status
\/payroll run
\/treasury balance
\/treasury withdraw 10 diamonds reason here
\/kt currency info
\/kt currency rate 2<\/code><\/pre>\n\n\n\n
Long versions still work:<\/p>\n\n\n\n
\/kt gui firefly
\/tax summary firefly
\/payroll run firefly
\/treasury balance firefly<\/code><\/pre>\n\n\n\n
Commands for the wrong kingdom should be blocked on non-local servers.<\/p>\n\n\n\n
\n\n\n\n
Royal Dashboard<\/h1>\n\n\n\n
Open the main dashboard with:<\/p>\n\n\n\n
\/kt gui<\/code><\/pre>\n\n\n\n
The dashboard includes:<\/p>\n\n\n\n
\u2022 Treasury Overview
\u2022 Financial Health
\u2022 Crown Standing
\u2022 Currency Rate
\u2022 Tax Summary
\u2022 Tax Rules
\u2022 Owing Citizens
\u2022 Grace Period Citizens
\u2022 Covered Citizens
\u2022 Delinquent Citizens
\u2022 Payroll Status
\u2022 Run Payroll
\u2022 Job Assignment
\u2022 Treasury Ledger
\u2022 Exchange Ledger
\u2022 Collect Taxes<\/code><\/pre>\n\n\n\n
\n\n\n\n
NPC Setup<\/h1>\n\n\n\n
Before setting an NPC, select it with:<\/p>\n\n\n\n
\/npc select<\/code><\/pre>\n\n\n\n
Then use the appropriate setup command.<\/p>\n\n\n\n
Banker NPC<\/h2>\n\n\n\n
\/kt npc setbanker<\/code><\/pre>\n\n\n\n
Citizens use this NPC to collect wages and pending payments.<\/p>\n\n\n\n
Tax Clerk NPC<\/h2>\n\n\n\n
\/kt npc settaxclerk<\/code><\/pre>\n\n\n\n
Citizens use this NPC to view their tax records.<\/p>\n\n\n\n
Registrar NPC<\/h2>\n\n\n\n
\/kt npc setregistrar<\/code><\/pre>\n\n\n\n
Citizens use this NPC to join the kingdom.<\/p>\n\n\n\n
Property Clerk NPC<\/h2>\n\n\n\n
\/kt npc setpropertyclerk<\/code><\/pre>\n\n\n\n
Citizens use this NPC to increase their property count.<\/p>\n\n\n\n
Shop Clerk NPC<\/h2>\n\n\n\n
\/kt npc setshopclerk<\/code><\/pre>\n\n\n\n
Citizens use this NPC to increase their shop count.<\/p>\n\n\n\n
Exchange NPC<\/h2>\n\n\n\n
\/kt npc setexchange<\/code><\/pre>\n\n\n\n
Citizens use this NPC to exchange diamonds and emeralds.<\/p>\n\n\n\n
Long versions are also supported:<\/p>\n\n\n\n
\/kt npc setbanker firefly
\/kt npc setexchange firefly<\/code><\/pre>\n\n\n\n
\n\n\n\n
Chest Setup<\/h1>\n\n\n\n
Look at the chest, then run the setup command.<\/p>\n\n\n\n
Treasury Chest<\/h2>\n\n\n\n
\/kt chest set treasury <kingdom><\/code><\/pre>\n\n\n\n
Used for royal treasury deposits.<\/p>\n\n\n\n
Accepts:<\/p>\n\n\n\n
\u2022 Diamonds
\u2022 Diamond blocks
\u2022 Emeralds
\u2022 Emerald blocks<\/code><\/pre>\n\n\n\n
Donation Chest<\/h2>\n\n\n\n
\/kt chest set donation <kingdom><\/code><\/pre>\n\n\n\n
Used for citizen donations.<\/p>\n\n\n\n
Accepts:<\/p>\n\n\n\n
\u2022 Diamonds
\u2022 Diamond blocks
\u2022 Emeralds
\u2022 Emerald blocks<\/code><\/pre>\n\n\n\n
Property Tax Chest<\/h2>\n\n\n\n
\/kt chest set property-tax <kingdom><\/code><\/pre>\n\n\n\n
Used for property tax payments.<\/p>\n\n\n\n
Accepts:<\/p>\n\n\n\n
\u2022 Diamonds
\u2022 Diamond blocks<\/code><\/pre>\n\n\n\n
Shop Tax Chest<\/h2>\n\n\n\n
\/kt chest set shop-tax <kingdom><\/code><\/pre>\n\n\n\n
Used for shop tax payments.<\/p>\n\n\n\n
Accepts:<\/p>\n\n\n\n
\u2022 Diamonds
\u2022 Diamond blocks<\/code><\/pre>\n\n\n\n
Emeralds are not accepted for tax chests.<\/p>\n\n\n\n
\n\n\n\n
Treasury Balances<\/h1>\n\n\n\n
Treasuries now track two physical balances:<\/p>\n\n\n\n
\u2022 Diamond balance
\u2022 Emerald balance<\/code><\/pre>\n\n\n\n
View balances with:<\/p>\n\n\n\n
\/treasury balance<\/code><\/pre>\n\n\n\n
The diamond balance remains the primary operating balance for taxes, payroll, and most payments.<\/p>\n\n\n\n
\n\n\n\n
Treasury Withdrawals<\/h1>\n\n\n\n
Royals can withdraw from the treasury with a required reason.<\/p>\n\n\n\n
\/treasury withdraw <amount> [diamonds|emeralds] <reason><\/code><\/pre>\n\n\n\n
Examples:<\/p>\n\n\n\n
\/treasury withdraw 20 diamonds paid visiting mason
\/treasury withdraw 18 emeralds event prize<\/code><\/pre>\n\n\n\n
If no currency is specified, the withdrawal defaults to diamonds.<\/p>\n\n\n\n
Long version:<\/p>\n\n\n\n
\/treasury withdraw <kingdom> <amount> [diamonds|emeralds] <reason><\/code><\/pre>\n\n\n\n
Examples:<\/p>\n\n\n\n
\/treasury withdraw firefly 20 diamonds bridge repair
\/treasury withdraw firefly 18 emeralds festival prize<\/code><\/pre>\n\n\n\n
Withdrawals are logged in payments.yml<\/code>.<\/p>\n\n\n\n
Withdrawals pay in compact item form when possible.<\/p>\n\n\n\n
\n\n\n\n
Treasury Payments<\/h1>\n\n\n\n
To prepare a payment for a citizen:<\/p>\n\n\n\n
\/treasury pay <kingdom> <player> <amount> [reason]<\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/treasury pay firefly BuilderBob 30 marketplace repairs<\/code><\/pre>\n\n\n\n
This removes diamonds from the treasury and adds the amount to the player\u2019s pending pay.<\/p>\n\n\n\n
The citizen collects the payment from the Banker NPC.<\/p>\n\n\n\n
\n\n\n\n
Currency Rates<\/h1>\n\n\n\n
Each kingdom has its own exchange rate.<\/p>\n\n\n\n
View the current rate:<\/p>\n\n\n\n
\/kt currency info<\/code><\/pre>\n\n\n\n
Set the rate:<\/p>\n\n\n\n
\/kt currency rate <emeraldsPerDiamond><\/code><\/pre>\n\n\n\n
Examples:<\/p>\n\n\n\n
\/kt currency rate 2
\/kt currency rate 3<\/code><\/pre>\n\n\n\n
Long versions:<\/p>\n\n\n\n
\/kt currency info firefly
\/kt currency rate firefly 2<\/code><\/pre>\n\n\n\n
The rate means:<\/p>\n\n\n\n
1 diamond = X emeralds<\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/kt currency rate 2<\/code><\/pre>\n\n\n\n
Means:<\/p>\n\n\n\n
1 diamond = 2 emeralds<\/code><\/pre>\n\n\n\n
\n\n\n\n
Exchange NPC<\/h1>\n\n\n\n
The Exchange NPC allows players to trade diamonds and emeralds using the kingdom\u2019s exchange rate.<\/p>\n\n\n\n
The exchange is treasury-backed.<\/p>\n\n\n\n
Diamonds to Emeralds<\/h2>\n\n\n\n
When a citizen exchanges diamonds for emeralds:<\/p>\n\n\n\n
\u2022 Player gives diamonds
\u2022 Treasury gains diamonds
\u2022 Treasury loses emeralds
\u2022 Player receives emeralds<\/code><\/pre>\n\n\n\n
The exchange only succeeds if the treasury has enough emeralds.<\/p>\n\n\n\n
Emeralds to Diamonds<\/h2>\n\n\n\n
When a citizen exchanges emeralds for diamonds:<\/p>\n\n\n\n
\u2022 Player gives emeralds
\u2022 Treasury gains emeralds
\u2022 Treasury loses diamonds
\u2022 Player receives diamonds<\/code><\/pre>\n\n\n\n
The exchange only succeeds if the treasury has enough diamonds.<\/p>\n\n\n\n
Emerald-to-diamond exchanges must divide evenly by the kingdom\u2019s rate.<\/p>\n\n\n\n
\n\n\n\n
Exchange Ledger<\/h1>\n\n\n\n
Exchange activity is recorded automatically.<\/p>\n\n\n\n
Royals can view recent exchanges through:<\/p>\n\n\n\n
\/kt gui<\/code><\/pre>\n\n\n\n
Then click:<\/p>\n\n\n\n
Exchange Ledger<\/code><\/pre>\n\n\n\n
The ledger shows:<\/p>\n\n\n\n
\u2022 Player
\u2022 Exchange direction
\u2022 Amount given
\u2022 Amount received
\u2022 Exchange rate
\u2022 Timestamp<\/code><\/pre>\n\n\n\n
Exchange logs are also stored in payments.yml<\/code>.<\/p>\n\n\n\n
\n\n\n\n
Tax Management<\/h1>\n\n\n\n
Tax Summary<\/h2>\n\n\n\n
\/tax summary<\/code><\/pre>\n\n\n\n
Shows the kingdom\u2019s tax overview.<\/p>\n\n\n\n
Tax Due<\/h2>\n\n\n\n
\/tax due<\/code><\/pre>\n\n\n\n
Shows whether taxes are ready to collect.<\/p>\n\n\n\n
Collect Taxes<\/h2>\n\n\n\n
\/tax collect<\/code><\/pre>\n\n\n\n
Processes weekly taxes.<\/p>\n\n\n\n
This:<\/p>\n\n\n\n
\u2022 Skips citizens in grace period
\u2022 Uses tax credit first
\u2022 Adds unpaid amounts as debt
\u2022 Catches up missed collection weeks<\/code><\/pre>\n\n\n\n
View Citizen Tax Record<\/h2>\n\n\n\n
\/tax status <kingdom> <player><\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/tax status firefly BuilderBob<\/code><\/pre>\n\n\n\n
Correct Citizen Tax Info<\/h2>\n\n\n\n
\/tax set <kingdom> <player> <properties> <shops><\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/tax set firefly BuilderBob 2 1<\/code><\/pre>\n\n\n\n
Preferred newer commands:<\/p>\n\n\n\n
\/kt citizen properties <player> <amount>
\/kt citizen shops <player> <amount><\/code><\/pre>\n\n\n\n
\n\n\n\n
Citizen Management<\/h1>\n\n\n\n
Assign or move a citizen<\/h2>\n\n\n\n
\/kt citizen setkingdom <player> <kingdom><\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/kt citizen setkingdom BuilderBob firefly<\/code><\/pre>\n\n\n\n
Set property count<\/h2>\n\n\n\n
\/kt citizen properties <player> <amount><\/code><\/pre>\n\n\n\n
Set shop count<\/h2>\n\n\n\n
\/kt citizen shops <player> <amount><\/code><\/pre>\n\n\n\n
These are used to correct citizen records without editing players.yml<\/code>.<\/p>\n\n\n\n
\n\n\n\n
Job Management<\/h1>\n\n\n\n
Create a job<\/h2>\n\n\n\n
\/kt job create <jobId> <displayName><\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/kt job create lore_keeper Lore Keeper<\/code><\/pre>\n\n\n\n
Add or edit job description<\/h2>\n\n\n\n
\/kt job description <jobId> <description><\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/kt job description lore_keeper Maintains kingdom records and lore.<\/code><\/pre>\n\n\n\n
Set job pay<\/h2>\n\n\n\n
\/kt job pay <kingdom> <jobId> <amount><\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
\/kt job pay firefly lore_keeper 20<\/code><\/pre>\n\n\n\n
View jobs<\/h2>\n\n\n\n
\/kt job list
\/kt job list <kingdom><\/code><\/pre>\n\n\n\n
Delete a job<\/h2>\n\n\n\n
\/kt job delete <jobId><\/code><\/pre>\n\n\n\n
\n\n\n\n
Job Assignment<\/h1>\n\n\n\n
Jobs can be assigned through:<\/p>\n\n\n\n
\/kt gui<\/code><\/pre>\n\n\n\n
Then click:<\/p>\n\n\n\n
Job Assignment<\/code><\/pre>\n\n\n\n
Citizens can hold multiple jobs.<\/p>\n\n\n\n
Command options:<\/p>\n\n\n\n
\/kt citizen addjob <player> <jobId>
\/kt citizen removejob <player> <jobId>
\/kt citizen clearjobs <player><\/code><\/pre>\n\n\n\n
\n\n\n\n
Payroll<\/h1>\n\n\n\n
Check payroll status<\/h2>\n\n\n\n
\/payroll status<\/code><\/pre>\n\n\n\n
Run payroll<\/h2>\n\n\n\n
\/payroll run<\/code><\/pre>\n\n\n\n
Payroll uses the kingdom\u2019s diamond treasury balance.<\/p>\n\n\n\n
Workers collect wages from the Banker NPC.<\/p>\n\n\n\n
Expire old wages<\/h2>\n\n\n\n
\/payroll expire<\/code><\/pre>\n\n\n\n
Old unclaimed wages can be returned to the treasury after the configured holding period.<\/p>\n\n\n\n
\n\n\n\n
Recommended Royal Workflow<\/h1>\n\n\n\n
1. Open \/kt gui
2. Check Treasury Overview
3. Check Financial Health
4. Check Crown Standing
5. Review Tax Summary
6. Collect taxes if due
7. Review Delinquent Citizens
8. Check Payroll Status
9. Run payroll if available
10. Review Treasury Ledger
11. Review Exchange Ledger
12. Adjust currency rate if needed<\/code><\/pre>\n\n\n\n
\n\n\n\n
Recommended Setup Checklist<\/h1>\n\n\n\n
For each kingdom server:<\/p>\n\n\n\n
[ ] Confirm settings.local-kingdom is correct\n[ ] Set Banker NPC\n[ ] Set Tax Clerk NPC\n[ ] Set Registrar NPC\n[ ] Set Property Clerk NPC\n[ ] Set Shop Clerk NPC\n[ ] Set Exchange NPC\n[ ] Set Treasury Chest (recommended admin access only)\n[ ] Set Donation Chest\n[ ] Set Property Tax Chest\n[ ] Set Shop Tax Chest\n[ ] Confirm \/treasury balance works\n[ ] Confirm \/kt currency info works\n[ ] Test one exchange\n[ ] Check Exchange Ledger<\/code><\/pre>\n\n\n\n
\n\n\n\n
Notes for Admins<\/h1>\n\n\n\n
The plugin now stores player records by UUID where possible while keeping display names readable in commands and GUIs.<\/p>\n\n\n\n
Bedrock display names may include a leading period. The system is designed to recognize Bedrock names with or without the period when matching records.<\/p>\n\n\n\n
Treasury currency is physical and separated:<\/p>\n\n\n\n
diamonds are not emeralds
emeralds are not diamonds<\/code><\/pre>\n\n\n\n
The exchange system moves currency through the treasury instead of creating it from nothing. This keeps the economy cleaner and makes treasury reserves meaningful.<\/p>\n","protected":false},"excerpt":{"rendered":"
Overview Kingdom Treasury gives kingdom leadership tools to manage: Most leadership tools are available through: The plugin uses the server\u2019s configured local kingdom, so most commands no longer require typing the kingdom name every time. Local Kingdom Defaults Each kingdom server should have a local kingdom configured in config.yml. Example: When this is set, commands […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-210","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=\/wp\/v2\/pages\/210","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=210"}],"version-history":[{"count":6,"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=\/wp\/v2\/pages\/210\/revisions"}],"predecessor-version":[{"id":343,"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=\/wp\/v2\/pages\/210\/revisions\/343"}],"wp:attachment":[{"href":"https:\/\/worldofaetherra.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=210"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}