Frequently Asked Questions (FAQs)

Here's all the individual settings you need to get an object to be lightmap-able:

• You’ll need to mark the object as Static:

• The mesh of the object will need a second set of UVs. In the model import setting, you can let Unity generate these UVs for you. “Manual” margin method is usually more space efficient.

• The light that is casting baked shadows needs to either be set to “Mixed” or “Baked” mode

Once you have all of these settings, re-bake your lightmaps.

• This could happen when you publish your space without LightingData. (This doesn't happen in sandbox.)

• Solution: Press the ‘Generate Lighting’ button under Lighting settings.

-Here's how to properly generate lighting:

1. Window -> Rendering -> Lighting to open Lighting window.
2. Go to Backed Lightmaps tab.
3. Press ‘Generate Lighting’ button and you’ll see LightingData is generated and assigned to the scene.

Disable ‘Generate Mip Maps’ on your texture setting. This happens if your skybox(panoramic) texture has mipmaps.

Problem: Terrain has normal maps but Spatial doesn’t render it on Web and Sandbox.

(Thanks to Shawn Young for reporting this bug and providing screen capture images.)

Solution:

• Do not use MaskMap in your Terrain Layers.
• Use 4 or less Terrain layers.

More info: - WebGL has limited sampler state (16) and some variants of terrain shader use more than it. In this case, Unity fails to compile the variant and uses one of fallbacks. - This compile fail doesn’t always happen. Some combinations between other graphics features like additional lights or lightmap modes generate different variants of terrain shader and some of it use more than 16 sampler state and fails to compile on web build. - So as a generic solution, you can leave the MaskMap slot empty, or you’ll need to test whether the terrain appears okay in your scene. - Also you should use 4 or less Terrain Layers to your Terrain for the same reason. - Check out Unity's documentation for more information

1. Select the lightmap texture and go to WebGL settings in the inspector.

2. Choose the RGBA Compressed DXT5|BC3 format under the Format option.

3. Click Apply to apply the changes.

4. ⚠️ Keep in mind that Crunched DXT has a significantly smaller size (15%) compared to Compressed DXT. In some cases, prioritizing smooth performance may be preferable over preserving every detail.

5. 🚫 Avoid using ASTC on WebGL as it is intended for mobile browsers. Unity will convert the textures again during runtime, leading to significant loading times. (Using ASTC is highly recommended for mobile platforms such as Android and iOS.)

• Go to the platform settings and choose a texture format that does not include an alpha channel (RGB, not RGBA).

Note that the AssetImportSettings will automatically detect the presence of alpha and choose the appropriate format accordingly.

• If a texture does not have alpha but is using a format that includes alpha, it will always appear white. And Unity Terrain layer will utilize it for smoothness, resulting in a glossy appearance. (Unity won’t use alpha if the format doesn’t include alpha)

• ASTC is the recommended format for mobile devices. However, as ASTC contains alpha, it can still result in the same issue. As an alternative, you can choose DXT1. Please note that selecting DXT1 will lead to a larger file size compared to ASTC. If you have experience with texture processing, you can manually add a smoothness value to the alpha channel of the texture. Alternatively, you can utilize this utility to help you achieve the desired outcome.

• Try adjusting the texture settings by using formats with alpha (DXT5) or without alpha (DXT1) to see if it resolves the issue.
• If that doesn't work, please post your issue in the Creator Toolkit forums on the Spatial Discord server.

• Select the texture or model in the project and enable the Read/Write option.

⚠️ Note that enabling Read/Write will result in a doubling of the memory size.

• Unity doesn't like it when you combine the same font material between TMPro UGUI and TMPro fonts.
• Best way to prevent this is to duplicate the font material and name them appropriately (eg. NotoSans-UI and NotoSans-World)
• Go through all uses of your font and assign the appropriate font material in the dropdown selector.