TheBrewingMarket

A Paper plugin that adds a sell GUI for brews from TheBrewingProject and BreweryX. Players open a chest-like menu, place their brews inside, and sell them for money via Vault.

Features

• Multi-plugin support — Works with TheBrewingProject and BreweryX (auto-detected)
• Sell GUI — Players place brews in a visual menu and sell them with one click
• Sell All — Option to sell brews from both the GUI and the player's entire inventory
• Shulker box selling — Sell All scans shulker boxes in the player's inventory (toggleable per-player via permission)
• Sell history — View sell records with time-based filtering (e.g. 1h, 1d, 1w) and pagination
• Quality-based pricing — Final price scales with brew quality using TheBrewingProject scoring API
• Per-recipe prices — Set custom prices for each recipe or define your own
• Group prices — Define a single base price for multiple recipes at once instead of repeating the same value
• Daily earnings limit — Optional per-player daily cap on how much money can be earned from the market
• Sealed brew support — Correctly handles sealed brews with fallback logic
• PlaceholderAPI support — ~28 placeholders covering daily earnings, lifetime stats, per-recipe data, and global market analytics (optional)
• Database support — SQLite (default), MySQL, and MariaDB with automatic schema migrations
• Fully customizable GUI — Grid-based layout system with configurable icons, colors, and decorations
• MiniMessage support — All text fields support MiniMessage formatting (gradients, colors, fonts)
• Minecraft data components — Icons support custom names, lore, player head textures, enchantment glint, custom model data, potion colors, tooltip control, and more
• Multi-language — Ships with English (en_US) and Spanish (es_ES). Easy to add custom translations
• Configurable sounds — Customize feedback sounds for sell/deny actions

Requirements

• Paper (tested in 1.21.9+)
• Vault (with an economy provider like EssentialsX)
• TheBrewingProject or BreweryX (at least one is required)
• PlaceholderAPI 2.11+ (optional — required only for placeholders)

Commands

Command	Alias	Permission	Description
/thebrewingmarket	/tbm	thebrewingmarket.use	Opens the sell GUI
/thebrewingmarket reload	/tbm reload	thebrewingmarket.admin	Reloads the config
/thebrewingmarket history	/tbm history	thebrewingmarket.history	View sell history

How Pricing Works

Each brew recipe has a base price in config.yml. The final sell price is:

final_price = base_price × brew_quality

Brew quality ranges from 0.01 (worst) to 1.0 (perfect). Prices can be set per-recipe or for a whole group of recipes at once. If a recipe has no configured price, the default price is used. Set any price to 0 to make that brew unsellable.

Configuration

All configuration is done through two files:

• config.yml — Prices, GUI layout, icons, sounds, daily limit, and language selection
• database.yml — Storage backend and schema management