SellBoost

🚀 SellBoost

A 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 — keeping your economy fresh and giving players a reason to stay active.

Discord

Modrinth

GitHub

---

✨ Features

- Automatic boost rotation at a configurable interval (hours, minutes, or seconds) - Server-wide boss bar mode — several items boosted at once, each with its own multiplier - Server-wide boss bar mode — one item boosted at a time - Per-item `min_multiplier_only` flag — forces an item to always use the base minimum, never the rolling range (useful for rare/valuable items like diamonds) - Server-wide boss bar — the multiplier window gradually escalates each cycle up to a configurable ceiling, then wraps back. Epoch and roll time persist across restarts - Server-wide boss bar — boosted sell prices are written directly into the EconomyShopGUI shop files on boost start and restored automatically on boost end; no manual reload needed - Server-wide boss bar — shows boosted items, their multipliers, and a live countdown during a boost; shows time until the next boost while idle - Live actionbar display showing boosted items and multipliers - Chat and title screen announcements — each independently toggleable - `no_repeat_last` — prevents the same items from being picked in back-to-back boosts - Boost state (active items, multipliers, timers, rolling epoch) persists across server restarts via `data.yml` - Manual controls with `/sellboost start | stop | status | reload`

---

🎮 How It Works

When 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:

``` ⚡ SELL BOOST | Wheat (3x) | Coal (2.5x) | String (4x) | 13m 34s ```

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 — everything else sells at normal price.

---

💻 Commands

Permission node: `sellboost.admin` — OP only by default

| Command | Description | |---|---| | `/sellboost start` | Trigger a boost manually | | `/sellboost stop` | Stop the current active boost | | `/sellboost status` | Show boosted items, multiplier range, rolling epoch, and countdown | | `/sellboost reload` | Reload config without restarting |

---

⚙️ Configuration

File: `plugins/SellBoost/config.yml`

```yaml mode: type: MULTIPLE # MULTIPLE | SINGLE multiple: count: 3 no_repeat_last: true

rotation: unit: MINUTES # HOURS | MINUTES | SECONDS value: 60

boost: duration: unit: MINUTES value: 15

multiplier: min: 2.0 max: 4.0 step: 0.5 rolling: enabled: true interval: unit: HOURS value: 2 ceiling: 6.0 # range stops escalating here, then wraps back to base

autosave: enabled: true interval_ticks: 200

notifications: actionbar: true chat: true title: true bossbar: true

display: bossbar: active_format: "&6⚡ SELL BOOST &8| &e{items} &8| &a{remaining}" idle_format: "&7Next boost in &e{next}" show_idle: true

items: - path: "Farming.page1.items.28" display: "Wheat" - path: "Ores.page1.items.9" display: "Diamond" min_multiplier_only: true ```

---

🔍 Finding Item Paths

Open your EconomyShopGUI shop config files in `plugins/EconomyShopGUI/shops/`. The path format is: ``` ShopFileName.page1.items.SLOT ``` Example — shop file `Ores.yml`, Iron Ingot in slot 16: ```yaml - path: "Ores.page1.items.16" display: "Iron Ingot" ``` > If a path is invalid or the item is not sellable, SellBoost logs a warning and skips it on boot.

---

📦 Installation

1. Drop `SellBoost.jar` into your server's `plugins/` folder 2. Ensure EconomyShopGUI (free or premium) is already installed 3. Restart the server 4. Edit `plugins/SellBoost/config.yml` — set your item paths and multiplier settings 5. Run `/sellboost reload`

---

🔧 Requirements

- Paper / Spigot 1.21.x · Java 21+ - EconomyShopGUI (free or premium)

---

💬 Join our Discord for support, downloads, and updates 🔗 More plugins by Treamhiler 🐙 GitHub