Donut Pay

Instant Economy Upgrade for your Minecraft Server. Turn your standard economy into a modern, customizable payment system instantly.

1,36k

Quick challenge

How far can you run before the mobs catch you?

Donut Pay

Instant Economy Upgrade for your Minecraft Server. Turn your standard economy into a modern, customizable payment system instantly. #

Preview

📥 Installation

Prerequisites: Ensure you have Vault and EssentialsX or something installed on your server.

- Download ``DonutPay.jar.`` - Upload it to your ``/plugins`` folder. - Restart your server. - Done! Start managing transactions with ease.

Example GUI Command: ``/payhistory``

⚙️ Configuration

The ``config.yml`` is generated automatically on first run:

```yaml

----------------------------------------

DonutPay Configuration

----------------------------------------

settings:

Maximum number of transactions to keep per player

history-limit: 45

Should we play a sound when someone receives money?

play-sound: true

gui:

The base title of the inventory

title: "&8ᴛʀᴀɴsᴀᴄᴛɪᴏɴ ʜɪsᴛᴏʀʏ"

Inventory size (multiple of 9)

size: 54 ```

🎮 Commands & Usage

1. Pay a Player

- Send money using smart shorthands (e.g., ``1.5k``, ``2m``).

- Command: `/pay <player> <amount>`

- Permission: ``donutpay.pay``

2. View Transaction History

- Open an interactive, paginated GUI of your past sent/received payments.

- Command: `/payhistory` (Alias: ``/phistory``)

- Permission: `donutpay.history`

3. Toggle Incoming Payments

- Control your privacy by blocking incoming payments from other players.

- Command: ``/paytoggle``

- Permission: ``donutpay.toggle``

4. Check Balances

- Quickly view formatted balances for yourself or others.

- Command: `/bal [player]`

- Permission: `donutpay.bal` / `donutpay.bal.other`

- Pull requests are welcome. For major changes, please open an issue first

- to discuss what you would like to change. >Please make sure to update tests as appropriate.

🛠 Features & Technical Info

Core Features:

- Number Shorthands: Players type `1.5k` instead of `1500`, or `2m` for `2,000,000`! - Hex Color Engine: Fully supports modern `#RRGGBB` and `&#RRGGBB` colors in chat, GUIs, and Action Bars. - Action Bar Alerts: Non-intrusive action bar popups mirroring customized chat messages. - PlaceholderAPI Hook: Use PAPI placeholders seamlessly inside your `messages.yml`.

Technical:

- Built for Spigot, Paper, and Purpur (1.13 - 1.21.11). - Lightweight asynchronous transaction logging (`history.yml`). - Fast UUID-based player toggle storage (`userdata.yml`).