Dereliction.md

Dereliction Profiles allow you to apply block degradation to selected blocks to achieve a 'derelict' appearance on grids. Dereliction profiles are attached to Manipulation profiles.

Here is an example of how a Dereliction Profile is setup:

<?xml version="1.0"?>
<Definitions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <EntityComponents>

    <EntityComponent xsi:type="MyObjectBuilder_InventoryComponentDefinition">
      <Id>
          <TypeId>Inventory</TypeId>
          <SubtypeId>MES-ExampleDereliction</SubtypeId>
      </Id>
      <Description>

      [MES Dereliction]

      [Blocks:MyObjectBuilder_CubeBlock:SomeBlock]
      [Blocks:MyObjectBuilder_Thruster:SomeThruster]
      [MatchOnlyTypeId:true]
      [Chance:50]

      [MinPercentage:5]
      [MaxPercentage:50]

      </Description>

    </EntityComponent>

  </EntityComponents>
</Definitions>

These profiles attach to Manipulation Profiles using the [DerelictionProfiles:YourDerelictionProfileIdHere] tag.

Below you can find all the tags that can be used in your Dereliction Profile:

Tag:	Blocks
Tag Format:	`[Blocks:Value]`
Description:	This tag allows you to specify the `MyDefinitionId` of a block that will be used by the Dereliction process.
Allowed Value(s):	Any String Value
Default Value(s):	N/A
Multiple Tags Allowed:	Yes

Tag:	MatchOnlyTypeId
Tag Format:	`[MatchOnlyTypeId:Value]`
Description:	This tag allows you to specify if only the TypeId from the values provided in the `Blocks` tags should be used (eg `MyObjectBuilder_CubeBlock`).
Allowed Value(s):	`true` `false`
Multiple Tags Allowed:	No

Tag:	Chance
Tag Format:	`[Chance:Value]`
Description:	This tag allows you to specify the chance (per block) that this dereliction profile has for running.
Allowed Value(s):	Any Integer Greater/Equal To `0`
Multiple Tags Allowed:	Yes

Tag:	MinPercentage
Tag Format:	`[MinPercentage:Value]`
Description:	This tag allows you to specify the Minimum Integrity / Build Level Percentage that the affected blocks will be randomly set to.
Allowed Value(s):	Any Integer Greater/Equal To `0` `Value` must be Less Than or Equal to `MaxPercentage` if provided.
Multiple Tags Allowed:	No

Tag:	MaxPercentage
Tag Format:	`[MaxPercentage:Value]`
Description:	This tag allows you to specify the Maximum Integrity / Build Level Percentage that the affected blocks will be randomly set to.
Allowed Value(s):	Any Integer Greater/Equal To `0` `Value` must be Greater Than or Equal to `MinPercentage` if provided.
Multiple Tags Allowed:	No

Tag:	UseSeparatePercentages
Tag Format:	`[UseSeparatePercentages:Value]`
Description:	This tag allows you to specify if different percentages should be applied to Integrity and Build Levels. Use the tags below to specify those ranges
Allowed Value(s):	`true` `false`
Multiple Tags Allowed:	No

Tag:	MinIntegrityPercentage
Tag Format:	`[MinIntegrityPercentage:Value]`
Description:	This tag allows you to specify the Minimum Integrity Percentage that the affected blocks will be randomly set to.
Allowed Value(s):	Any Integer Greater/Equal To `0` `Value` must be Less Than or Equal to `MaxIntegrityPercentage`
Multiple Tags Allowed:	No

Tag:	MaxIntegrityPercentage
Tag Format:	`[MaxIntegrityPercentage:Value]`
Description:	This tag allows you to specify the Maximum Integrity Percentage that the affected blocks will be randomly set to.
Allowed Value(s):	Any Integer Greater/Equal To `0` `Value` must be Greater Than or Equal to `MinIntegrityPercentage`
Multiple Tags Allowed:	No

Tag:	MinBuildPercentage
Tag Format:	`[MinBuildPercentage:Value]`
Description:	This tag allows you to specify the Minimum Build Level Percentage that the affected blocks will be randomly set to.
Allowed Value(s):	Any Integer Greater/Equal To `0` `Value` must be Less Than or Equal to `MaxBuildPercentage`
Multiple Tags Allowed:	No

Tag:	MaxBuildPercentage
Tag Format:	`[MaxBuildPercentage:Value]`
Description:	This tag allows you to specify the Maximum Build Level Percentage that the affected blocks will be randomly set to.
Allowed Value(s):	Any Integer Greater/Equal To `0` `Value` must be Greater Than or Equal to `MinBuildPercentage`
Multiple Tags Allowed:	No