🚀 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.

---

✨ Features

• Automatic boost rotation at a configurable interval (hours, minutes, or seconds)
• MULTIPLE mode — several items boosted at once, each with its own multiplier
• SINGLE 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)
• Rolling multiplier — the multiplier window gradually escalates each cycle up to a configurable ceiling, then wraps back. Epoch and roll time persist across restarts
• Live shop tooltip updates — 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

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:

- 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