mythicmob_npc_bone_camera_cinematic

Attach the cinematic camera to a bone of a MythicMob NPC's model — cinematic entry.

Entry Information

Property	Value
Entry ID	mythicmob_npc_bone_camera_cinematic
Type	Cinematic
Color	Cyan
Icon	fa6-solid:video

Fields

Field	Type	Description
segments	List<MythicMobNpcBoneCameraSegment>	At least two segments in the editor. Each segment selects the NPC source and camera bone for its frame range.

MythicMobNpcBoneCameraSegment

Field	Type	Description
startFrame / endFrame	Int	Inclusive frame range for the segment.
entityCinematic	Ref<MythicMobNpcEntityCinematicEntry>	Animated NPC source. Takes priority over instance.
instance	Ref<MythicMobNpcInstance>	Placed NPC instance used when no entity cinematic is set.
boneName	Var<String>	Bone carrying the camera.
searchRadius	Double	Radius, in blocks, used to match a live NPC to the instance spawn point. Default 16.
offset	Vector	Local offset from the bone: X right, Y up, Z forward.
orientation	MythicMobNpcBoneCameraOrientation	Controls the camera facing.

MythicMobNpcBoneCameraOrientation

Field	Type	Description
mode	FOLLOW_BONE, LOOK_AT_BONE, LOOK_AT_POSITION, FIXED	Follow the bone, look at another bone/NPC, look at a world position, or keep fixed angles.
forwardAxis	BoneForwardAxis	Bone axis considered forward. NEGATIVE_Z matches the usual Blockbench orientation.
lookAtBone	Var<String>	Target bone for LOOK_AT_BONE; empty targets the NPC.
lookAtPosition	Var<Position>	World target for LOOK_AT_POSITION.
yaw / pitch	Double	Fixed yaw and pitch used by FIXED.
yawOffset / pitchOffset	Double	Additional rotation applied after the selected orientation mode.

Usage Example

- entry: mythicmob_npc_bone_camera_cinematic
  name: "Attach the cinematic camera to a bone of a MythicMob NPC's model"
  segments:
    - startFrame: 0
      endFrame: 120
      entityCinematic: dragon_npc_cinematic
      boneName: camera
      searchRadius: 16.0
      offset: { x: 0.0, y: 0.0, z: 0.0 }
      orientation:
        mode: FOLLOW_BONE
        forwardAxis: NEGATIVE_Z

The entity cinematic source always wins over a placed instance, so the camera stays attached to the NPC being animated. The entry supports both BetterModel and ModelEngine model bones. If the NPC or bone is temporarily unavailable, the camera holds its last valid position instead of snapping to the origin.