Mapbox Unity Sdk


For Unity 2017.1+

(for 5.4x compatible versions, please use this commit)

Tools for using Mapbox APIs with C# / Unity. If you’d like to contribute to the project, read

This repo contains:

  • Unity specific tools and libraries for processing Mapbox data
    • Example projects using Mapbox Unity SDK
    • DocFX project for generateing API documentation
    • Written manuals and guides

Getting started

Versioned SDK (easy, current stable release)

  • Download unitypackage from
  • If you’ve installed the SDK before, delete Assets/Mapbox folder from your project
  • Within Unity: Assets -> Import Package -> Custom Package... -> All -> Import, wait 😏

From this Repository (advanced, latest development)

Downloading the repo as a zip does not work!

git clone [email protected]:mapbox/mapbox-unity-sdk.git
cd mapbox-unity-sdk

Windows: update-mapbox-unity-sdk-core.bat

Linux/Mac: ./


Documentation is generated using DocFX from this repo and is hosted at:


This project includes git submodule dependencies outlined in this gitmodules file.

To install/update the dependencies after git clone/git pull run update-mapbox-unity-sdk-core.bat or (depending on your OS).

These repos are actively developed and maintained:

NOTE: As of May 16, 2017, the repo has been merged into this repo. These source files are now located here: /sdkproject/Assets/Mapbox/Core/mapbox-sdk-cs. Core cs changes will be backported on a case-by-case basis.

Building a Unity Package

To build a Unity Package for import into your own project from the included sdkproject:

  1. Select Mapbox folder in the project view.
  2. Right-click and choose Export Package....

screen shot 2017-05-26 at 1 14 01 pm

  1. Uncheck Include Dependencies.

screen shot 2017-05-26 at 1 14 55 pm

  1. Click Export and choose a location.