Entity Reference Component

The Entity Reference component allows you to track one or more entity IDs that you can conveniently access through script or C++ code during editor mode.

Provider

Atom Gem

Properties

Entity Reference Component UI

PropertyDescription
EntityIdReferencesContains a list of entities whose IDs will be tracked.

Usage

During editor mode, call the EntityReferenceRequestBus to retrieve the list of entities being referenced by the component. This example uses the O3DE’s Python Console to retrieve a list of entity IDs.

# entityId contains the Entity Reference component.
entityIdReferences = azlmbr.entity.EntityReferenceRequestBus(azlmbr.bus.Event, 'GetEntityReferences', entityId)
 
for id in entityIdReferences:
    print(id.ToString())
 
 
# Expected Output: Entity IDs of the referenced entities.
# [3664549435643349363]
# [17340279414445478303]

Copyright © 2026 DawnEngine. All rights reserved.

DawnEngine is a commercial 3D engine distributed under the DawnEngine end-user license agreement. Engine binaries and source are proprietary and are not covered by the licenses below.

Documentation only: the prose and templates on this site are a derivative work of Open 3D Engine (O3DE) documentation by the O3DE Contributors, used under CC BY 4.0 (documentation content), Apache 2.0 (site code), and the MIT license (inline code samples).

The open-source 3D engine that DawnEngine is built on top of is Open 3D Engine . DawnEngine is not affiliated with, endorsed by, or sponsored by The Linux Foundation or the O3DE project. “O3DE” and “Open 3D Engine” are trademarks of The Linux Foundation.