PrimeSeller-Fork

# PrimeSeller-Fork **Fork maintained by (https://github.com/flyawaymaking)** *Original plugin by (https://github.com/destroydevs/primeseller)* A powerful and customizable plugin that allows players to sell items to a buyer for in-game currency. Features both a manual seller interface and a fully automated auto-sell system. ## 🧩 Version Compatibility | **Plugin version** | **Supported Paper** | **Java** | **Required dependency** | |--------------------|---------------------|----------|---------------------------| | `2.1.0+` | `1.21` – `26.2` | 25 | Vault or ExcellentEconomy | | `2.0.6` | `1.21` – `1.21.11` | 21 | Vault or CoinsEngine | ## Features * **Interactive Seller GUI:** Open a configurable menu (`/seller`) to sell items individually, in stacks, or your entire inventory. * **Smart Auto-Seller:** Automatically sells specific items from your inventory on a configurable timer. Manage your auto-sell list via a dedicated GUI (`/autoseller`). * **Dual Economy Support:** Seamlessly integrates with **Vault** or **ExcellentEconomy** for handling transactions. * **Dynamic Pricing:** Items can be categorized as **Limited** (with per-player daily limits) or **Unlimited**. Prices for unlimited items can gradually decrease based on server sales to simulate market saturation. * **Multi-language Material Names:** Automatically fetches and uses correct item names in the player's configured language. * **PlaceholderAPI Support:** Provides placeholders for auto-sell status, update timers, and sold item counts. * **Fully Configurable:** Extensive configuration files for messages, menus, items, prices, permissions, and economy settings. * **Scheduled Updates:** Limited and Unlimited item stocks and prices refresh on customizable timers. ## Commands | Command | Description | Permission | Default | |:----------------------------------------|:------------------------------------------------------------------|:-------------------------|:--------| | `/seller` | Opens the main selling interface. | `primeseller.seller` | true | | `/autoseller` | Opens the auto-seller management GUI. | `primeseller.autoseller` | true | | `/autoseller on/off/toggle` | Toggles the auto-sell function on or off. | `primeseller.autoseller` | true | | `/primeseller reload` | Reloads all plugin configuration files. | `primeseller.admin` | OP | | `/primeseller update` | Manually triggers an update for both Limited and Unlimited items. | `primeseller.admin` | OP | | `/primeseller update limited` | Manually updates only Limited items. | `primeseller.admin` | OP | | `/primeseller update unlimited` | Manually updates only Unlimited items. | `primeseller.admin` | OP | | `/primeseller addlimited <min> <max>` | Adds the held item to the Limited item pool. | `primeseller.admin` | OP | | `/primeseller addunlimited <min> <max>` | Adds the held item to the Unlimited item pool. | `primeseller.admin` | OP | ## Permissions * `primeseller.seller` - Allows use of `/seller`. * `primeseller.autoseller` - Allows use of `/autoseller` and basic auto-sell functionality. * `primeseller.user` - Gives permissions `primeseller.seller` and `primeseller.autoseller` * `primeseller.autoseller.<number>` - Grants a specific number of slots in the auto-seller (e.g., `primeseller.autoseller.10`). * `primeseller.autoseller.bypass` - Bypasses the auto-seller slot limit. * `primeseller.admin` - Grants access to all admin commands (`/primeseller ...`). ## Placeholders (PlaceholderAPI) If PlaceholderAPI is installed, the following placeholders are available: * `%primeseller_autoseller_status%` - Returns the player's auto-sell status (e.g., "enabled" / "disabled"). * `%primeseller_sold_items_number%` - Returns how many limited items the player has sold in the current period. * `%primeseller_limited_time%` - Time until the next Limited item update (raw format). * `%primeseller_limited_time_formatted%` - Formatted time until the next Limited item update. * `%primeseller_unlimited_time%` - Time until the next Unlimited item update (raw format). * `%primeseller_unlimited_time_formatted%` - Formatted time until the next Unlimited item update. ## Adding Sellable Items Admins can add items directly in-game: 1. Hold the item you want to add. 2. Run `/primeseller addlimited <minPrice> <maxPrice>` for Limited items. 3. Run `/primeseller addunlimited <minPrice> <maxPrice>` for Unlimited items. The plugin will