# \ud83c\udfe6 TaxPro<\/p>\n
**Supported Java Version:** Java 17+
\n**Supported Minecraft Versions:** 1.13 – 1.20+ <\/p>\n
A high-performance, completely lag-free economy and taxation plugin for Spigot\/Paper servers. Built to handle massive player bases with seamless GriefPrevention and Vault integration.<\/p>\n
—<\/p>\n
## \ud83d\udcd1 Table of Contents
\n1. [\u2728 Features](#-features)
\n2. [\ud83d\udcbb Commands](#-commands)
\n3. [\ud83d\udd10 Permissions](#-permissions)
\n4. [\ud83c\udff7\ufe0f Placeholders](#\ufe0f-placeholders)
\n5. [\u2699\ufe0f Default Configuration (`config.yml`)](#\ufe0f-default-configuration-configyml)
\n6. [\ud83d\udcac Default Messages (`messages.yml`)](#-default-messages-messagesyml)
\n7. [\ud83d\udce5 Installation](#-installation)
\n8. [\ud83d\udee0\ufe0f Building](#\ufe0f-building)<\/p>\n
—<\/p>\n
## \u2728 Features
\n– **\ud83d\udcc8 Progressive Wealth Tax**: Automatically runs margin-based wealth tax deductions based on configured tiered brackets.
\n– **\ud83c\udfe1 Land Tax**: Taxes players for their active or unused GriefPrevention claim blocks. Includes a sophisticated strike-system that automatically unclaims abandoned properties.
\n– **\ud83d\udc80 Death Penalties**: Highly configurable wallet percentage deductions with world exemptions (e.g., bypass in PvP Arenas).
\n– **\ud83d\udcb8 Command Fees**: Charge players in-game money for running commands. Supports custom grouped fees and individual granular overrides with dynamic bypass permissions.
\n– **\u23f1\ufe0f Dynamic Data Persistence**: All timers use persistent Unix timestamps. Even if your server crashes or goes offline for a week, it perfectly tracks exactly when the next tax is due!
\n– **\u26a1 Asynchronous Optimization**: Implements background batch processing. TaxPro safely executes heavy calculations on separate threads, guaranteeing it will never cause a server TPS drop.<\/p>\n
—<\/p>\n
## \ud83d\udcbb Commands<\/p>\n
| Command | Description | Permission Required |
\n|———|————-|———————|
\n| `\/tax help` | Shows the plugin help menu | `tax.admin` |
\n| `\/tax stats` | View your personal projected taxes, due dates, and strikes | `tax.command.stats` |
\n| `\/tax forcewealth` | Force the wealth tax cycle and reset the timer | `tax.admin` |
\n| `\/tax forceland` | Force the daily land tax cycle and reset the timer | `tax.admin` |
\n| `\/tax reload` | Reloads all configurations and messages | `tax.admin` |<\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission Node | Description | Default | —<\/p>\n ## \ud83c\udff7\ufe0f Placeholders | Placeholder | Returns | —<\/p>\n ## \u2699\ufe0f Default Configuration (`config.yml`)<\/p>\n “`yaml General: Integrations: Wealth-Tax: Land-Tax: Death-Penalty: Command-Fees: # Grouped prices: Apply the same fee to a list of commands # Individual prices: Overrides group prices if a command appears in both “`<\/p>\n —<\/p>\n ## \ud83d\udcac Default Messages (`messages.yml`)<\/p>\n “`yaml Land-Tax: Death-Penalty: Command-Fees: Errors: Stats: Tax-Exempt-Format: “&aExempt ($0.00)” —<\/p>\n ## \ud83d\udce5 Installation —<\/p>\n ## \ud83d\udee0\ufe0f Building A high-performance, completely lag-free economy and taxation plugin for Spigot\/Paper servers. Built to handle massive player bases with seamless GriefPrevention and Vault integration.<\/p>\n","protected":false},"featured_media":152226,"template":"","meta":{"_minecraft_slug":"taxpro","_minecraft_project_id":"d11Jyes3","_minecraft_author":"AbhinavSanthosh","_minecraft_license":"MIT","_minecraft_downloads":2,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"taxpro.zip","_minecraft_size_bytes":35969,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:19:38.093572Z","_minecraft_date_created":"2026-05-06T02:26:42.717362Z","_minecraft_date_modified":"2026-04-29T12:20:37.953193Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/taxpro","_minecraft_icon_attachment_id":152226,"_minecraft_imported_at":"2026-06-09T04:49:33+00:00","_minecraft_import_hash":"98f2accbd9fb66f0bb9ebff937a459e9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167],"class_list":["post-152225","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1"],"yoast_head":"\n
\n|—————–|————-|———|
\n| `tax.admin` | Access to administrative commands | OP |
\n| `tax.command.stats` | Access to view personal stats | True |
\n| `tax.exempt.wealth` | Exempts the user from the wealth tax | False |
\n| `tax.exempt.land` | Exempts the user from the land tax | False |
\n| `tax.exempt.deathpenalty` | Exempts the user from dropping money on death | False |
\n| `tax.exempt.commandfees` | Master bypass for all command fees | False |
\n| `tax.exempt.commandfees.
\n*(Requires PlaceholderAPI)*<\/p>\n
\n|————-|———|
\n| `%taxpro_wealth_projected%` | Projected wealth tax cost (e.g., `$150.00` or `Exempt ($0.00)`) |
\n| `%taxpro_land_projected%` | Projected land tax cost based on current claims |
\n| `%taxpro_strikes%` | Current land tax penalty strikes |
\n| `%taxpro_strikes_max%` | The server’s configured maximum strikes |<\/p>\n
\n# ==========================================
\n# TaxPro – Main Config
\n# ==========================================<\/p>\n
\n Prefix: “&b&lTaxPro &7\u00bb &f”
\n Debug-Mode: false
\n # Enable logging tax deductions and payments to taxes.log
\n Log-Transactions: true<\/p>\n
\n # Requires Vault and a valid Economy provider (e.g., EssentialsX, CMI)
\n Vault-Enabled: true
\n # Requires GriefPrevention
\n GriefPrevention-Enabled: true<\/p>\n
\n Enabled: true
\n # Should the tax run automatically based on its frequency? Set to false to only allow manual \/tax forcewealth
\n Auto-Run: true
\n # Frequency in hours (168 = 1 week)
\n Frequency-Hours: 168
\n Brackets:
\n # Marginal tax system: Only taxes the amount within the bracket
\n Tier1:
\n Min: 0
\n Max: 25000
\n Rate: 0.0
\n Base-Fee: 0.0
\n Tier2:
\n Min: 25001
\n Max: 100000
\n Rate: 0.02
\n Base-Fee: 500.0
\n Tier3:
\n Min: 100001
\n Max: 500000
\n Rate: 0.05
\n Base-Fee: 5000.0
\n Tier4:
\n Min: 500001
\n Max: 2000000
\n Rate: 0.08
\n Base-Fee: 40000.0
\n Tier5:
\n Min: 2000001
\n Max: -1 # -1 represents infinity
\n Rate: 0.10
\n Base-Fee: 200000.0<\/p>\n
\n Enabled: true
\n # Should the tax run automatically based on its frequency? Set to false to only allow manual \/tax forceland
\n Auto-Run: true
\n # Frequency in hours (24 = 1 day)
\n Frequency-Hours: 24
\n cost-Per-Claim-Block: 0.01
\n # Tax-Method can be:
\n # ‘USED’ (only blocks currently physically placed\/claimed)
\n # ‘REMAINING’ (blocks sitting in their pool that are NOT physically claimed yet)
\n # ‘TOTAL’ (their entire block pool unconditionally: Used + Remaining combined)
\n Tax-Method: “USED”
\n Penalty-System:
\n # Max strikes before action is taken
\n Max-Strikes: 2
\n # Action on max strikes: ‘UNCLAIM_OLDEST’, ‘UNCLAIM_ALL’, or ‘CUSTOM_COMMAND’
\n Punishment: “CUSTOM_COMMAND”
\n # The command to dispatch from console if Punishment is set to CUSTOM_COMMAND
\n Custom-Command: “cmi jail %player% 1h not paying taxes”<\/p>\n
\n Enabled: true
\n # Percentage of current wallet balance lost on death
\n Wallet-Percentage: 0.01
\n # Minimum balance required for the penalty to apply (protects new players)
\n Exempt-Below: 1000.0
\n # Maximum amount that can be lost in a single death (set to -1 for no cap)
\n Max-Penalty: -1
\n # List of worlds where the death penalty does NOT apply
\n Exempt-Worlds:
\n – “spawn”<\/p>\n
\n Enabled: true
\n # Players only receive a message if they have insufficient funds.
\n Exempt-Below: 500.0<\/p>\n
\n Groups:
\n Teleportation:
\n Price: 25.0
\n Commands:
\n – “tpa %” # % represents wildcard
\n – “tpaccept”
\n – “home”<\/p>\n
\n Individual:
\n “ec”: 50.0
\n “feed”: 15.0
\n “repair”: 500.0<\/p>\n
\nWealth-Tax:
\n Broadcast-Start: “%prefix%&eThe weekly Wealth Tax is now being processed…”
\n Broadcast-End: “%prefix%&aWealth Tax collection complete. Thank you for supporting the economy!”
\n Player-Receipt: “%prefix%&7The Taxman has collected &c$%amount% &7based on your wealth bracket. New Balance: &a$%balance%. &7Run [\/tax stats] for more information.”
\n Exempt: “%prefix%&a[Tax] &7Your wealth falls under the taxation threshold. You are exempt from the Wealth Tax this week.”<\/p>\n
\n Broadcast-Start: “%prefix%&bThe daily Land Tax is now being processed…”
\n Broadcast-End: “%prefix%&aLand Tax collection complete. All properties evaluated! test”
\n Player-Receipt: “%prefix%&7Paid &c$%amount% &7upkeep to taxman for &b%blocks% &7claim blocks. New Balance: &a$%balance%. &7Run [\/tax stats] for more information.”
\n Strike-Warning: “%prefix%&e[Warning] &cYou had insufficient funds to pay your Land Tax! &7Strike: &c%strikes%\/2&7. Fund your account to avoid claim deletion!”
\n Strike-Action: “%prefix%&4[ALERT] &cYou failed to pay your Land Tax for multiple days.”<\/p>\n
\n Death-Message: “%prefix%&8[&4Death&8] &7The Styx toll has been collected. You lost &c$%amount% &7from your wallet.”<\/p>\n
\n Insufficient-Funds: “&cYou need $%amount% to use this command. Your balance: $%balance%”<\/p>\n
\n No-Permission: “&cYou do not have permission to do this.”
\n Vault-Error: “&4Critical Error: Vault integration failed. Please contact an administrator.”<\/p>\n
\n Player-Stats:
\n – “&8&m——–&r &eYour Tax Stats &8&m——–”
\n – “&eProjected Wealth Tax: &c-$%wealth_tax_amount% &7(Due in: %wealth_time_remaining%)”
\n – “&eProjected Land Tax: &c-$%land_tax_amount% &7(Due in: %land_time_remaining%)”
\n – “&cActive Penalties: %strikes% Strike(s)”
\n – “&8&m—————————–”<\/p>\n
\n“`<\/p>\n
\n1. Drop the compiled `TaxPro-1.0-SNAPSHOT.jar` into your server’s `\/plugins` folder.
\n2. Ensure you have Vault installed along with an economy provider (like EssentialsX or CMI).
\n3. Optionally, install GriefPrevention to utilize the Land Tax feature.
\n4. Restart your server.<\/p>\n
\n1) Download the source code from Github.
\n2) Compile the plugin using Maven:
\n“`bash
\nmvn clean package
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"