Blockdefinition (moddinghints)

This is a "MyObjectBuilder_CubeBlockDefinition" with hints and explanations. This is a community collection. Please feel free to add/correct things. For better readability copy/paste the text into a XML capable programm like notepad++.

   <Definition xsi:type="MyObjectBuilder_CubeBlockDefinition"> <!-- definition type -->
   <Id Type="CubeBlock" Subtype="StoneCube" /> <!-- definition id  -->
   <DisplayName>DisplayName_Block_StoneBlockCube</DisplayName> <!-- display name used for the block in-game (mods don't support localization) -->
   <BlockPairName>StoneBlockCube</BlockPairName> <!-- block pair name is used together with block position (a separate definition) to position the block within the G-screen grid -->
   <Public>true</Public> <!-- whether or not the definition is accesible to players (Default: true) -->
   <Icon>Textures\GUI\Icons\cubes\StoneCube.dds</Icon> <!-- icon(s) used in the gui -->
   <CubeSize>Large</CubeSize> <!-- what grid size the block is using (large / small) (Default: Large) -->
   <BlockTopology>TriangleMesh</BlockTopology> <!-- this can be Cube or TriangleMesh (but Cube won't work in ME, it is only useful for SE armor blocks) -->
   <Size x="1" y="1" z="1" /> <!-- how many blocks in each direction does the block occupy (Default: 0,0,0) (Default value will make game sad :P) -->
   <ModelOffset x="0" y="0" z="0" /> <!-- offset of the model within the block space (Default: 0,0,0) -->
   <Model>Models\Cubes\Large\StoneCube.mwm</Model> <!-- model for the fully built block -->
   <BuildProgressModels> <!-- building progression models -->
   <Model BuildPercentUpperBound="0.5" File="Models\Cubes\large\StoneCube_Construction_1.mwm"> <!-- What block model to use if build integrity is below specified threshold -->
   <MountPointOverrides> <!-- overrides for mountpoints, if necessary (To prevent players from attaching to the top of an unfinished block for example) -->
   <MountPoint Side="Top" Enabled="false" /> 
   </MountPointOverrides>
   </Model>
   </BuildProgressModels>
   <MountPoints> <!-- mount points for the block, can specify multiple for each side (Default: all sides have some kind of a mount point) -->
     <MountPoint Side="Front" StartX="1.0324" StartY="-0.03239999" EndX="-0.032400012" EndY="1.0324" />
     <MountPoint Side="Back" StartX="-0.03239999" StartY="-0.03239999" EndX="1.0324" EndY="1.0324" />
     <MountPoint Side="Left" StartX="-0.03239999" StartY="-0.03239999" EndX="1.0324" EndY="1.0324" />
     <MountPoint Side="Right" StartX="1.0324" StartY="-0.03239999" EndX="-0.032400012" EndY="1.0324" />
     <MountPoint Side="Top" StartX="-0.03239999" StartY="1.0324" EndX="1.0324" EndY="-0.032400012" />
     <MountPoint Side="Bottom" StartX="-0.03239999" StartY="-0.03239999" EndX="1.0324" EndY="1.0324" />
   </MountPoints>
   <MirroringY>Z</MirroringY> <!-- for mirrored building, I don't think is is useful for ME -->
   <MirroringZ>Y</MirroringZ> <!-- (Default: None) -->
   <BuildTimeSeconds>6</BuildTimeSeconds> <!-- how much time you need to build the block (Default: 10) -->
   <Direction>Horizontal</Direction> <!-- I honestly don't know (Default: Both) -->
   <Rotation>Vertical</Rotation> <!-- which way the block can be rotated (Default: Both) -->
   <BuildType>Cube</BuildType> <!-- used for additional model generators (irrelevant if you don't want to use it as generated block or with generated blocks) -->
   <PhysicalMaterial>Stone</PhysicalMaterial> <!-- physical material of the block (determines the strength of material, contact sounds, particles and maybe something else) -->
   <Components> <!-- components used for building one of these blocks (every block needs at least a component - integrity / total component count is used to calculate how much integrity the block can have with currently built components) -->
     <Component Tag="ScrapWood" Count="10" /> <!-- Tag = any item matching the specified tag can be used here -->
     <Component Type="InventoryItem" Subtype="LargeStone" Count ="12" /> <!-- item with the specified defintion id needs to be used -->
   </Components>
   <CriticalComponent Type="InventoryItem" Subtype="LargeStone" Index="0" /> <!-- used to determined at which point in building the block is 'working' (also supports tags) -->
   <RandomRotation>true</RandomRotation> <!-- can the block be rotated when placed in line or plane? (Default: false) -->
   <CompoundTemplates> <!-- template for compounding (this only works for Large blocks) - (don't use if you don't want to have compound block) -->
   <Template>Cube</Template>
   </CompoundTemplates>
   <GeneratedBlocks> <!-- generated blocks when built (for the stone cube and walls it adds the corner stone pillars) (no need to use for block without additional decoration) (no used for small grids) -->
   <GeneratedBlock><TypeId>CubeBlock</TypeId>
       <SubtypeId>GeneratedStoneSlopeEdgeLeft</SubtypeId>
   </GeneratedBlock></GeneratedBlocks><MaxIntegrity>21000</MaxIntegrity> <!-- maximum integrity for the block (essentially HP) (Default: 1) -->
   <NavigationDefinition>Default</NavigationDefinition> <!-- not used by the game at all (was used in legacy AI pathfinding) -->
   <BuildProgressToPlaceGeneratedBlocks>0.5</BuildProgressToPlaceGeneratedBlocks> <!-- how much of the block needs to be built for the generated blocks to be placed on it -->
 </Definition>
   <UseModelIntersection>true</UseModelIntersection> <!-- (Default: false) -->
   <Mass>20</Mass> <!-- weight of the block (Default: 0) -->
   <AvailableInSurvival>true</AvailableInSurvival> <!-- is it buildable in survival? (Default: true) -->
   <VoxelPlacement> <!-- rules for placing the block into voxels -->
     <StaticMode>           
      <PlacementMode>Both</PlacementMode>
       <!-- None - Cannot be placed at all -->
       <!-- InVoxel - Can only be placed in voxels -->
       <!-- OutsideVoxel - Can only be placed outside voxels -->
       <!-- Both - Can be placed inside or outside voxels -->
       <!-- Volumetric - Has to be in voxel and must be in voxel sfor a certain percentage -->
       <MaxAllowed>1</MaxAllowed> <!-- maximum of block being inside voxel (0 - 1 maps to 0% - 100%) -->
       <MinAllowed>0</MinAllowed> <!-- minimum of block being inside voxel (0 - 1 maps to 0% - 100%) -->
     </StaticMode>
     <DynamicMode>
       <PlacementMode>Both</PlacementMode>
       <MaxAllowed>1</MaxAllowed>
       <MinAllowed>0</MinAllowed>
     </DynamicMode>
   </VoxelPlacement><!--Dynamic mode is dynamic placement mode (in the air I think) and Static is placing in voxel or on a static grid -->