CameraBookmark

CameraBookmark stores editor/camera bookmark positions in a level.

These objects are commonly found in shipped levels under camera bookmark groups. They are mainly useful for editors, tools, screenshots, cinematics, and repeatable inspection viewpoints.

Basic example

{
  "class": "CameraBookmark",
  "name": "overview_01",
  "__parent": "CameraBookmarks",
  "position": [100, 200, 50],
  "rotationMatrix": [1, 0, 0, 0, 1, 0, 0, 0, 1],
  "scale": [1, 1, 1],
  "observer": true
}

Important fields

Field	Type	Description
`class`	string	Must be `"CameraBookmark"`.
`name`	string	Bookmark name.
`__parent`	string	Parent group, often `CameraBookmarks`.
`position`	array[3]	Camera bookmark position.
`rotationMatrix`	array[9]	Camera bookmark orientation.
`scale`	array[3]	Standard scene object scale. Usually `[1, 1, 1]`.
`observer`	bool	Marks the bookmark as suitable for observer camera use.

Tool notes

For tools that process level object files:

Preserve camera bookmarks unless intentionally cleaning editor data.
Keep names stable if screenshots, review tools, or scripts refer to them.
Treat them as editor/helper objects, not gameplay geometry.
Group them under a clear camera bookmark group where possible.

Common issues

Bookmark opens at the wrong view because rotationMatrix was changed or regenerated incorrectly.
Tool cleanup removes bookmarks that are used by review or screenshot workflows.
Bookmarks are hard to use because names are generic or duplicated.

Validation criteria

Bookmarks load in the editor.
Viewpoints point at useful level areas.
Names are descriptive enough for tool/editor use.
Tooling preserves bookmarks unless removal is intentional.