📦 Sell Chests

#Sell Chests

A sell chest is a container a player places that sells whatever is put inside it. It is handed out as an item with /pshop sellchest give or with shift + right-click on a type in the editor, and each type sells for its own duration.

A sell chest does not need autosell time or the autosell permission. It has its own time, which starts from the type's duration when first placed.

#When it sells

Every sell interval, the chest's contents are sold into the same shops as autosell, checked against the owner's shop permissions. The earnings go to the owner.

The chest only sells, and its time only counts down, while the owner is online and the chest's chunk is loaded. When the time runs out, the owner is told and it turns into a normal chest: it stops selling, its hologram goes and its contents stay inside.

#Protection

Action	Result
Opening	Only the owner and players with phoenixshop.admin can open it.
Breaking	Only the owner and admins can break it. With time left, it drops as a sell chest item that keeps the remaining time and its name. Without time left, it breaks like a normal chest. Either way its contents drop like a normal chest's, except in a shulker box sell chest, whose item keeps them inside.
Explosions and fire	The chest is never destroyed.
Pistons	Pistons cannot push or pull it.
Hoppers	Hoppers cannot pull items out of it, but can still fill it.
Claims	With Require Claim on, a sell chest can only be placed inside a WorldGuard, GriefPrevention, Lands or Towny claim the player can build in. Admins are not limited.
Placing a chest next to it	The two never join into a double chest.

#Chest Menu

The owner opens the chest's menu by shift + right-clicking it. A normal right-click opens the chest as usual. Admins can open the menu of any chest, the same way or from Placed Chests.

#Hologram

Shows the chest's name, time left and total earnings above it. On for a new chest. The lines come from the translations file.

#Information

Shows the chest's owner, time left and total earnings. Time left and earnings update every second while the menu is open.

#Filter Mode

Decides what the Items list means. Blacklist, the default, never sells the listed items. Whitelist sells only the listed items. Clicking it swaps between the two.

#Items

The items the filter mode applies to. Left-click adds the item in your hand, right-click removes the last one and shift + right-click clears the list. A custom item from a supported item plugin is told apart from its base material, so filtering a custom fish leaves plain cod alone.

#Enabled

Turns sell chests on or off for the whole server. While off, a sell chest cannot be placed and the ones already placed stop selling and keep their time. On by default.

#Chests per Player

How many sell chests one player can have placed at the same time. The default is 3, and the value goes from 0 to 1000. Players with phoenixshop.sellchest.unlimited or phoenixshop.admin are not limited, and phoenixshop.sellchest.limit.<n> gives a player their own limit instead.

#Require Claim

Only lets a sell chest be placed inside a claim the player can build in, checked with WorldGuard, GriefPrevention, Lands or Towny, whichever are installed. Off by default. With none of them installed, it has no effect. Players with phoenixshop.admin are not limited.

#Types

Lists every sell chest type by name and id, with its duration and whether it is enabled. Left-click edits a type, right-click deletes it after a confirmation and shift + left-click gives you one. A type with a duration that cannot be read is marked with an error and cannot be handed out.

New Type creates a chest that sells for one hour with the next free id, such as sell_chest_1, which is what /pshop sellchest give takes, and opens its editor straight away.

Option	What it does
Identifier	The id /pshop sellchest give takes. Placed chests follow a new id; chests already handed out keep the old one and can no longer be placed.
Display Name	The name of the chest item, and the name a placed chest uses in its hologram and messages. A placed chest keeps the name it was placed with.
Material	The block that is placed: a chest, a trapped chest or a barrel. Chests already handed out keep their block.
Duration	How long a chest sells for, written like 30m, 6h, 1d or 1h30m. A chest takes it when first placed, so placed and picked-up chests keep their time.
Lore	The item lore. %time% shows the time left. Chests already handed out keep their lore.
Enabled	Turns the type on or off. While off, it cannot be given or placed, and placed chests of it stop selling and keep their time.
Delete	Deletes the type. Chests of it already handed out can no longer be placed, and placed ones keep selling but break like a normal chest.

#Placed Chests

Lists every sell chest placed on the server with its owner, type, time left, earnings and location. Left-click opens the chest's menu, shift + left-click teleports you in front of it and right-click removes it after a confirmation. Removing only stops it being a sell chest: the block and its items stay as a normal container.

The search keeps the chests whose owner or type contains the text, and - clears it. The sort shows the newest or the oldest first, or orders them by owner. A chest that is out of time, or whose type was deleted, is marked.