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

Element	Description	Value/Children
<enderchest> </enderchest>	Node containing this map's Ender chest properties.
Sub-elements
<dropoff>	An individual Ender chest drop-off rule.	Enderchest Sub-elements

Dropoff Attributes

Attribute	Description	Value	Default
region	PropertyRequiredRegion in which a player's Ender chest content will be dropped off.	Region
filter	PropertyRequiredFilter which determine when the content should be dropped.	Filter
fallback	Specify a fallback location option for when no drop-off locations are defined. Cannot be combined with region.	AUTO, KEEP, DELETE	AUTO

Dropoff Sub-elements

Element	Description	Value/Children
<region>	PropertyThe region the drop-off applies to.	Bounded Regions
<filter>	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"/>