hz-unity-tmp-resources

TextMesh Pro Resources Import

When to use this skill

Use this skill automatically when any of the following are detected:

• TMP text appears pink/magenta in the scene
• Console errors mentioning LiberationSans SDF, TMP Settings, or missing TMP materials
• Creating the first TMP text element in a project
• User asks to set up TextMesh Pro or create UI text
• Assets/TextMesh Pro/Resources/ folder does not exist

Step 1: Check if TMP resources are already imported

Before importing, check whether resources already exist using Unity_RunCommand:

using UnityEngine;
using UnityEditor;
using System.IO;

internal class CommandScript : IRunCommand
{
    public void Execute(ExecutionResult result)
    {
        string resourcesPath = Path.Combine(Application.dataPath, "TextMesh Pro", "Resources");
        bool imported = Directory.Exists(resourcesPath);

        if (imported)
        {
            string fontPath = "Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF.asset";
            var font = AssetDatabase.LoadAssetAtPath<Object>(fontPath);
            result.Log("TMP Essential Resources: ALREADY IMPORTED. Default font present: {0}", font != null);
        }
        else
        {
            result.Log("TMP Essential Resources: NOT IMPORTED. Resources folder missing at {0}", resourcesPath);
        }
    }
}

If already imported, stop here — no action needed.

Step 2: Import TMP Essential Resources

IMPORTANT: The TMP import process opens a Unity dialog that requires manual user interaction. This cannot be fully automated via MCP.

Use Unity_RunCommand to trigger the import dialog:

using UnityEngine;
using UnityEditor;

internal class CommandScript : IRunCommand
{
    public void Execute(ExecutionResult result)
    {
        EditorApplication.ExecuteMenuItem("Window/TextMeshPro/Import TMP Essential Resources");
        result.Log("TMP Essential Resources import dialog opened. User must click Import in the Unity Editor.");
    }
}