Checks

A lightweight Paper/Spigot plugin that lets players write physical "checks" - items that can be handed to other players and redeemed for money through Vault.

Features

• Create a check for any amount within a configurable min/max range
• Checks are physical items (paper by default, configurable) that can be traded, dropped, or given to other players like any other item
• Right-click to redeem a check and receive the stored balance
• Optional percentage-based tax on check creation
• Fully configurable messages, sounds, and item appearance
• Permission-based bypasses for balance checks, tax, and money withdrawal
• In-game config reload - no restart required

Requirements

• Paper 1.21+ (or a compatible Spigot/Bukkit fork)
• Vault
• A Vault-compatible economy plugin (e.g. EssentialsX)

Note: The plugin will disable itself on startup if Vault or a compatible economy provider isnt found.

Installation

1. Download the latest checks-*.jar from the Releases page.
2. Make sure Vault and an economy plugin (like EssentialsX) are installed on your server.
3. Drop the jar into your servers plugins/ folder.
4. Restart the server.
5. A default config.yml will be generated in plugins/checks/ - edit it to your liking and run /check reload.

Commands

Command	Description	Permission
/check <amount>	Creates a check for the given amount	checks.createcheck
/check <amount> <quantity>	Creates multiple checks of the same value	checks.createcheck
/check tax	Displays the current server tax rate	checks.gettax
/check reload	Reloads the plugins configuration	checks.reload

Permissions

Permission	Effect
checks.createcheck	Allows creating checks
checks.gettax	Allows viewing the current tax rate
checks.reload	Allows reloading the config
checks.dontcheckbalance	Bypasses the balance check on creation (if enabled in config)
checks.donttaketax	Exempts the player from tax on creation (if enabled in config)
checks.donttakemoney	Prevents money from being withdrawn on creation (if enabled in config)

Configuration

All amounts, messages, sounds and behavior toggles live in config.yml. Message strings support the following placeholders where applicable:

Placeholder	Description
{user}	Name of the player running the command
{amount}	The check's face value
{tax}	The server's tax percentage
{taxAmount}	The amount taken as tax
{total}	Amount withdrawn from the player (amount * quantity + tax)
{quantity}	How many checks are created
{total-tax}	Amount withdrawn from the player without tax

See the comments in config.yml for a full list of available options.

Building from source

git clone https://github.com/jarabum/Checks.git
cd Checks
mvn clean package

The compiled jar will be in target/. The plugin may be unstable if building from source.

Contributing

Issues and pull requests are welcome. If you find a bug or have a feature request please open an issue with as much detail as possible (server version, plugin version, steps to reproduce).