Actors & animation角色与动画

The actor you play was generated, rigged and animated by Lux3D. A static character mesh went through humanoidAutoRig for a skeleton and humanoidAnimationRetarget for clips, and now walks the worlds on their voxel floors.你操控的角色由 Lux3D 生成、绑骨并赋予动画。一个静态角色网格先经过 humanoidAutoRig 获得骨骼,再经过 humanoidAnimationRetarget 获得动作片段,如今能在各个世界的体素地面上行走。

From prompt to playable actor从提示词到可操控角色

  1. Mesh. textTo3d on G1-Turbo with a prompt that asks for a strict T-pose (task 8354807): “A realistic adult person standing in a strict T-pose, both arms straight out horizontally at shoulder height, palms down, legs straight and slightly apart, fitted plain clothing and simple shoes, full body, facing forward, no accessories, no props, no hat.”网格。用 G1-Turbo 调用 textTo3d,提示词要求严格的 T-pose(任务 8354807):「A realistic adult person standing in a strict T-pose, both arms straight out horizontally at shoulder height, palms down, legs straight and slightly apart, fitted plain clothing and simple shoes, full body, facing forward, no accessories, no props, no hat.」(大意:一名写实风格的成年人,严格 T-pose,双臂在肩高处水平伸直、掌心向下,双腿伸直并略微分开,穿合身的素色衣服和简单的鞋子,全身,面朝前方,无配饰、无道具、不戴帽子。)
  2. Skeleton. humanoidAutoRig added 52 joints and skin weights in 81 s (task 8355123).骨骼。humanoidAutoRig 用 81 s 添加了 52 个关节和蒙皮权重(任务 8355123)。
  3. Clips. humanoidAnimationRetarget put eight official clips on that rig in one combined GLB (task 8359816, at most 17 s).动作片段。humanoidAnimationRetarget 把八个官方动作片段重定向到这套骨骼上,合并为一个 GLB(任务 8359816,耗时不超过 17 s)。

Our first character, a courier in an A-pose, was rejected by the rigger with RIG_ELIGIBILITY_FAILED (task 8354170). Regenerating it in a strict T-pose fixed that. Both attempts are on the bench.我们的第一个角色是一个 A-pose 的快递员,被绑骨服务以 RIG_ELIGIBILITY_FAILED 拒绝(任务 8354170)。改为严格 T-pose 重新生成后,问题就解决了。两次尝试都可以在测试台上查看。

The eight clips on the actor角色身上的八个动作片段

The combined GLB names its clips animation_1 to animation_8. They follow the order we requested; the five clips shared with an earlier retarget have identical lengths, which confirmed the mapping. The stage renames them on load.合并后的 GLB 把动作片段命名为 animation_1 到 animation_8,顺序与我们请求的顺序一致;其中与早先一次重定向重合的五个片段时长完全相同,印证了这一对应关系。舞台在加载时会为它们重新命名。

Clip in the file文件中的片段Lux3D animationLux3D 动作Length时长Used for用途
animation_1Idle_Loop2.5 sstanding still站立不动
animation_2Walk_Loop1.33 swalking行走
animation_3Jog_Fwd_Loop0.93 sShift or a full joystick push按住 Shift 或摇杆推到底
animation_4Interact2 sbrewing (E)冲咖啡(E)
animation_5Chest_Open1.37 sActor tab角色标签页
animation_6Yes2.5 sActor tab角色标签页
animation_7Dance_Loop1 scheering (F)欢呼(F)
animation_8Sword_Attack1.53 sActor tab角色标签页

The full clip library完整动作库

The Actor tab lists all 85 official Lux3D humanoid animations, searchable and grouped. Selecting one plays it if it is already on the actor, and calls humanoidAnimationRetarget for it (live with a key, a preview receipt without). One retarget job takes 1 to 10 animation IDs.角色标签页列出全部 85 个官方 Lux3D 人形动画,支持搜索并按类别分组。选中某个动画时,如果它已在角色身上就直接播放,同时为它调用 humanoidAnimationRetarget(有密钥时为实时调用,没有密钥时返回预览回执)。一个重定向任务可包含 1 到 10 个动画 ID。

Group分组Clips动作数Examples示例
Locomotion & Traversal移动与穿越11Idle_Loop, Walk_Loop, Walk_Formal_Loop
Parkour & Acrobatics跑酷与杂技10Jump_Start, Jump_Loop, Jump_Land
Social, Dialogue & Acting社交、对话与表演16Dance_Loop, Idle_Talking_Loop, Idle_TalkingPhone_Loop
Object Interaction & Work物体交互与劳作12Interact, Chest_Open, PickUp_Table
Combat, Melee, Ranged & Magic战斗:近战、远程与魔法29Sword_Idle, Sword_Attack, Sword_Heavy_Combo
Impact Reactions & Creatures受击反应与怪物7Hit_Chest, Hit_Head, Hit_Knockback

On the stage在舞台上

The actor is placed at the world's actorSpot (or just ahead of the spawn point) and dropped onto the voxel floor. Its glTF is flipped into the −Y-up frame, scaled to the preset height and driven by Animation.AnimationMixer from @manycore/aholo-viewer, one action per clip. Switching clips resets the next action before activating it, because AnimationAction.reset() in the viewer also deactivates the action.角色放在世界的 actorSpot(或出生点正前方),再落到体素地面上。它的 glTF 被翻转到 −Y 向上的坐标系,缩放到预设高度,并由 @manycore/aholo-viewer 的 Animation.AnimationMixer 驱动,每个动作片段对应一个 action。切换片段时,会先重置下一个 action 再激活它,因为查看器中的 AnimationAction.reset() 也会把 action 停用。

Manycore's demo robot and human GLBs were removed from the actor list: their root scales (1.78e-5 and 0.0035) made them invisible on this stage. The Lux3D actor is the only actor, and it is a real result.Manycore 的演示机器人和人物 GLB 已从角色列表中移除:它们的根节点缩放(1.78e-5 和 0.0035)导致它们在这个舞台上看不见。Lux3D 角色是唯一的角色,而且是真实结果。