<m-model>

The m-model element is a 3D model. It can be used to load and display various 3D model file formats, such as OBJ, FBX, or GLTF, depending on the rendering engine being used. The model can be positioned, rotated, and scaled within the 3D scene. It also supports animations.

Try it

Attributes

  • src: string

    The source URI of the 3D model file. Supported formats may vary depending on the rendering engine used.

  • anim: string

    The source URI of the animation file, if applicable. Supported formats may vary depending on the rendering engine used.

  • anim-loop: boolean

    Whether the animation should loop (true) or play once (false). Default value is true.

  • anim-enabled: boolean

    Whether the animation is enabled (true) or disabled (false). Default value is true.

  • anim-start-time: int

    The time in milliseconds since the start of the document lifecycle when the animation should begin. Default value is 0.

  • anim-pause-time: int

    The time in milliseconds since the start of the document lifecycle when the animation should pause. If there is no value the animation will not be paused.

Attribute Groups

  • Attribute Group: debuggable

    • debug: boolean

      A boolean that indicates whether the element should be drawn with debug information (e.g. axes helper). Default value is false.

  • Attribute Group: transformable

    • x: float

      The position of the element along the X-axis in meters. Default value is 0.

    • y: float

      The position of the element along the Y-axis in meters. Default value is 0.

    • z: float

      The position of the element along the Z-axis in meters. Default value is 0.

    • rx: float

      The rotation of the element around the X-axis in degrees. Default value is 0.

    • ry: float

      The rotation of the element around the Y-axis in degrees. Default value is 0.

    • rz: float

      The rotation of the element around the Z-axis in degrees. Default value is 0.

    • sx: float

      The scale of the element along the X-axis. Default value is 1.

    • sy: float

      The scale of the element along the Y-axis. Default value is 1.

    • sz: float

      The scale of the element along the Z-axis. Default value is 1.

    • visible: boolean

      Whether the element is visible (true) or hidden (false) in the scene. Default value is true.

    • socket: string

      The name of a bone in the parent element's skeletal mesh to which this element will be attached. If not specified, the element will attach to the origin of its parent.

  • Attribute Group: collideable

    • collide: boolean

      Whether or not this object should participate in collision detection by other systems. Default value is true. If set to true, the object will be considered for collision tests.

    • collision-interval: int

      If set, the time in milliseconds between user collision events being sent to the element. By default collision events are not sent.

    • oncollisionstart: script

      A script expression to be executed when a user starts colliding with the element. Receives a CollisionStartEvent.

    • oncollisionmove: script

      A script expression to be executed when a user moves the collision point they are colliding at on the element. Receives a CollisionMoveEvent.

    • oncollisionend: script

      A script expression to be executed when a user stops colliding with the element. Receives a CollisionEndEvent.

  • Attribute Group: coreattrs

    • id: ID

      A unique identifier for the element, used for selection and manipulation through scripting. It must be unique within the document.

    • class: string

      A space-separated list of class names that can be used for scripting purposes.

  • Attribute Group: clickable

    • onclick: script

      A script expression that is executed when the element is clicked. Events are also dispatched to "click" event listeners.

  • Attribute Group: shadows

    • cast-shadows: boolean

      Whether the element casts shadows onto other elements (true) or not (false). Default value is true.

Examples

Scale

This is an m-model with scale properties.

Position

This is an m-model with position properties.

Rotation

This is an m-model with rotation properties.

Compatibility Table

WEBUNREAL
m-model✓✓
src✓✓
anim✓✓
anim-loop✓✓
anim-enabled✓✓
anim-start-time✓✓
anim-pause-time✓✓
debug✓✓
x✓✓
y✓✓
z✓✓
rx✓✓
ry✓✓
rz✓✓
sx✓✓
sy✓✓
sz✓✓
visible✓✓
socket✓✗
collide✓✓
collision-interval✓✗*
oncollisionstart✓✗*
oncollisionmove✓✗*
oncollisionend✓✗*
id✓✓
class✓✓
onclick✓✓
cast-shadows✓✗