MODFORGEWORLD
← Knowledge base

Rotation Types

rotation-typesv1updated 5h ago

Rotation Types

Per-block constraints on which of the 24 rotations are allowed.

Source: index.html lines ~1065–1074

ROTATION_SETS

TypeIndicesCountDescription
Basic90[0, 1, 2, 3]4Y-axis only (horizontal spin)
Basic45[0, 1, 2, 3]4Same as Basic90 (45° not supported in 3D)
Basic90And45[0, 1, 2, 3]4Same as Basic90 (45° not supported in 3D)
Headfirst[0–7]8Y-axis + upside-down
Sideways[0–15]16Y-axis + upside-down + north/south
No45[0–23]24All 24 orientations
Advanced[0–23]24All 24 orientations
All[0–23]24All 24 orientations

Defaults

  • Shape blocks (blocks with OBJ models): default to all 24 rotations
  • Regular blocks: default to 4 Y-axis rotations (Basic90)

Inheritance

Shape variant blocks can inherit rotation type from:

  1. Block-level rotationType property (highest priority)
  2. Parent shape's rotationType
  3. Default for shape vs. regular block

Impact

The rotation type determines which indices are available in:

  • [[Rotation System#Cycling Rotation (User Interaction)|Rotation cycling]] via Ctrl+scroll
  • Validation when placing blocks
  • Available options in the rotation UI

7DTD XML Placement Radial

For model blocks that need the held-R placement radial to expose advanced rotations, use block XML properties rather than a rotationType property:

<property name="OnlySimpleRotations" value="false"/>
<property name="AllowedRotations" value="No45"/>

Observed vanilla example: trackLight uses OnlySimpleRotations=false and AllowedRotations=No45 to allow all 24 non-45-degree orientations. This enables the Advanced placement radial mode, including upside-down/ceiling-capable rotations when the block's placement class allows them.

The held-R Copy Rotation option is part of the same block placement radial system. If a custom placeable block is locked to simple rotations (OnlySimpleRotations=true), copied rotations and advanced placement choices may collapse back to the simple upright set.