Official Player Guide and Server Handbook

KT Admin Guide

Overview

Kingdom Treasury gives kingdom leadership tools to manage:

• Citizens
• Taxes
• Jobs
• Payroll
• Treasury balances
• Donations
• Royal payments
• Withdrawals
• Currency exchange
• Ledgers

Most leadership tools are available through:

/kt gui

The plugin uses the server’s 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:

settings:
  local-kingdom: firefly

When this is set, commands like these use the local kingdom automatically:

/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

Long versions still work:

/kt gui firefly
/tax summary firefly
/payroll run firefly
/treasury balance firefly

Commands for the wrong kingdom should be blocked on non-local servers.

Royal Dashboard

Open the main dashboard with:

/kt gui

The dashboard includes:

• Treasury Overview
• Financial Health
• Crown Standing
• Currency Rate
• Tax Summary
• Tax Rules
• Owing Citizens
• Grace Period Citizens
• Covered Citizens
• Delinquent Citizens
• Payroll Status
• Run Payroll
• Job Assignment
• Treasury Ledger
• Exchange Ledger
• Collect Taxes

NPC Setup

Before setting an NPC, select it with:

/npc select

Then use the appropriate setup command.

Banker NPC

/kt npc setbanker

Citizens use this NPC to collect wages and pending payments.

Tax Clerk NPC

/kt npc settaxclerk

Citizens use this NPC to view their tax records.

Registrar NPC

/kt npc setregistrar

Citizens use this NPC to join the kingdom.

Property Clerk NPC

/kt npc setpropertyclerk

Citizens use this NPC to increase their property count.

Shop Clerk NPC

/kt npc setshopclerk

Citizens use this NPC to increase their shop count.

Exchange NPC

/kt npc setexchange

Citizens use this NPC to exchange diamonds and emeralds.

Long versions are also supported:

/kt npc setbanker firefly
/kt npc setexchange firefly

Chest Setup

Look at the chest, then run the setup command.

Treasury Chest

/kt chest set treasury <kingdom>

Used for royal treasury deposits.

Accepts:

• Diamonds
• Diamond blocks
• Emeralds
• Emerald blocks

Donation Chest

/kt chest set donation <kingdom>

Used for citizen donations.

Accepts:

• Diamonds
• Diamond blocks
• Emeralds
• Emerald blocks

Property Tax Chest

/kt chest set property-tax <kingdom>

Used for property tax payments.

Accepts:

• Diamonds
• Diamond blocks

Shop Tax Chest

/kt chest set shop-tax <kingdom>

Used for shop tax payments.

Accepts:

• Diamonds
• Diamond blocks

Emeralds are not accepted for tax chests.

Treasury Balances

Treasuries now track two physical balances:

• Diamond balance
• Emerald balance

View balances with:

/treasury balance

The diamond balance remains the primary operating balance for taxes, payroll, and most payments.

Treasury Withdrawals

Royals can withdraw from the treasury with a required reason.

/treasury withdraw <amount> [diamonds|emeralds] <reason>

Examples:

/treasury withdraw 20 diamonds paid visiting mason
/treasury withdraw 18 emeralds event prize

If no currency is specified, the withdrawal defaults to diamonds.

Long version:

/treasury withdraw <kingdom> <amount> [diamonds|emeralds] <reason>

Examples:

/treasury withdraw firefly 20 diamonds bridge repair
/treasury withdraw firefly 18 emeralds festival prize

Withdrawals are logged in payments.yml.

Withdrawals pay in compact item form when possible.

Treasury Payments

To prepare a payment for a citizen:

/treasury pay <kingdom> <player> <amount> [reason]

Example:

/treasury pay firefly BuilderBob 30 marketplace repairs

This removes diamonds from the treasury and adds the amount to the player’s pending pay.

The citizen collects the payment from the Banker NPC.

Currency Rates

Each kingdom has its own exchange rate.

View the current rate:

/kt currency info

Set the rate:

/kt currency rate <emeraldsPerDiamond>

Examples:

/kt currency rate 2
/kt currency rate 3

Long versions:

/kt currency info firefly
/kt currency rate firefly 2

The rate means:

1 diamond = X emeralds

Example:

/kt currency rate 2

Means:

1 diamond = 2 emeralds

Exchange NPC

The Exchange NPC allows players to trade diamonds and emeralds using the kingdom’s exchange rate.

The exchange is treasury-backed.

Diamonds to Emeralds

When a citizen exchanges diamonds for emeralds:

• Player gives diamonds
• Treasury gains diamonds
• Treasury loses emeralds
• Player receives emeralds

The exchange only succeeds if the treasury has enough emeralds.

Emeralds to Diamonds

When a citizen exchanges emeralds for diamonds:

• Player gives emeralds
• Treasury gains emeralds
• Treasury loses diamonds
• Player receives diamonds

The exchange only succeeds if the treasury has enough diamonds.

Emerald-to-diamond exchanges must divide evenly by the kingdom’s rate.

Exchange Ledger

Exchange activity is recorded automatically.

Royals can view recent exchanges through:

/kt gui

Then click:

Exchange Ledger

The ledger shows:

• Player
• Exchange direction
• Amount given
• Amount received
• Exchange rate
• Timestamp

Exchange logs are also stored in payments.yml.

Tax Management

Tax Summary

/tax summary

Shows the kingdom’s tax overview.

Tax Due

/tax due

Shows whether taxes are ready to collect.

Collect Taxes

/tax collect

Processes weekly taxes.

This:

• Skips citizens in grace period
• Uses tax credit first
• Adds unpaid amounts as debt
• Catches up missed collection weeks

View Citizen Tax Record

/tax status <kingdom> <player>

Example:

/tax status firefly BuilderBob

Correct Citizen Tax Info

/tax set <kingdom> <player> <properties> <shops>

Example:

/tax set firefly BuilderBob 2 1

Preferred newer commands:

/kt citizen properties <player> <amount>
/kt citizen shops <player> <amount>

Citizen Management

Assign or move a citizen

/kt citizen setkingdom <player> <kingdom>

Example:

/kt citizen setkingdom BuilderBob firefly

Set property count

/kt citizen properties <player> <amount>

Set shop count

/kt citizen shops <player> <amount>

These are used to correct citizen records without editing players.yml.

Job Management

Create a job

/kt job create <jobId> <displayName>

Example:

/kt job create lore_keeper Lore Keeper

Add or edit job description

/kt job description <jobId> <description>

Example:

/kt job description lore_keeper Maintains kingdom records and lore.

Set job pay

/kt job pay <kingdom> <jobId> <amount>

Example:

/kt job pay firefly lore_keeper 20

View jobs

/kt job list
/kt job list <kingdom>

Delete a job

/kt job delete <jobId>

Job Assignment

Jobs can be assigned through:

/kt gui

Then click:

Job Assignment

Citizens can hold multiple jobs.

Command options:

/kt citizen addjob <player> <jobId>
/kt citizen removejob <player> <jobId>
/kt citizen clearjobs <player>

Payroll

Check payroll status

/payroll status

Run payroll

/payroll run

Payroll uses the kingdom’s diamond treasury balance.

Workers collect wages from the Banker NPC.

Expire old wages

/payroll expire

Old unclaimed wages can be returned to the treasury after the configured holding period.

Recommended Royal Workflow

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

Recommended Setup Checklist

For each kingdom server:

[ ] Confirm settings.local-kingdom is correct
[ ] Set Banker NPC
[ ] Set Tax Clerk NPC
[ ] Set Registrar NPC
[ ] Set Property Clerk NPC
[ ] Set Shop Clerk NPC
[ ] Set Exchange NPC
[ ] Set Treasury Chest (recommended admin access only)
[ ] Set Donation Chest
[ ] Set Property Tax Chest
[ ] Set Shop Tax Chest
[ ] Confirm /treasury balance works
[ ] Confirm /kt currency info works
[ ] Test one exchange
[ ] Check Exchange Ledger

Notes for Admins

The plugin now stores player records by UUID where possible while keeping display names readable in commands and GUIs.

Bedrock display names may include a leading period. The system is designed to recognize Bedrock names with or without the period when matching records.

Treasury currency is physical and separated:

diamonds are not emeralds
emeralds are not diamonds

The exchange system moves currency through the treasury instead of creating it from nothing. This keeps the economy cleaner and makes treasury reserves meaningful.