Mesh samples overview

There are a number of Mesh sample projects available that you can use as starting points for your own custom environments. Each project is already set up with the Mesh toolkit package and contains many assets that you might find useful.

When you download the samples from GitHub, you also get a Control Samples package that contains user interface controls you can use in your projects. The control samples were built using the Mesh Toolkit.

Studying the Mesh sample projects will help you learn about the following:

  • Different types of experiences you can create with Mesh.
  • The many assets available in the Mesh toolkit.
  • The Mesh components that can make GameObjects interactive.
  • The different types of interactivity (for example, simple grabbing, or grabbing and holding, or grabbing and throwing).
  • How to ensure that objects are held realistically by using Equippables.
  • How to set up events and actions through visual scripting.
  • Mesh-specific nodes that you can use in your scripts.
  • How physics works in Mesh.

About the sample projects

  • Mesh 101: Mesh 101 is a tutorial, but it also doubles as a sample. The tutorial part teaches you how to set up an educational experience about wind farms using Mesh Interactables, physics, scripting and more. In the project, you can open the StartingPoint scene and begin walking through the tutorial. However, the project contains another scene named FinishedProject which is a completed version of the tutorial. You can view this scene as a sample and use it as starting point for your project just as you would with any of the other samples. Get started with the Mesh 101 tutorial.

  • Mesh 201: Continuing with the wind farm theme of Mesh 101, this tutorial/sample takes your Mesh knowledge to the next level. You'll learn how to use WebSlates to display web content and add an interactive globe that, when clicked, gets data from Bing Maps and displays it in your environment. You'll also use Mesh Cloud Scripting to download and display real-time weather data in 3D and you'll set up an OpenAI chatbot which attendees can use to ask questions about wind farms. Get started with the Mesh 201 tutorial.

  • Pavilion: A project that showcases a number of useful Mesh features: assets, shaders, visual scripting, animations, VFX, and SoundFX. Learn more about the Pavilion sample.

  • Physics Effects Gallery: Contains a programmer-art designed scene that demonstrates the power of combining appealing visuals with the creative use of Mesh Physics features. Learn more about the Physics Effects Gallery sample.

  • Dart Room: A saloon-style room with a dart game to showcase interactive Mesh Physics features. Learn more about the Dartroom sample.

  • Science Building: An expansive museum exhibiting the power of Mesh Physics to create dynamic, engaging experiences. Learn more about the Science Building sample.

To start with a sample project:

  1. If you haven't done so already, download and unzip the Mesh samples.

  2. In the Unity Hub, select Open > Add project from disk, and then navigate to the folder you extracted that contains the samples.

  3. Open the sample project you want.

  4. In Unity, navigate to Assets > Scenes and then open the scene you want---this will vary from sample to sample. For example, in the Science Building project, you would open the ScienceBuilding scene.

Here's an example of what you'll find in that scene:___

Build and publish your customized sample

After you customize a sample, you can convert it into an Environment by building and publishing it to Mesh on the web. An event Organizer can then create an event based on that Environment. To learn more, see Build and publish your environment.

Contributions

We are not currently accepting code contributions to our samples. If you have any feedback or if you run into any issues with the samples or the Mesh toolkit, do the following: in a Unity project that has the Mesh toolkit package installed, select Mesh Toolkit -> Give feedback to Microsoft and then use the feedback link in the Mesh toolkit to let us know.

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.

License

The Mesh samples are governed by the MIT license as shown in the LICENSE.MD file in the Mesh-Toolkit-Unity repository. However, the samples functionality is dependent on the Mesh toolkit, which is governed by a separate license, and contains 3rd party software.

-- View gaming activities that you can use in your project.