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 selling 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 PluginBase, 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 commands 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