Описание
# 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](https://www.spigotmc.org/resources/vault.34315/) and [EssentialsX](https://www.spigotmc.org/resources/essentialsx.9089/) 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
# Author: NotDelulu
# Version: 2.3
# Date: 10/5/2026
# ==========================================
settings:
# Maximum number of transactions to keep per player
history-limit: 999
# Should we play a sound when someone receives money?
play-sound: true
# Should payment confirmations be ON by default for all players?
default-confirm: true
gui:
# The base title of the inventory (Page numbers will be added automatically)
title: "&8ᴛʀᴀɴsᴀᴄᴛɪᴏɴ ʜɪsᴛᴏʀʏ"
# Must be a multiple of 9 (e.g., 27, 36, 45, 54). 54 is recommended.
size: 54
items:
sent-material: "PAPER"
received-material: "MAP"
back-material: "ARROW"
back-name: "&c&lPrevious Page"
next-material: "ARROW"
next-name: "&a&lNext Page"
confirm-gui:
# Global setting to enable/disable the Confirm GUI system server-wide
enabled: true
# Title of the confirmation menu
title: "&8Confirm Payment"
```
## 🎮 Commands & Usage
### 1. Pay a Player
- Send money using smart shorthands (e.g., ``1.5k``, ``2m``).
- Command: `/pay `
- 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`).
##
### Thank for support
>Made with ❤️ by NotDelulu and Ly_No