{
  "id": "unity/invalidoperationexception-graphicssettings-mismatch",
  "signature": "InvalidOperationException: Graphics device type [OpenGLCore] is not supported on this platform. Please switch to Direct3D11 or Vulkan.",
  "signature_zh": "InvalidOperationException：图形设备类型 [OpenGLCore] 在此平台上不受支持。请切换到 Direct3D11 或 Vulkan。",
  "regex": "InvalidOperationException: Graphics device type \\[\\w+\\] is not supported on this platform",
  "domain": "unity",
  "category": "system_error",
  "subcategory": null,
  "root_cause": "The project's graphics API settings in Project Settings > Player are incompatible with the current build platform, e.g., OpenGLCore selected for Windows Standalone which requires D3D11.",
  "root_cause_type": "generic",
  "root_cause_zh": "项目设置 > Player 中的图形 API 设置与当前构建平台不兼容，例如为 Windows Standalone 选择了 OpenGLCore，而该平台需要 D3D11。",
  "versions": [
    {
      "version": "Unity 2022.3.20f1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Unity 2023.1.10f1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Unity 6000.0.0b1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The error is not caused by missing drivers; it's a project configuration issue.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Graphics API settings are stored in ProjectSettings/ProjectSettings.asset, not in Library.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "The error is about graphics API, not CPU architecture.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Open Edit > Project Settings > Player > Other Settings > Rendering. Uncheck 'Auto Graphics API' and remove OpenGLCore from the list. Add Direct3D11 (Windows) or Vulkan (Linux/Android). Then rebuild.",
      "success_rate": 0.9,
      "how": "Open Edit > Project Settings > Player > Other Settings > Rendering. Uncheck 'Auto Graphics API' and remove OpenGLCore from the list. Add Direct3D11 (Windows) or Vulkan (Linux/Android). Then rebuild.",
      "condition": "",
      "sources": []
    },
    {
      "action": "If building for Android, ensure 'Minimum API Level' is set to at least 24 and Vulkan is selected as the primary graphics API.",
      "success_rate": 0.8,
      "how": "If building for Android, ensure 'Minimum API Level' is set to at least 24 and Vulkan is selected as the primary graphics API.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Open Edit > Project Settings > Player > Other Settings > Rendering. Uncheck 'Auto Graphics API' and remove OpenGLCore from the list. Add Direct3D11 (Windows) or Vulkan (Linux/Android). Then rebuild.",
    "If building for Android, ensure 'Minimum API Level' is set to at least 24 and Vulkan is selected as the primary graphics API."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.unity3d.com/Manual/GraphicsAPIs.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.85,
  "resolvable": "true",
  "first_seen": "2024-03-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}