TaxPro

Supported Java Version: Java 17+ Supported Minecraft Versions: 1.13 - 1.20+ 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. --- ## Table of Contents 1. ✨ Features 2. Commands 3. Permissions 4. ️ Placeholders 5. ⚙️ Default Configuration (config.yml) 6. Default Messages (messages.yml) 7. Installation 8. ️ Building --- ## ✨ Features - ** Progressive Wealth Tax**: Automatically runs margin-based wealth tax deductions based on configured tiered brackets. - ** Land Tax**: Taxes players for their active or unused GriefPrevention claim blocks. Includes a sophisticated strike-system that automatically unclaims abandoned properties. - ** Death Penalties**: Highly configurable wallet percentage deductions with world exemptions (e.g., bypass in PvP Arenas). - ** Command Fees**: Charge players in-game money for running commands. Supports custom grouped fees and individual granular overrides with dynamic bypass permissions. - ⏱️ 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! - ⚡ Asynchronous Optimization: Implements background batch processing. TaxPro safely executes heavy calculations on separate threads, guaranteeing it will never cause a server TPS drop. --- ## Commands | Command | Description | Permission Required | |---------|-------------|---------------------| | /tax help | Shows the plugin help menu | tax.admin | | /tax stats | View your personal projected taxes, due dates, and strikes | tax.command.stats | | /tax forcewealth | Force the wealth tax cycle and reset the timer | tax.admin | | /tax forceland | Force the daily land tax cycle and reset the timer | tax.admin | | /tax reload | Reloads all configurations and messages | tax.admin | --- ## Permissions | Permission Node | Description | Default | |-----------------|-------------|---------| | tax.admin | Access to administrative commands | OP | | tax.command.stats | Access to view personal stats | True | | tax.exempt.wealth | Exempts the user from the wealth tax | False | | tax.exempt.land | Exempts the user from the land tax | False | | tax.exempt.deathpenalty | Exempts the user from dropping money on death | False | | tax.exempt.commandfees | Master bypass for all command fees | False | | tax.exempt.commandfees.<group>| Granular bypass for a specific command fee group | False | --- ## ️ Placeholders (Requires PlaceholderAPI) | Placeholder | Returns | |-------------|---------| | %taxpro_wealth_projected% | Projected wealth tax cost (e.g., $150.00 or Exempt ($0.00)) | | %taxpro_land_projected% | Projected land tax cost based on current claims | | %taxpro_strikes% | Current land tax penalty strikes | | %taxpro_strikes_max% | The server's configured maximum strikes | --- ## ⚙️ Default Configuration (config.yml) yaml <br> # ========================================== <br> # TaxPro - Main Config <br> # ========================================== <br> General: <br> Prefix: "&b&lTaxPro &7» &f" <br> Debug-Mode: false <br> # Enable logging tax deductions and payments to taxes.log <br> Log-Transactions: true <br> Integrations: <br> # Requires Vault and a valid Economy provider (e.g., EssentialsX, CMI) <br> Vault-Enabled: true <br> # Requires GriefPrevention <br> GriefPrevention-Enabled: true <br> Wealth-Tax: <br> Enabled: true <br> # Should the tax run automatically based on its frequency? Set to false to only allow manual /tax forcewealth <br> Auto-Run: true <br> # Frequency in hours (168 = 1 week) <br> Frequency-Hours: 168 <br> Brackets: <br> # Marginal tax system: Only taxes the amount within the bracket <br> Tier1: <br> Min: 0 <br> Max: 25000 <br> Rate: 0.0 <br> Base-Fee: 0.0 <br> Tier2: <br> Min: 25001 <br> Max: 100000 <br> Rate: 0.02 <br> Base-Fee: 500.0 <br> Tier3: <br> Min: 100001 <br> Max: 500000 <br> Rate: 0.05 <br> Base-Fee: 5000.0 <br> Tier4: <br> Min: 500001 <br> Max: 2000000 <br> Rate: 0.08 <br> Base-Fee: 40000.0 <br> Tier5: <br> Min: 2000001 <br> Max: -1 # -1 represents infinity <br> Rate: 0.10 <br> Base-Fee: 200000.0 <br> Land-Tax: <br> Enabled: true <br> # Should the tax run automatically based on its frequency? Set to false to only allow manual /tax forceland <br> Auto-Run: true <br> # Frequency in hours (24 = 1 day) <br> Frequency-Hours: 24 <br> cost-Per-Claim-Block: 0.01 <br> # Tax-Method can be: <br> # 'USED' (only blocks currently physically placed/claimed) <br> # 'REMAINING' (blocks sitting in their pool that are NOT physically claimed yet) <br> # 'TOTAL' (their entire block pool unconditionally: Used + Remaining combined) <br> Tax-Method: "USED" <br> Penalty-System: <br> # Max strikes before action is taken <br> Max-Strikes: 2 <br> # Action on max strikes: 'UNCLAIM_OLDEST', 'UNCLAIM_ALL', or 'CUSTOM_COMMAND' <br> Punishment: "CUSTOM_COMMAND" <br> # The command to dispatch from console if Punishment is set to CUSTOM_COMMAND <br> Custom-Command: "cmi jail %player% 1h not paying taxes" <br> Death-Penalty: <br> Enabled: true <br> # Percentage of current wallet balance lost on death <br> Wallet-Percentage: 0.01 <br> # Minimum balance required for the penalty to apply (protects new players) <br> Exempt-Below: 1000.0 <br> # Maximum amount that can be lost in a single death (set to -1 for no cap) <br> Max-Penalty: -1 <br> # List of worlds where the death penalty does NOT apply <br> Exempt-Worlds: <br> - "spawn" <br> Command-Fees: <br> Enabled: true <br> # Players only receive a message if they have insufficient funds. <br> Exempt-Below: 500.0 <br> <br> # Grouped prices: Apply the same fee to a list of commands <br> Groups: <br> Teleportation: <br> Price: 25.0 <br> Commands: <br> - "tpa %" # % represents wildcard <br> - "tpaccept" <br> - "home" <br> <br> # Individual prices: Overrides group prices if a command appears in both <br> Individual: <br> "ec": 50.0 <br> "feed": 15.0 <br> "repair": 500.0 <br> --- ## Default Messages (messages.yml) yaml <br> Wealth-Tax: <br> Broadcast-Start: "%prefix%&eThe weekly Wealth Tax is now being processed..." <br> Broadcast-End: "%prefix%&aWealth Tax collection complete. Thank you for supporting the economy!" <br> Player-Receipt: "%prefix%&7The Taxman has collected &c$%amount% &7based on your wealth bracket. New Balance: &a$%balance%. &7Run [/tax stats] for more information." <br> Exempt: "%prefix%&a[Tax] &7Your wealth falls under the taxation threshold. You are exempt from the Wealth Tax this week." <br> Land-Tax: <br> Broadcast-Start: "%prefix%&bThe daily Land Tax is now being processed..." <br> Broadcast-End: "%prefix%&aLand Tax collection complete. All properties evaluated! test" <br> Player-Receipt: "%prefix%&7Paid &c$%amount% &7upkeep to taxman for &b%blocks% &7claim blocks. New Balance: &a$%balance%. &7Run [/tax stats] for more information." <br> 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!" <br> Strike-Action: "%prefix%&4[ALERT] &cYou failed to pay your Land Tax for multiple days." <br> Death-Penalty: <br> Death-Message: "%prefix%&8[&4Death&8] &7The Styx toll has been collected. You lost &c$%amount% &7from your wallet." <br> Command-Fees: <br> Insufficient-Funds: "&cYou need $%amount% to use this command. Your balance: $%balance%" <br> Errors: <br> No-Permission: "&cYou do not have permission to do this." <br> Vault-Error: "&4Critical Error: Vault integration failed. Please contact an administrator." <br> Stats: <br> Player-Stats: <br> - "&8&m--------&r &eYour Tax Stats &8&m--------" <br> - "&eProjected Wealth Tax: &c-$%wealth_tax_amount% &7(Due in: %wealth_time_remaining%)" <br> - "&eProjected Land Tax: &c-$%land_tax_amount% &7(Due in: %land_time_remaining%)" <br> - "&cActive Penalties: %strikes% Strike(s)" <br> - "&8&m-----------------------------" <br> Tax-Exempt-Format: "&aExempt ($0.00)" <br> --- ## Installation 1. Drop the compiled TaxPro-1.0-SNAPSHOT.jar into your server's /plugins folder. 2. Ensure you have [Vault]( https://www.spigotmc.org/resources/vault.34315/) installed along with an economy provider (like EssentialsX or CMI). 3. Optionally, install [GriefPrevention]( https://www.spigotmc.org/resources/griefprevention.1884/) to utilize the Land Tax feature. 4. Restart your server. --- ## ️ Building Compile the plugin using Maven: bash <br> mvn clean package <br>