🖌️ Edit Shop

#Identifier

The unique id of the shop, used in commands such as /pshop open and as the name of its file and category folder. Spaces are not allowed, and two shops cannot share one. Renaming moves the file and the folder, and the /sell shop list follows the new id.

#Display Name

The name players see at the top of the shop. Color codes are supported. It cannot be empty.

#Open Command

A command of its own that opens this shop, without the slash, such as shop or blocks. Leave it empty for no command. A command another plugin already owns is not taken over. A new or changed command works straight away, after the edit or a /pshop reload, with no restart and no rejoin.

#Conditions

Who can open this shop. With no conditions, everyone can.

On Premium this opens a list of checks built the same way as item requirements, with eight types: permission, compare for a PlaceholderAPI value, world, gamemode, platform (Java or Bedrock), region for a WorldGuard region the player stands in, world-time for the time of day in the player's world and playtime. Region only shows when WorldGuard is installed, and a region check without it refuses everyone. Minimum sets how many checks have to pass, each check can be negated, and its deny actions run when a player is turned away. On Lite this is a single permission field.

The conditions decide who can open the shop, and also which shops /sell, sell wands, AutoSell, NPC shops and /pshop search use for that player. A player turned away sees the shop-locked message, unless a failed check has deny actions of its own.

#Currency

What everything in this shop is priced in. A category or an item can override it on Premium, see Edit Category and Edit Item.

Left-click swaps between the currency types, skipping any whose plugin is not installed. Right-click opens the chosen type, where the Currency option opens a searchable list to pick from (ExcellentEconomy), the Placeholder currency is opened to edit, an item is dropped in and its name, lore and Currency Display are set (Item), and the Currency Format is set for every type but Item.

Every type, what it needs and which edition has it is listed on Currencies.

#Currency Format

How prices in this shop are written, such as %amount% PlayerPoints or $%amount%, with %amount% where the number goes, or %amount_short% for a short form such as 1.5k. Leave it empty to use the currency's own format, see Symbols and Formats. It is set from the right-click menu of the Currency option and applies to every price in the shop, including items that use another currency, except in categories that set a format of their own.

#Categories

Opens the categories of this shop. See Categories.

#Enabled

A disabled shop keeps its configuration but cannot be opened by anyone.

#Sale

Premium. Puts every item in the shop on sale, with the same options as a category sale: the discount, a start and end date and time, days of the week, a daily time window and the Start and Stop button. A category whose own sale is running uses that one instead, so a category can run a different deal during a shop-wide sale.

#Edit Menus

Opens the list of every menu this shop uses: the main menu, the buy and sell menus, the bulk buy and bulk sell menus, the sell menu, the confirm menu and one menu per category. The Filter button shows only the shop menus or only the category menus. Left-click one to edit its layout in-game. While you edit, the menu shows its real title and your hotbar holds the editor tools.

#Actions

Lists of actions run at moments in this shop, such as a sound, a message, a title or a command: Buy and Sell when a purchase or sale goes through, Deny when one is refused, Click when a category or item is clicked, Previous Page and Next Page when the pages are turned, Add and Remove when the amount buttons of the buy and sell menu raise or lower the amount, Fill when the fill button sets the most you can buy or sell, and Back when a menu's back button is clicked. Each list starts with a single sound. Empty a list to run nothing.

%player% is filled in everywhere. In Buy, Sell and Deny, %item%, %amount%, %price%, %currency% and %balance% are filled in as well, and in Click on an item, %item%.

Inside a category, its own actions replace Buy, Sell, Deny, Click and the page lists when they are not empty. The shop's main menu always runs the shop's lists.

#Delete

Deletes the shop together with its file, its categories and their items, after a confirmation.