gdk-unity-package/README.md

3.5 KiB

Update: This GDK Unity package will be deprecated by December 31, 2024. It is superseded by the new Microsoft GDK Packages for Unity, available via the Package Manager in Unity 6. See this forum post for more information.

GDK Unity Package (PC Only)

This package is developed and supported by Microsoft and is not affiliated with Unity Technologies.

Overview

The GDK Unity package provides a way for PC GDK developers to integrate Game Core runtime functionality and Xbox Live functionality into their Unity based game.

Build

Supported Versions of Unity

The GDK Unity package supports Unity 2017.4 and newer.

How to use

  1. Make sure you have the GDK installed.

  2. Download the Unity package from the releases tab.

  3. Import the Unity package into your Unity project.

  4. Follow our Unity E2E guide for info on everything from setup to shipping.

What's inside

The plugin contains the following:

  • /GDK-APIs - This folder contains the C# projections of Game Core Runtime APIs and Xbox Live APIs.
  • /GDK-Tools - This folder contains developer tools to help integrate the GDK.
  • /GDK-Tools/Examples - This folder contains samples for some common GDK scenarios.
  • /GDK-Tools/ProjectMetadata - This folder contains the game's MicrosoftGame.Config file.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Having Trouble?

We'd love to get your review score, whether good or bad, but even more than that, we want to fix your problem. If you submit your issue as a Review, we won't be able to respond to your problem and ask any follow-up questions that may be necessary. The most efficient way to do that is to open a an issue in our issue tracker. The team will be engaged with the community and be continually improving our APIs, tools, and documentation based on the feedback received.

GDK GitHub projects

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.