Renewables

This module can create regions in which destroyed or altered blocks will gradually be restored to their original state.

The <renewables> tag can contain any number of <renewable> tags. Each <renewable> can use a region and a filter to specify blocks to renew. If neither are specified, the renewable affects all blocks in the world.

ElementDescriptionValue/Children
Node containing this map's renewable block rules.
Sub-elements
An individual renewable block rule.Renewable Sub-elements
Renewable Attributes
AttributeDescriptionValueDefault
PropertyRegion in which blocks will be renewed.RegionEverywhere
PropertyFilter which blocks are renewed.FilterEverything
PropertyFilter which blocks can be replaced by renewing blocks.FilterEverything
PropertyFilter which renewable blocks are shuffled.FilterNothing
Approximate number of blocks that will be restored per second. This rate applies to the renewable as a whole, which means the time required for any single block to renew will depend on how many other blocks are waiting to be renewed by the same renewable.
This parameter cannot be combined with
Blocks/second1
Average time required for a block to renew. Unlike `rate`, this applies to each block individually, and blocks do not affect each other's renewal time. A renewable with an `interval` can behave very differently from a renewable with a `rate`, particularly if it is large.
This parameter cannot be combined with
Time Period
Only allow blocks to be restored adjacent to other blocks that are already renewed, or not renewable. If set to false, blocks will be restored at completely random locations, even in mid-air.true/falsetrue
Show block restore particle effects.true/falsetrue
Play block restore sound effects.true/falsetrue
Prevent blocks from being restored within this distance of any player.meters2
Renewable Sub-elements
ElementDescriptionValue/Children
PropertyThe region the renewable applies to.Bounded Regions
PropertyFilter which blocks are renewed.Filters
PropertyFilter which blocks are replaced.Filters
PropertyFilter which blocks are shuffled.Filters

By default, all blocks in the region are renewable. The <renew-filter> sub-element can be used inside the <renewable> to specify only particular blocks to renew.

The <replace-filter> element specifies which block types are allowed to be replaced by renewing blocks. Any other type of block in the renewable region will obstruct the renewal process. By default, any block can be replaced.

Normally, blocks will be restored to their exact state when the map was loaded. If some block types are specified in <shuffle-filter> element, blocks of those types in the original region will be restored to a block type chosen at random from the shuffleable types. The approximate proportions of block types from the original region will be preserved.

<renewables>
<renewable rate="2.5" grow="true" particles="true" sound="true" avoid-players="4">
<region>
<cylinder base="0,117,0" radius="6" height="13"/>
</region>
<!-- These are the blocks that will renew -->
<renew-filter>
<any>
<material>iron ore</material>
<material>glowstone</material>
<material>stone</material>
</any>
</renew-filter>
<!-- These blocks can be replaced by renewing blocks -->
<replace-filter>
<any>
<material>air</material>
<material>lava</material>
<material>stationary lava</material>
</any>
</replace-filter>
<!-- These blocks will switch with each other when they renew -->
<shuffle-filter>
<any>
<material>stone</material>
<material>iron ore</material>
</any>
</shuffle-filter>
</renewable>
</renewables>