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.
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 |
---|---|---|
Node containing this map's Ender chest properties. | ||
Sub-elements | ||
An individual Ender chest drop-off rule. | Enderchest Sub-elements |
Dropoff Attributes
Attribute | Description | Value | Default |
---|---|---|---|
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
Element | Description | Value/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"/>