QuickTax/README.md
2023-11-27 22:13:26 +08:00

4.2 KiB

QuickTax

Table of Contents

Introduction

QuickTax is a powerful tax management plugin for your server's economy! If you have always struggled with managing your server's ever-growing economy, then this may very well just be the plugin that you need! Whether it's taxing all players equally or based on their ranks or based on their balance, this plugin supports it all! Want to include property tax by taxing based on claimblocks? It's possible as well! Even better, schedule tax collections so that you can set up once and let the plugin do the rest of the work! Worried about performance? the plugin does most of its task asynchronously, minimizing the performance impact that it can have on your server!

The spigot link to download the plugin can be found here. If you require any assistance, please reach out for support on our discord. Alternatively, you may also open a github issue.

Features

Some of the key features provided by the plugin are as shown below:

  • Collect tax from all players
  • Collect tax from players by rank
  • Collect tax from players by balance
  • Collect tax from a specific player
  • Collect additional tax depending on the number of claimblocks the player has (requires GriefPrevention)
  • Schedule real-time collection of taxes
  • Option to play sound to players on collection
  • Option for players to view next collection time
  • Option for players to self-pay tax directly to the server
  • Track/store player and server tax stats (YAML/MySQL)
  • Withdraw money from the server tax balance
  • Setup taxpayer leaderboard via signs and heads
  • PlaceholderAPI support (requires PlaceholderAPI)
  • Fully customizable messages (with options for your own language files!)

The features above are just a glimpse of what the plugin is capable of. More detailed guides and example setups can be found in our wiki.

Technologies

Technologies used by QuickTax are as below:

Done with:

Java

Project Repository
https://github.com/tjtanjin/QuickTax

Setup

Setting up the QuickTax project locally would involve the following steps:

  1. First, cd to the directory of where you wish to store the project and fork/clone this repository. An example is provided below:
$ cd /home/user/exampleuser/projects/
$ git clone https://github.com/tjtanjin/QuickTax.git
  1. Make any updates/changes you wish to the code. Once ready, you may build the plugin with the following command:
mvn clean install

If you are satisfied with your work and would like to contribute to the project, feel free to open a pull request! The forking workflow is preferred in this case so if you have the intention to contribute from the get-go, consider forking this repository before you start!

Team

Contributing

If you have code to contribute to the project, open a pull request from your fork and describe clearly the changes and what they are intended to do (enhancement, bug fixes etc). Alternatively, you may simply raise bugs or suggestions by opening an issue.

Note that as this was my first minecraft plugin, the structure of the codebase leaves more to be desired. My plan to rewrite the plugin for version 2.0.0 is delayed indefinitely until I am able to free up more time (or until a volunteer comes along 😝)

Others

For any questions regarding the project, please reach out for support via discord.