AwesomeTaxes

AwesomeTaxes is a survival-friendly taxes and rent plugin for Paper 1.21.4–1.21.8. Admins define house regions, set a tax item/amount, start waves, and players pay with the required items in hand to receive a receipt. Defaulters are tracked automatically.

Highlights

• Non-overlapping house regions with numeric IDs (H-001, H-002…).
• Admin-only tax setup from the item stack in hand (stack size = required amount).
• Manual waves plus optional auto-rent cycles via config.yml.
• Payment modes: save (store items for admins) or delete (remove permanently).
• Receipts handed directly to payers; vault GUI to review cycles and withdraw saved items.
• Last three cycles kept; defaulters listed per cycle.

Quick Start

1. Claim a house
   /taxes pos1, /taxes pos2, then /taxes create <name> → note the ID (e.g., H-001).
   Check details with /taxes info H-001 or /taxes myhouses.
2. Configure tax (admin, awesometaxes.admin.taxes)
   Hold the tax item stack (amount in hand = required amount) and run /taxes admin setitem H-001.
3. Run a wave (admin, awesometaxes.admin.cycles)
   /taxes admin startwave <duration> (examples: 10m, 1h, 1200t).
   Players pay during the wave with /taxes pay <houseId> while holding the required items; items are removed, and a receipt is given.
4. Review results
   /taxes admin vault [cycleId] to view houses (left-click = teleport near the house, right-click = withdraw stored items in save mode).
   /taxes admin defaulters [cycleId] to list unpaid houses.

Commands

Players

• /taxes pos1 & /taxes pos2 – set region corners.
• /taxes create <name> – create a house.
• /taxes myhouses – list owned/member houses.
• /taxes info <houseId> – details for a house.
• /taxes pay <houseId> – pay taxes with required items in hand (active wave).
• /taxes addmember <houseId> <player> – add member (trusted permission).
• /taxes removemember <houseId> <player> – remove member (trusted permission).

Admins

• /taxes admin setitem <houseId> – set required tax item/amount from hand.
• /taxes admin startwave <duration> – start a tax wave.
• /taxes admin cancelwave – cancel the active wave.
• /taxes admin status – wave status/last cycle.
• /taxes admin vault [cycleId] – open the vault GUI.
• /taxes admin defaulters [cycleId] – list unpaid houses.
• /taxes admin houseinfo <houseId> – detailed house info.
• /taxes admin setowner <houseId> <player> – transfer ownership.
• /taxes admin markpaid <houseId> <cycleId> – manually mark paid.
• /taxes admin reload – reload configuration and data.

Permissions

• awesometaxes.player – base player access.
• awesometaxes.player.members – trusted players can add/remove members.
• awesometaxes.admin – base admin access.
• awesometaxes.admin.taxes – set tax item/amount.
• awesometaxes.admin.cycles – start/cancel waves, view status/defaulters.
• awesometaxes.admin.vault – open the admin vault GUI.

Configuration

• settings.maxHousesPerPlayer – per-player house cap.
• settings.paymentMode – save (store items for vault) or delete.
• settings.autoCycle.enabled/intervalTicks/durationTicks – optional repeating rent wave.
• settings.storeCycles – number of recent cycles retained (default 3).
• Messages/prefix are in config.yml.