DonutWorth+ Shopgui Support v1.0.12

​

DonutWorth+ Wiki​

Overview​

DonutWorth+ is a lightweight item worth display plugin designed for Minecraft servers using ShopGUI+.
It automatically reads sell prices from ShopGUI+ and displays item values directly on item lore.

The plugin does not include a separate sell system. It only focuses on showing item worth in a clean and optimized way.

Main Features​

• Automatic item worth lore
• ShopGUI+ sell price support
• Shulker Box content worth calculation
• Toggle command for players
• Reload command for administrators
• Lightweight and optimized event handling
• No custom price list required
• No unnecessary inventory scanning
• No sell commands included

Requirements​

• Paper / Purpur / Spigot compatible server
• ShopGUI+
• Java 17 or newer

Commands​

/worth toggle​

Toggles worth lore visibility for the player.

When enabled, supported items will display their worth in the item lore.

Permission:

donutworth.use

/worth reload​

Reloads the plugin configuration.

Permission:

donutworth.admin

Permissions​

donutworth.use

Allows the player to use /worth toggle.

donutworth.admin

Allows the player to use /worth reload.

Configuration​

Default configuration:

settings:
prefix: '&bDonutWorth+ &8» '

hooks:
shopgui: true

lore:
line: '&7Worth: &a$%worth%'
shulker-line: '&7Shulker Worth: &a$%worth%'

How Pricing Works​

DonutWorth+ does not use a manual prices section.

All item prices are taken directly from ShopGUI+ sell prices.
If an item cannot be sold through ShopGUI+, DonutWorth+ will not add a worth line to that item.

This keeps the plugin simple and prevents price conflicts between multiple systems.

Shulker Box Worth​

DonutWorth+ can calculate the total value of items inside a Shulker Box.

Example lore:

Shulker Worth: $3.02K

Only items with valid ShopGUI+ sell prices are included in the total value.

Lore System​

The plugin adds its own worth line without removing existing item lore.

Example:

Worth: $256

If the item already has a worth line from DonutWorth+, it will be updated instead of duplicated.

Performance Notes​

DonutWorth+ is designed to avoid heavy inventory scans.

Worth lore updates are handled through optimized events such as:

• Player join
• Held item change
• Item pickup

Inventory click scanning is not used by default to prevent unnecessary server load.

The plugin also uses internal caching to reduce repeated ShopGUI+ price lookups.

Installation​

1. Install ShopGUI+ on your server.
2. Place DonutWorth+ in the plugins folder.
3. Restart the server.
4. Configure the lore format if needed.
5. Use /worth reload after configuration changes.

Important Notes​

• DonutWorth+ does not sell items.
• DonutWorth+ does not create custom item prices.
• Item worth is based only on ShopGUI+ sell prices.
• Items without a ShopGUI+ sell price will not show worth lore.
• Shulker values are calculated from sellable items inside the Shulker Box.

Support​

Before reporting an issue, please check:

• ShopGUI+ is installed and working.
• The item has a valid sell price in ShopGUI+.
• The player has the required permission.
• The plugin configuration is valid YAML.