ShopUI

ShopUI is a form-based item shop plugin for PowerNukkitX. Players can browse configurable categories, select an item and quantity, review the total price, and buy or sell items using their economy balance.

Requirements

Java 21 or higher
LlamaEconomy

ShopUI will load without LlamaEconomy because it is declared as a soft dependency, but the shop cannot process transactions until an economy provider is available.

Installation

Download ShopUI
Install and configure LlamaEconomy.
Copy ShopUI.jar into the server's plugins directory.
Start the server once to generate the default configuration.
Edit plugins/ShopUI/config.yml to configure the shop.
Restart the server after changing the configuration.

Usage

/shop opens the purchase menu (items with an enabled buy price).
/sell opens the sale menu (items with an enabled sell price).
/sell hand sells items from the held stack only.
/sell all sells all saleable items in the players inventory.

Direct sales use the package size configured as amount and the sell price per package. For example, with 13 items and amount: 2, 12 are sold and 1 remains. Unsaleable items and incomplete packages stay in the inventory. max-sale-steps only limits the menu slider, not these commands. If multiple entries match the same item, they are processed in configuration order using the remaining items, so no item is sold twice.

Both commands use the same configured categories and show only categories with available items for their action. Select a category, item and quantity, then confirm the transaction. Both commands can only be used by a player.

Existing server configurations are not overwritten on update. Add sell prices to plugins/ShopUI/config.yml to enable sales, then restart the server.

Setting	Description	Default
`max-sale-steps`	Maximum number of sale quantity options, also limited by inventory contents. Values below `1` are treated as `1`.	`16`
`max-purchase-steps`	Maximum number of options shown in the quantity slider. Values below `1` are treated as `1`.	`16`

Setting	Required	Description
Category ID	Yes	Unique YAML key used internally, such as `building_blocks`.
`name`	No	Display name. If omitted, the category ID is formatted automatically.
`icon`	No	Bedrock resource-pack texture path used by the category button.
`entries`	Yes	Section containing the tradable items.

Setting	Required	Description
Entry ID	Yes	Unique YAML key inside its category. It is also used as the default display name.
`item`	Yes	PowerNukkitX item identifier, for example `minecraft:stone`.
`amount`	Yes	Number of items in one package and the increment used by the quantity slider. Must be between `1` and `64`.
`buy`	No	Purchase price per package. Omit or set to `-1` to disable buying; `0` enables free purchases.
`sell`	No	Sale price per package. Omit or set to `-1` to disable selling; `0` enables sales without payment.
`custom-name`	No	Custom name applied to the purchased item and shown in the shop.
`thumbnail`	No	Bedrock resource-pack texture path used by the item button.

ShopUI

ShopUI

Requirements

Installation

Usage

Configuration

Global settings

Category settings

Item settings

Quantity slider

Languages