SweetPlayerMarket

SweetPlayerMarket

A global player market plugin for Minecraft.

> Default configurations are in Chinese. Check localization repository for English or other language. > And I am sorry about that the wiki is only Chinese available right now. In the future, we may translate it to English.

Introduction

SweetPlayerMarket is a cross-server and database-supported global player market plugin.

Players can list their items on the global market by buying or buying, allowing other players to purchase or sell their items freely.

Additionally, you can restrict players' listing behavior, such as banning certain items from being listed, allowing only specific currencies for listing, or charging listing fees.

Leveraging the rich query parameters of the database, this plugin allows you to sort the item list with various conditions. For example, you can sort by `creation time`, `expiration time`, `price`, or `quantity` in either `ascending (smallest to largest)` or `descending (largest to smallest)` order.

This plugin continues to use the highly customizable GUI engine from my any custom layout, allowing you to display the item list in any custom layout within the maximum `6*9` slot chest menu!

For more information, please refer to the plugin documentation at MCIO Plugins.

Features

+ MySQL database support and cross-server compatibility + Uses relational database features to filter and sort global market items by conditions + Highly flexible GUI configuration - all interfaces support custom layouts, text, click actions, etc. + Allows players to view and manage their own listed items + Players can list items via GUI or GUI + Smooth and user-friendly item listing interface + Extensive listing restrictions to prevent players from listing unwanted items + Full localization support - almost all plugin text can be customized + Supports automatic, conditional, and probabilistic item listing by the system to provide rewards or rare items for players + Supports categorizing player-listed items

Commands

Root command: `/sweetplayermarket` Aliases: `/playermarket`, `/spm`, `/pm` Parameters wrapped in `<>` are required; parameters wrapped in `[]` are optional.

Player Commands | Command | Description | Permission | | --- | --- | --- | | `/pm open` | Open the global market main GUI | `sweet.playermarket.open` | | `/pm me` | View your own listed items | `sweet.playermarket.me` | | `/pm tags` | Open the category selection menu | `sweet.playermarket.tags` | | `/pm create <shop-type> <price> <currency> [amount-per-item] [total-stock]` | List an item on the global market | `sweet.playermarket.create` | | `/pm create <shop-type> --menu` | Open the item listing menu | `sweet.playermarket.create` |

Admin Commands | Command | Description | Permission | | --- | --- | --- | | `/pm open [player]` | Open the global market main GUI for yourself or another player | `sweet.playermarket.open.other` | | `/pm me [player]` | View listed items for yourself or another player | `sweet.playermarket.open.other` | | `/pm tags [player]` | Open the category menu for yourself or another player | `sweet.playermarket.tags.other` | | `/pm recalc tags` | Recalculate tags for all items | `sweet.playermarket.recalc` | | `/pm recalc index` | Rebuild search index for all items | `sweet.playermarket.recalc` | | `/pm server [player]` | View items listed by the special "Server" account (usually auto-listed) | `sweet.playermarket.server` | | `/pm auto-deploy <config-name> <action>` | Test command for auto-listing functionality | `sweet.playermarket.auto-deploy` | | `/pm reload assets` | Reload language files; auto-download if missing | OP/Console | | `/pm reload database` | Reconnect to the database | OP/Console | | `/pm reload` | Reload plugin configuration | OP/Console |

The `open` command supports these flags: + `--type=type` Filter items by type + `--currency=type` Filter items by currency + `--tag=tag-name` Filter items by tag

The `me` command supports these flags: + `--notice` Only show items with `notice_flag` + `--only-out-of-stock` Only show expired/sold-out items

The `create` command (both manual and GUI) supports this flag: + `--system=custom-name` List items as a system shop (requires `sweet.playermarket.create.system`)

Permissions

Other available permissions for this plugin: + `sweet.playermarket.create.currency.vault` Allow listing items using Vault money + `sweet.playermarket.create.currency.playerpoints` Allow listing items using PlayerPoints points + `sweet.playermarket.create.currency.mpoints.<amount>` Allow listing items using MPoints currency + `sweet.playermarket.create.bypass.cost` Bypass listing fees + `sweet.playermarket.create.bypass.currency` Bypass currency restrictions + `sweet.playermarket.create.bypass.type` Bypass shop type restrictions (sell/buy) + `sweet.playermarket.admin` Global market admin permission, currently used to remove other players' items