Skip to main content

Ender Chests

This module allow mapmakers to have better control over vanilla Ender chest behaviors in a map.

The <enderchest> tag can contain any number of <dropoff> tags. Each <dropoff> can use a region and a filter to determine where and when items should be dropped from the Ender chest.

Dropoffs handle taking a player's Ender chest inventory and dropping it on the ground at a defined region or it can completely erase it. This can be triggered with a filter or once the player switches team or leaves the server.

caution

Ensure that any maps with Ender chests are loaded on a server using the latest version of PGM available. Pre-existing Ender chests in previous versions of PGM are not supported and will allow players to transfer items across matches. Additionally, players cannot place Ender chests under any circumstances.

Enderchest Element

ElementDescriptionValue/Children
Node containing this map's Ender chest properties.
Sub-elements
An individual Ender chest drop-off rule.Enderchest Sub-elements

Dropoff Attributes

AttributeDescriptionValueDefault
PropertyRequiredRegion in which a player's Ender chest content will be dropped off.Region
PropertyRequiredFilter which determine when the content should be dropped.Filter
Specify a fallback location option for when no drop-off locations are defined.
Cannot be combined with .
, ,

Dropoff Sub-elements

ElementDescriptionValue/Children
PropertyThe region the drop-off applies to.Bounded Regions
PropertyFilter which blocks are renewed.Filters

Examples

Drop-off Locations

<!-- Add drop-off locations for when player switches teams or leave the match -->
<enderchest>
<dropoff region="red-spawn" filter="red-only"/>
<dropoff region="blue-spawn" filter="blue-only"/>
</enderchest>

Fallback

If you want Ender chest contents to not drop upon a certain event, you can specify what PGM will do with the inventory. This will also be used when a drop-off is not possible. By default, PGM will use AUTO if neither regions nor a fallback preference are specified.

<!-- Specify a fallback option for when no drop-off locations are defined -->
<enderchest fallback="KEEP"/>