AwesomeTaxes

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`.