PrimeSeller-Fork

PrimeSeller-Fork

Fork maintained by flyawaymaking *Original plugin by %%MD1%%*

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.

Features

* Scheduled Updates: Open a configurable menu (`/seller`) to sell items individually, in stacks, or your entire inventory. * Scheduled Updates: Automatically sells specific items from your inventory on a configurable timer. Manage your auto-sell list via a dedicated GUI (`/autoseller`). * Scheduled Updates: Seamlessly integrates with Scheduled Updates: or Scheduled Updates: for handling transactions. * Scheduled Updates: Items can be categorized as Scheduled Updates: (with per-player daily limits) or Scheduled Updates:. Prices for unlimited items can gradually decrease based on server sales to simulate market saturation. * Scheduled Updates: Automatically fetches and uses correct item names in the player's configured language. * Scheduled Updates: Provides placeholders for auto-sell status, update timers, and sold item counts. * Scheduled Updates: 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 generate a random price between min and max for the item each time the stock refreshes.

Auto-Seller Guide

1. A player with the `primeseller.autoseller` permission uses `/autoseller`. 2. In the opened GUI, they can click items from their Off to add them to the auto-sell list. 3. They can click items in the Off to remove them from the list. 4. Use the toggle button to turn auto-selling Off or Off. 5. The plugin will automatically sell items from the player's inventory that are on their list, at the interval set in `config.yml`.

Slot Limits: Players start with 0 auto-sell slots. Grant slots using permissions: `primeseller.autoseller.5`, `primeseller.autoseller.20`, etc. The highest value permission applies.

Installation

1. Install the required dependencies: * Vault (or ensure CoinsEngine is installed if using that economy). * (Optional) PlaceholderAPI for placeholder support. 2. Download the latest `PrimeSeller-Fork.jar`. 3. Place the JAR file into your server's `plugins` folder. 4. Restart your server. 5. Configure the `plugins/PrimeSeller-Fork/config.yml` and other files to your liking. 6. Use `/psell reload` to apply changes.

Configuration

After the first run, the plugin will generate several configuration files in `plugins/PrimeSeller-Fork/`:

* `config.yml` - Main settings: language, economy, auto-sell interval, price reduction mechanics. * `messages.yml` - All plugin messages, customizable with MiniMessage format. * `menu.yml` - Contains `seller-menu` and `autoseller-menu` for fully customizing the look, layout, and items in both GUIs. * `items.yml` - Define which items are in the Limited/Unlimited pools, their min/max prices, and global limits. * `translations/` - Automatically generated files with localized material names.

Economy Setup

By default, the plugin uses Vault. Ensure you have a Vault-compatible economy plugin (like EssentialsX) installed.

To use CoinsEngine, set the following in `config.yml`:

```yml economy: coins-engine: enable: true currency: "money" # Your CoinsEngine currency name ```