Please make sure you are familiar with all the modding basics covered in the "Basics Modding Guide" and the basics of unity navigation, links below. This guide assumes you already know how to navigate the scene and are familiar with the interface, and have Unity and Mod SDK installed. Without this crucial info, it will be difficult to go through this specialized guide.

Steam Guide - Basic Modding Guide Link

Unity official documentation
https://docs.unity3d.com/2021.1/Documentation/Manual/UsingTheEditor.html
https://docs.unity3d.com/2020.1/Documentation/Manual/SceneViewNavigation.html
https://docs.unity3d.com/2021.1/Documentation/Manual/ViewModes.html
https://docs.unity3d.com/2021.1/Documentation/Manual/GizmosMenu.html
https://docs.unity3d.com/2020.1/Documentation/Manual/ImportingAssets.html

First of all you have to have Volcanoids Mod SDK installed and your mod created. In this guide we will be working with this set up.

Prerequisities:

1. ModSDK Installed
   
2. Created new mod

You can create a new scene and randomly place objects into it, but then it will be a problem, because some objects might end up above the terrain. So follow these steps:

1. Find a scene in Packages called Island and drag&drop into assets folder.
   Note: In the "Packages" folder, the "Island" scene would not run read-only. Therefore, he must drag to Assets where there is full access.
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
2. Then create in your Mod folder new scene by Right-Click/Create/Scene
   
3. Name your scene and Right-click it and click Open Scene Additive (Or drag and drop it into the hierarchy window). Now you will have two scenes opened.
   
4. Add all your models into the Additive scene and after your models are added, save it.

You have your scene created, but it won’t be loaded itself. Your mod does not know anything about your scene. Follow these steps:

1. Open your mod asset in inspector
   
2. Right click name of the file
   
3. Click Add scene bundle
   
4. Unfold mod in project window and click on “scenes” under your mod.
   
5. Into the scenes list, add your scene.

Now your mod knows your scene, but it won’t load it because you have to tell the game to load it right after start. Follow another steps:

1. Go to your Mod Data folder and right click it.
   
2. Click Create/Mods/Load additive scenes
   
3. Name it like you wish and add your scene into the scenes list.

Now you’re done! Yoru Additive scene will be loaded.

This part is a bit tricky and requires tons of adjusting. We will cover just the basic guide, so you can then play with that. You will be required to know how navigation in unity works. To create navmesh, follow these steps:

1. Create simple structure, that can be seen in AdditiveScene mod.
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
2. Add NavMeshSurface component to the object root
   
3. Don’t forget to add colliders onto all surfaces and walls
   
4. Set up the surface like this: (Layer Mask is set to everything)
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
5. Hit Bake and your navmesh will be baked.
   
6. Create a prefab from your object into the Data folder and add the prefab into the scene.
   
7. To create obstacles, add NavMeshObstacle and set proper size. If you want to modify the default island scene, set Carve to true on the bottom cube so cogs won't get through your building.

Warning: To display NavMesh, don’t use prefab mode. Open it in the scene instead. Also, we don’t recommend baking your navmesh in the Island scene. Rather open an empty one and save your building as a prefab.

Blast shelters are collider zones that will save you from the volcano eruption, so you won’t die. To setup one follow the steps:

1. Add BlastWaveSafezone component to the root of your object
   
2. Create box collider and mark it as trigger
   
3. Assign the collider into the Safe Collider field.

And now you are done! You can now upload your mod with your steam account.

Uploading your mod is covered in the Basic Modding Guide.

The video serves for a better understanding of working with the Volcanoids mod SDK and specific work with Unity.


- create mod
- insert additive scene
- insert model and configure
- LODs configuration
- Work with additive scenes
- build mod
- test mod

Volcanoids SDK - Speed run tutorial - Mod additive scene