Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more info to Sonic Generations troubleshooting page. #72

Merged
merged 2 commits into from
May 10, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,18 @@ The game shows a rainbow flashing texture if the texture assigned to a material

The material might not have any textures assigned at all. You need to at least assign one diffuse texture, otherwise the game is going to use the texture of whatever was rendered last.

### Missing Transparency On Textures

* You might need `@LYR(trans)` or `@LYR(punch)` tags on your material names. See [terrain importing guide](/guides/hedgehog-engine/blueblur/levels/importing-terrain) for more information.
* Your texture might be compressed using `BC1`/`DXT1` format. This format does not support alpha channels. For transparent textures, use the `BC3`/`DXT5` compression format instead.

### Missing Terrain Models

* `Terrain.prm.xml` file might require higher memory sizes. Look for the `g_TerrainModelLimitSizeDefault` and `g_TerrainModelLimitSizeWin32` parameters, and increase them. If your stage requires more memory than what is defined in this file, some of your models might not render.
* There is a limit of 8192 instances in the game. If you are trying to render more instances, the game is going to hit this limit and stop rendering.
* Material files might be missing. There is a chance it might not crash and display nothing instead.
* You might have a `visibility-tree.vt` file leftover from another level in your files. This file controls occlusion culling, and it needs to be created specifically for the level it's used in. Remove this file to solve potential pop-in problems.
* Similarly, if you are porting a level from Sonic Unleashed to Sonic Generations or vice versa, you might experience issues if your set object cameras don't exactly match with the original game. If they do, you can safely keep this file.

### Red Materials

Expand Down
Loading