mapbox / mapbox/mapbox-unity-sdk

Custom Mapbox Style Not Applying in Unity SDK, Works Correctly in Web (iframe)

Open
#1,964 22 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C#
Stars
784
Forks
231
PR merge metrics
No merged PRs in 30d

Description

**Description**
When using a custom Mapbox style in the Unity SDK, the style does not apply correctly (or falls back to the default style). However, the same style works as expected when loaded via a Mapbox iframe on the web.

This suggests a possible issue with style compatibility, loading, or configuration specific to the Unity SDK.

**Steps to Reproduce**
Create a custom style in Mapbox Studio.
Publish the style.
Copy the style URL (e.g. mapbox://styles/username/style_id).

**In Unity:**
Use the Mapbox Unity SDK
Assign the custom style URL to the map’s Style field
Run the scene.

**Expected Behavior**
The map in Unity should render using the custom Mapbox style, matching the appearance seen on the web.

**Actual Behavior**
The custom style is not applied in Unity:
The map either renders black map
The style partially loads / fails silently
The same style URL renders correctly when used in a web iframe.

**Environment**
Unity Version: (6000.0.43f1)
Mapbox Unity SDK Version: (v2.1.1)
Platform: (Editor)
OS: (macOS Sonoma)

**Style Details**
Style created in Mapbox Studio
Style visibility set to Public
Style URL format: mapbox://styles/...
Works correctly in web iframe

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the issue in the Unity SDK using Unity 6000.0.43f1, SDK v2.1.1, the public mapbox://styles/... URL, and the Editor on macOS Sonoma; compare the result with the working web iframe. Trace the Unity map Style field through style loading and rendering, and consider the issue done when the custom style renders instead of a black, default, or partially loaded map.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp, unity
Domain
game-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.