Skip to main content

Troubleshooting

Common issues and how to resolve them when using the D3kryptions Building Generator.

Building is only spawning the foundation​

  • Check Socket Names: Ensure the Socket Name in your Socket Rules exactly matches the name of the socket on the Static Mesh (case-sensitive).
  • Check Floor Limits: If you have Min/Max Floor set, ensure the foundation piece is correctly incrementing the floor height.
  • Piece Options: Verify that the Options list in your Socket Rule contains valid Building Piece Definition assets.

Pieces are overlapping or rotated incorrectly​

  • Socket Rotation: The generator uses the socket's rotation to determine the orientation of the child piece. Check the socket in the Static Mesh Editor.
  • Mesh Pivot: If the piece is offset, ensure the pivot point of the static mesh is at the intended connection point (usually the bottom-center or edge).
  • Socket Rules Rotation: If you are using Random Rotation in your Piece Options, verify the rotation values in the array.

Generator says "System limit of 100 recursive loops reached"​

  • Infinite Loops: This usually happens if you have a socket rule that spawns a piece which then spawns the same piece back onto the original socket's location (e.g., Piece A -> Socket -> Piece A).
  • Complexity: If your building genuinely needs more than 100 levels of recursion, this limit can be overridden in the C++ settings (though 100 is usually enough for most structures).

Materials are not changing​

  • Material Modes: Check the Slot Rules in your Building Piece Definition.
  • Palette ID: If using Building Palette mode, ensure the Palette ID in the slot rule matches the Palette ID defined in the Material Palette asset.
  • Assignment: Ensure the Material Palette is added to the Material Palettes list in your Building Definition.

Baked building is missing actors or components​

  • Editor Only: Check if the components or actors you added to the Piece Definition are marked as "Editor Only".
  • Bake Settings: Ensure the "Bake Actors" option is enabled in the Generator Actor's details panel (if applicable).

Performance issues in the editor​

  • Debug Text: Turn off Show Debug Text in the Generator Actor if you have a very large building.
  • Complexity: Large buildings with thousands of pieces can be slow to generate. Try generating smaller sections or use the Bake feature to convert the building into a single optimized actor.