Unity 6000.0.34f1中UI Toolkit的World Space设置问题（Render Mode缺失）

1. 使用专门的World Space Panel Settings资源 #

• 在Project窗口右键，选择 UI Toolkit > World Space Panel Settings，创建专门的世界空间面板设置资源。
• 选中该资源后，Inspector面板会显示世界空间相关配置项（如渲染相机、参考分辨率、缩放模式等），无需手动设置Render Mode。
• 将此资源拖到UIDocument组件的Panel Settings字段，即可启用World Space渲染。

2. 修复代码设置的编译错误 #

Unity 6中PanelSettings已拆分为ScreenSpacePanelSettings和WorldSpacePanelSettings子类，原renderMode属性已被移除。正确的代码实现方式如下：

using UnityEngine;
using UnityEngine.UIElements;

public class SetupWorldSpaceUI : MonoBehaviour
{
    void Awake()
    {
        var uiDocument = GetComponent<UIDocument>();
        
        // 方式一：加载已创建好的World Space Panel Settings资源
        // var worldPanelSettings = Resources.Load<WorldSpacePanelSettings>("WorldSpacePanelSettings");
        
        // 方式二：动态创建World Space Panel Settings
        var worldPanelSettings = ScriptableObject.CreateInstance<WorldSpacePanelSettings>();
        worldPanelSettings.worldSpaceCamera = Camera.main; // 指定渲染用的相机
        worldPanelSettings.referenceResolution = new Vector2(1920, 1080); // 设置UI参考分辨率
        
        uiDocument.panelSettings = worldPanelSettings;
    }
}

3. 检查包依赖兼容性 #

打开Window > Package Manager，确保以下包的版本与Unity 6000.0.34f1匹配：

• UI Toolkit (com.unity.ui)
• UI Toolkit Runtime (com.unity.ui.runtime)
  若版本不兼容，点击包详情页的Update to latest compatible version按钮更新即可。

补充说明 #

Unity 6对UI Toolkit的Panel配置逻辑进行了重构，将原有的Render Mode选项替换为不同类型的Panel Settings资源，官方文档存在更新滞后的情况。使用专门的WorldSpacePanelSettings即可完成世界空间UI的配置。

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