Arkerion Studios

Troubleshooting & FAQ

Common problems, their fixes and the limits of this version.

v1.0.0Last updated 29 Oct 2026

Troubleshooting

Nothing happens when I click in the Scene view

  • The cave must be selected (the overlay toolbar is visible).
  • With Draw on Surface, there must be a collider under the mouse. Add a ground plane or terrain, or switch to Draw on Plane. The message next to the cursor says what is missing.
  • Alt is held – Alt is reserved for orbiting the camera.

Points land too high or too low

  • Check Floor Offset (surface) or Plane Elevation (plane).
  • Use the Selected tab to type the exact Floor Elevation.

The cave does not update

  • Look at the status bar: if generation failed, the last valid preview stays visible and the message says why.
  • Click Rebuild All on the Finish tab.
  • Check the Validation list – an invalid passage keeps an empty preview until it is fixed.

The walls fold, pinch or look twisted

  • The bend is too tight for the passage size. Use Fix Path, move points apart or make the passage smaller there.
  • For shafts, give the bend room – about the passage height.

There is a hole in the cave

  • Free connections are always plugged and openings are always sealed, so a hole usually means a passage has an Open end. Select it and click Close.
  • Two passages that cross without a crossroad overlap. Click Make Crossroad where they cross.

The player falls through the floor

  • In the editor: turn on Preview Colliders.
  • In a baked prefab: bake with Colliders on.
  • Your character controller must collide with the default layer the cave uses, and its step offset and slope limit must fit the cave (see Walkable Slope).

The player cannot walk up a slope

  • The slope is steeper than your controller allows. Lower the climb, set Walkable Slope to your controller’s limit and fix the warnings, or lower Distortion Vertical.

The cave is black

  • No theme or material: pick a theme on the Appearance tab.
  • No light inside: turn on Place Lights, or add lights. Light from the sky does not reach inside – that is intended.
  • Light leaks through the walls from outside: caves are single-sided. Avoid strong directional light on underground caves, or cover the outside with terrain or rock.

The entrance is buried in the terrain

  • Click Cut Terrain Opening on the Finish tab or the entrance’s Selected tab.

Textures look stretched or blurry

  • Adjust Texture Scale. Strong Distortion stretches textures slightly with the rock – that is intended and helps the look.

Decorations float or sit in the way

  • Click Rebuild All. Decorations are placed on the generated floor and never in the walking strip; if you moved objects under Generated by hand, they are replaced.

“Preview out of date” in the overlay

  • Generation of a part failed. The status bar shows the reason. Fix the reported problem or click Rebuild All.

Baking is blocked

  • Errors in the Validation list block baking. Use Show and the fix buttons.
  • The prefab name exists and belongs to another cave: change the name or use Create Copy.

I duplicated a cave and both changed

  • They do not: a duplicated cave gets its own identity automatically. Bake the copy under a new name.

The cave is part of a prefab and behaves strangely

  • Editable caves keep their geometry in the scene. To reuse a cave, bake it and use the baked prefab.

Play Test does not start

  • Draw a passage or place an entrance first.
  • Leave Play mode first if it is already running.

Limits of This Version

  • Rooms come in fixed size presets; there is no free room resizing.
  • Every room has one level floor.
  • Crossroads are level and passage-sized (4 x 4 m openings); passages crossing more than 2 m apart in height or below 25° are not joined. Crossing angles come in 5° steps.
  • No holes in arbitrary places of a wall; use rooms and entrances for openings.
  • Caves are built in the editor and baked; there is no generation at runtime.
  • Crossing and clearance checks are approximate warnings, not guarantees.
  • Editing handles stay on the undistorted design line; the distorted walls can be up to the distortion amount away.

Support

For questions, feedback, or support, please contact us here:

Email: arkerionstudios@gmail.com

Discord: https://discord.com/invite/gTHbWn94v2

Instagram: https://www.instagram.com/arkerion.studios/