Unity 2017.3.1f1：如何用MatchTarget让根运动仅控位/旋并修正180°旋转误差？

Hey there! I’ve dealt with this exact rotation accuracy issue using Mecanim root motion—especially for 3D characters in 2D games. Let’s walk through how to get that perfect 180° Y-axis rotation and control whether root motion affects position, rotation, or just one of them.

1. Use Animator.MatchTarget() to Lock in Exact Rotation #

Mecanim’s root motion rotation can drift because it’s calculated from animation clip data over time. MatchTarget() is built for this scenario—it forces your character to snap to a target transform mid-animation, eliminating those annoying 177°/181° errors.

Here’s a tailored code snippet for your use case:

public Animator characterAnimator;
// Adjust this based on how long your turn animation runs (e.g., 0.2s for a quick turn)
public float matchTransitionDuration = 0.2f;

public void Trigger180Turn()
{
    // Keep the character's current position, calculate the exact 180° Y rotation
    Vector3 targetPos = characterAnimator.transform.position;
    Quaternion targetRot = characterAnimator.transform.rotation * Quaternion.Euler(0, 180, 0);

    // Match only rotation (ignore position)
    characterAnimator.MatchTarget(
        targetPos, 
        targetRot, 
        AvatarTarget.Root,
        // Weight mask: 0 for position (no change), 1 for rotation (full match)
        new MatchTargetWeightMask(Vector3.zero, 1f),
        0f, // Start matching at the beginning of the animation
        matchTransitionDuration // How long the matching takes
    );
}

Key Notes for This Code: #

• AvatarTarget.Root ensures we’re targeting the character’s root transform (where root motion is applied)
• The MatchTargetWeightMask lets us isolate rotation—no unwanted position shifts
• Align matchTransitionDuration with the timing of your turn animation (e.g., if your turn clip is 0.3s long, use 0.2s to leave a little time for the animation to finish smoothly)

2. Control Root Motion to Only Affect Position or Rotation #

You have two reliable ways to restrict root motion to either position or rotation—pick the one that fits your workflow:

Option A: Animator State Machine Settings (Per-Animation Control) #

For per-state control (e.g., turn animations only rotate, walk animations only move):

1. Open your Animator window
2. Select the animation state you want to modify
3. In the Inspector, expand the Root Motion section
4. Uncheck either Root Rotation or Root Position—only leave the one you need enabled

This is great for static state-based control, like ensuring your turn animation never moves the character, only rotates it.

Option B: Dynamic Runtime Control (Code) #

If you need to toggle root motion scope during runtime (e.g., mid-animation), use the OnAnimatorMove() callback to override how root motion is applied:

// Set these booleans based on your game's logic (e.g., when turning, set onlyRotate = true)
private bool onlyRotate = false;
private bool onlyMove = false;

private void OnAnimatorMove()
{
    if (onlyRotate)
    {
        // Apply only root rotation, ignore position changes
        characterAnimator.transform.rotation = characterAnimator.rootRotation;
    }
    else if (onlyMove)
    {
        // Apply only root position, ignore rotation changes
        characterAnimator.transform.position += characterAnimator.deltaPosition;
    }
}

Note: Keep Apply Root Motion enabled on your Animator component—this callback only works when root motion is active, and lets you customize its behavior.

3. Quick Troubleshooting Tips #

• Double-check your turn animation clip’s root rotation: Make sure the clip itself is close to 180°—MatchTarget() fixes drift, it doesn’t create rotation from scratch
• Avoid conflicting transitions: If your animator has overlapping state transitions, they can interfere with MatchTarget() timing—keep transition durations short for turn states
• Test with Gizmos: Enable rotation gizmos in the Scene window to visually confirm your character hits exactly 180° after the turn

内容的提问来源于stack exchange，提问作者Filip Pokorny