# \ud83d\ude80 SellBoost
\nA Paper plugin that integrates with **EconomyShopGUI** to run automatic randomized sell price boost events. At a configurable interval, the plugin picks random items from your shop and applies individual multipliers to their sell price \u2014 keeping your economy fresh and giving players a reason to stay active.<\/p>\n
\n
\n<\/p>\n
—<\/p>\n
## \u2728 Features
\n– Automatic boost rotation at a configurable interval (hours, minutes, or seconds)
\n– **MULTIPLE** mode \u2014 several items boosted at once, each with its own multiplier
\n– **SINGLE** mode \u2014 one item boosted at a time
\n– Per-item `min_multiplier_only` flag \u2014 forces an item to always use the base minimum, never the rolling range (useful for rare\/valuable items like diamonds)
\n– **Rolling multiplier** \u2014 the multiplier window gradually escalates each cycle up to a configurable ceiling, then wraps back. Epoch and roll time persist across restarts
\n– **Live shop tooltip updates** \u2014 boosted sell prices are written directly into the EconomyShopGUI shop files on boost start and restored automatically on boost end; no manual reload needed
\n– **Server-wide boss bar** \u2014 shows boosted items, their multipliers, and a live countdown during a boost; shows time until the next boost while idle
\n– Live actionbar display showing boosted items and multipliers
\n– Chat and title screen announcements \u2014 each independently toggleable
\n– `no_repeat_last` \u2014 prevents the same items from being picked in back-to-back boosts
\n– Boost state (active items, multipliers, timers, rolling epoch) persists across server restarts via `data.yml`
\n– Manual controls with `\/sellboost start | stop | status | reload`<\/p>\n
—<\/p>\n
## \ud83c\udfae How It Works
\nWhen a boost fires, SellBoost picks random items from your configured list and assigns each a random multiplier. Players see it live on the boss bar and actionbar:<\/p>\n
“`
\n\u26a1 SELL BOOST | Wheat (3x) | Coal (2.5x) | String (4x) | 13m 34s
\n“`<\/p>\n
The sell price shown in `\/shop` updates instantly to reflect the boost. When the boost ends, all prices are restored automatically. Only boosted items get the multiplier \u2014 everything else sells at normal price.<\/p>\n
—<\/p>\n
## \ud83d\udcbb Commands
\nPermission node: `sellboost.admin` \u2014 OP only by default<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/sellboost start` | Trigger a boost manually |
\n| `\/sellboost stop` | Stop the current active boost |
\n| `\/sellboost status` | Show boosted items, multiplier range, rolling epoch, and countdown |
\n| `\/sellboost reload` | Reload config without restarting |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration
\nFile: `plugins\/SellBoost\/config.yml`<\/p>\n
“`yaml
\nmode:
\n type: MULTIPLE # MULTIPLE | SINGLE
\n multiple:
\n count: 3
\n no_repeat_last: true<\/p>\n
rotation:
\n unit: MINUTES # HOURS | MINUTES | SECONDS
\n value: 60<\/p>\n
boost:
\n duration:
\n unit: MINUTES
\n value: 15<\/p>\n
multiplier:
\n min: 2.0
\n max: 4.0
\n step: 0.5
\n rolling:
\n enabled: true
\n interval:
\n unit: HOURS
\n value: 2
\n ceiling: 6.0 # range stops escalating here, then wraps back to base<\/p>\n
autosave:
\n enabled: true
\n interval_ticks: 200<\/p>\n
notifications:
\n actionbar: true
\n chat: true
\n title: true
\n bossbar: true<\/p>\n
display:
\n bossbar:
\n active_format: “&6\u26a1 SELL BOOST &8| &e{items} &8| &a{remaining}”
\n idle_format: “&7Next boost in &e{next}”
\n show_idle: true<\/p>\n
items:
\n – path: “Farming.page1.items.28”
\n display: “Wheat”
\n – path: “Ores.page1.items.9”
\n display: “Diamond”
\n min_multiplier_only: true
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd0d Finding Item Paths
\nOpen your EconomyShopGUI shop config files in `plugins\/EconomyShopGUI\/shops\/`. The path format is:
\n“`
\nShopFileName.page1.items.SLOT
\n“`
\nExample \u2014 shop file `Ores.yml`, Iron Ingot in slot 16:
\n“`yaml
\n– path: “Ores.page1.items.16”
\n display: “Iron Ingot”
\n“`
\n> If a path is invalid or the item is not sellable, SellBoost logs a warning and skips it on boot.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation
\n1. Drop `SellBoost.jar` into your server’s `plugins\/` folder
\n2. Ensure **EconomyShopGUI** (free or premium) is already installed
\n3. Restart the server
\n4. Edit `plugins\/SellBoost\/config.yml` \u2014 set your item paths and multiplier settings
\n5. Run `\/sellboost reload`<\/p>\n
—<\/p>\n
## \ud83d\udd27 Requirements
\n– Paper \/ Spigot 1.21.x \u00b7 Java 21+
\n– EconomyShopGUI (free or premium)<\/p>\n
—<\/p>\n
\ud83d\udcac **Join our Discord** for support, downloads, and updates
\n\ud83d\udd17 **More plugins by Treamhiler**
\n\ud83d\udc19 **GitHub**<\/p>\n","protected":false},"excerpt":{"rendered":"
Randomized sell price boost events for EconomyShopGUI. Automatically triggers timed boosts on configurable items with custom multipliers, actionbar display, and restart persistence.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"sellboost","_minecraft_project_id":"iMZeHt6P","_minecraft_author":"Treamhiler","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":143,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sellboost.zip","_minecraft_size_bytes":33863,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T18:43:03.031023Z","_minecraft_date_created":"2026-03-09T23:45:59.802004Z","_minecraft_date_modified":"2026-03-10T06:05:55.112655Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sellboost","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T02:21:10+00:00","_minecraft_import_hash":"949ee820a779038a0422455a25f635b0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137034","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n