DonutBillford

DonutBillford is a lightweight trading system designed by SirSnaryo for DonutSMP, owned by DrDonutt. Players open a clean 6-row GUI to view trade recipes and exchange items instantly. Server owners configure required ingredients and rewards

325

Quick challenge

How far can you run before the mobs catch you?

DonutBillford

DonutBillford

Paper Purpur Spigot Bukkit Modrinth

---

Discord
<i>Please contact me on Discord if you have any suggestions or edits.</i>

---

What

- DonutBillford makes a Billford Command exactly like the famous Server "DonutSMP"

---

Features

- Update Checker – `/billford` opens the GUI instantly - Update Checker – 9 slots like a crafting table - Update Checker – Real-time inventory checks - Update Checker – Custom messages, sounds, and titles - Update Checker – No extra plugins needed - Update Checker – `&#RRGGBB` works everywhere - Update Checker – Configure every element - Update Checker – Skips invalid items safely - Update Checker – Fixes broken configs automatically - Update Checker – Natural rarity colors (white/aqua/purple) - Update Checker – Works on 1.21.x and latest snapshots - Update Checker – Modrinth notifications on join

---

Commands

| Command | Access | Description | | :--- | :--- | :--- | | `donutbillford.use` | Everyone | Opens the billford GUI | | `donutbillford.reload` | Operator | Reloads the configuration file | | `donutbillford credits` | Everyone | Shows credits for the creator and some information|

---

Configuration

- A folder named `DonutBillford` is created in your `plugins` folder automatically. Inside you will find a clean `config.yml and trade.yml` files.

Config.yml

```yml

==========================================================

#

DonutBillford — config.yml

by SirSnaryo

#

Works on: Paper · Spigot · Bukkit · Purpur

Version: 1.21.x

#

==========================================================

# #

┌─────────────────────────────────────────────────────────┐

│ COLOR CODES │

├─────────────────────────────────────────────────────────┤

│ &f = white &7 = gray &0 = black │

│ &a = green &c = red &e = yellow │

│ &b = aqua &9 = blue &d = purple │

│ &l = bold &o = italic &r = reset all │

│ &#RRGGBB = any hex color (e.g. &#FF5500 = orange) │

└─────────────────────────────────────────────────────────┘

# #

┌─────────────────────────────────────────────────────────┐

│ PLACEHOLDERS │

├─────────────────────────────────────────────────────────┤

│ [amount] → the amount of an item │

│ [item] → the name of an item with vanilla color │

└─────────────────────────────────────────────────────────┘

# #

┌─────────────────────────────────────────────────────────┐

│ BROKEN CONFIG │

├─────────────────────────────────────────────────────────┤

│ If you break this file the plugin automatically │

│ deletes it and regenerates a clean copy on startup. │

└─────────────────────────────────────────────────────────┘

#

==========================================================

billford-command: "billford"

container-name: "&fʙɪʟʟꜰᴏʀᴅ"

empty-slot-item: "BLACK_STAINED_GLASS_PANE" empty-slot-name: "" empty-slot-description: line-1: "" line-2: "" line-3: ""

trading-slots: slot-1: row: 2 slot: 2 slot-2: row: 2 slot: 3 slot-3: row: 2 slot: 4 slot-4: row: 3 slot: 2 slot-5: row: 3 slot: 3 slot-6: row: 3 slot: 4 slot-7: row: 4 slot: 2 slot-8: row: 4 slot: 3 slot-9: row: 4 slot: 4

trade-button: row: 3 slot: 6 item: "HOPPER" name: "&8ᴛʀᴀᴅᴇ" description: line-1: "&fClick to confirm your trade" line-2: "" line-3: "&7(you need the items in your inventory)" sound: enabled: true sound: "UI_BUTTON_CLICK"

result-item: row: 3 slot: 8

ingredients-book: row: 6 slot: 5 item: "BOOK" name: "&#10E336ʙɪʟʟꜰᴏʀᴅ'ꜱ ᴛʀᴀᴅᴇ" ingredients-line: "&7[amount]x [item]" for-line: "&7for" billford-trade-line: "&7[amount]x [item]"

trade-failed: chat: enabled: true message: "&cYou do not have all the required contents." actionbar: enabled: true message: "&cYou do not have all the required contents." title: enabled: false message: "&cTrade Failed" subtitle: "&7You are missing required items." fade-in: 10 stay: 40 fade-out: 10 sound: enabled: true sound: "ENTITY_VILLAGER_NO"

trade-success: chat: enabled: true message: "&7Traded for [amount]x [item]" actionbar: enabled: true message: "&7Traded for [amount]x [item]" title: enabled: false message: "&aTrade Success" subtitle: "&7You received [amount]x [item]" fade-in: 10 stay: 40 fade-out: 10 sound: enabled: false sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

reload: chat: enabled: true message: "&aReloaded Trade.yml and Config.yml" actionbar: enabled: true message: "&aReloaded Trade.yml and Config.yml" sound: enabled: true sound: "ENTITY_EXPERIENCE_ORB_PICKUP" ```

---

Installation

- Done the latest version of Done. - Done the `.jar` file into your server's `plugins` folder. - Done your server. - Done! setup required.

---

Modrinth Gallery

Example

--- © 2026 DonutBillford. All rights reserved to MIT.

Donate via PayPal

ADS