Troubleshooting Custom Level Issues in Sonic Generations/Sonic Unleashed - Revision history

Skyth at 22:07, 11 May 2025

2025-05-11T22:07:12Z

← Older revision		Revision as of 22:07, 11 May 2025
Line 15:		Line 15:

	==== Missing Terrain Models ====		==== Missing Terrain Models ====
	<code>StageGuidePath.path.xml</code> leftover from another level can cause wonky terrain streaming or not render some of your terrain models, as it wouldn't follow the path of your stage. To disable stage guide path, you can simply remove the <code>.path.xml</code> file or set <code>g_UseGuidePath</code> in <code>Terrain.prm.xml</code> to <code>false</code>.		<code>StageGuidePath.path.xml</code> leftover from another level can cause wonky terrain streaming or not render some of your terrain models, as it wouldn't follow the path of your stage. To disable stage guide path, you can simply remove the <code>StageGuidePath.path.xml</code> file or set <code>g_UseGuidePath</code> in <code>Terrain.prm.xml</code> to <code>false</code>.

	==== Missing Direct Light ====		==== Missing Direct Light ====

Skyth at 11:27, 3 May 2025

2025-05-03T11:27:35Z

← Older revision		Revision as of 11:27, 3 May 2025
Line 15:		Line 15:

	==== Missing Terrain Models ====		==== Missing Terrain Models ====
	<code>StageGuidePath.path.xml</code> leftover from another level can cause wonky terrain streaming ~~and~~ not render some of your terrain models, as it wouldn't follow the path of your stage. To disable stage guide path, you can simply remove the <code>.path.xml</code> file or set <code>g_UseGuidePath</code> in <code>Terrain.prm.xml</code> to <code>false</code>.		<code>StageGuidePath.path.xml</code> leftover from another level can cause wonky terrain streaming or not render some of your terrain models, as it wouldn't follow the path of your stage. To disable stage guide path, you can simply remove the <code>.path.xml</code> file or set <code>g_UseGuidePath</code> in <code>Terrain.prm.xml</code> to <code>false</code>.

	==== Missing Direct Light ====		==== Missing Direct Light ====

Skyth at 11:26, 3 May 2025

2025-05-03T11:26:40Z

← Older revision		Revision as of 11:26, 3 May 2025
Line 13:		Line 13:
	==== Missing Transparency On Textures ====		==== Missing Transparency On Textures ====
	You might need <code>@LYR(trans)</code> or <code>@LYR(punch)</code> tags on your material names. See the [[How To Import Custom Terrain in Sonic Generations/Sonic Unleashed\|terrain importing guide]] for more info. Your texture might be compressed using <code>BC1</code>/<code>DXT1</code>, which doesn't support alpha channels, you should use <code>BC3</code>/<code>DXT5</code> instead.		You might need <code>@LYR(trans)</code> or <code>@LYR(punch)</code> tags on your material names. See the [[How To Import Custom Terrain in Sonic Generations/Sonic Unleashed\|terrain importing guide]] for more info. Your texture might be compressed using <code>BC1</code>/<code>DXT1</code>, which doesn't support alpha channels, you should use <code>BC3</code>/<code>DXT5</code> instead.

			==== Missing Terrain Models ====
			<code>StageGuidePath.path.xml</code> leftover from another level can cause wonky terrain streaming and not render some of your terrain models, as it wouldn't follow the path of your stage. To disable stage guide path, you can simply remove the <code>.path.xml</code> file or set <code>g_UseGuidePath</code> in <code>Terrain.prm.xml</code> to <code>false</code>.

	==== Missing Direct Light ====		==== Missing Direct Light ====

NextinHKRY at 10:40, 3 May 2025

2025-05-03T10:40:17Z

← Older revision		Revision as of 10:40, 3 May 2025
Line 48:		Line 48:

	==== Missing Terrain Models ====		==== Missing Terrain Models ====
	<code>Terrain.prm.xml</code> likely requires memory sizes to be higher. To fix this, edit <code>g_LimitSize</code> under <code>DynamicLoad</code> and <code>Terrain-Model</code> to values like '''100000000'''<small>b</small> or '''250000000'''<small>b</small>. Make sure to use sensible values as absurd values like '''999999999999''' are not going to work correctly. If editing the memory sizes does not work, you can try changing <code>g_EnableFrustumCulling</code> and <code>g_EnableOcclusionCulling</code> to <code>false</code> as a last resort. Note that disabling these two options might cause a performance hit in-game!		<code>Terrain.prm.xml</code> likely requires memory sizes to be higher. To fix this, edit <code>g_LimitSize</code> under <code>DynamicLoad</code> and <code>Terrain-Model</code> to values like '''100000000'''<small>bytes</small> or '''250000000'''<small>bytes</small>. Make sure to use sensible values as absurd values like '''999999999999''' are not going to work correctly. If editing the memory sizes does not work, you can try changing <code>g_EnableFrustumCulling</code> and <code>g_EnableOcclusionCulling</code> to <code>false</code> as a last resort. Note that disabling these two options might cause a performance hit in-game!

	==== File Replacements Not Working ====		==== File Replacements Not Working ====
Line 57:		Line 57:

	==== Low Quality or Missing GI Textures ====		==== Low Quality or Missing GI Textures ====
	<code>Terrain.prm.xml</code> likely requires memory sizes to be higher. To fix this, edit <code>g_LimitSize</code> under <code>DynamicLoad</code> and <code>GI-Texture</code> to values such as '''100000000'''<small>b</small> or '''250000000'''<small>b</small>. Make sure to use sensible values as absurd values like '''999999999''' are not going to work correctly. When DLC is enabled, the game looks inside the <code>Additional</code> folder to load HD GI, the parameter for it is named <code>g_Xbox360LimitSizeWithAdditional</code>, which you also should try to increase.		<code>Terrain.prm.xml</code> likely requires memory sizes to be higher. To fix this, edit <code>g_LimitSize</code> under <code>DynamicLoad</code> and <code>GI-Texture</code> to values such as '''100000000'''<small>bytes</small> or '''250000000'''<small>bytes</small>. Make sure to use sensible values as absurd values like '''999999999''' are not going to work correctly. When DLC is enabled, the game looks inside the <code>Additional</code> folder to load HD GI, the parameter for it is named <code>g_Xbox360LimitSizeWithAdditional</code>, which you also should try to increase.

	<hr>		<hr>

NextinHKRY at 20:30, 2 May 2025

2025-05-02T20:30:59Z

← Older revision		Revision as of 20:30, 2 May 2025
Line 6:		Line 6:

	==== Black Textures ====		==== Black Textures ====
	Textures must have power-of-two resolutions (~~like~~ 512x512, 1024x1024, 2048x2048, etc). Arbitrary resolutions like 507x631 are not supported when using compressed textures.		Textures must have power-of-two resolutions ''(e.g. 512x512, 1024x1024, 2048x2048, etc)''. Arbitrary resolutions like 507x631 are not supported when using compressed textures.

	==== Randomly Switching Textures ====		==== Randomly Switching Textures ====

NextinHKRY at 20:27, 2 May 2025

2025-05-02T20:27:28Z

← Older revision		Revision as of 20:27, 2 May 2025
Line 103:		Line 103:

	==== Incorrect Material Format ====		==== Incorrect Material Format ====
	Unleashed uses V1 ~~materials while~~ Generations ~~uses~~ V3~~. If~~ you try to load a V3 material in Unleashed, it'll crash. Check the version in a hex editor (7th byte), or look for <code>.texset</code>/<code>.texture</code>, those usually mean it's V1.		Unleashed uses a different material version (V1) compared to Generations (V3), and if you try to load a material from Generations in Unleashed, it'll crash. Check the version in a hex editor (7th byte), or look for <code>.texset</code>/<code>.texture</code>, those usually mean it's V1.

	<hr>		<hr>

NextinHKRY at 18:53, 2 May 2025

2025-05-02T18:53:56Z

← Older revision		Revision as of 18:53, 2 May 2025
Line 1:		Line 1:
	This page covers ~~both~~ '''Sonic Generations''' and '''Sonic Unleashed'''~~. If no game is specified, the explanation applies to both games.~~		This page covers possible troubleshooting steps for custom levels in '''Sonic Generations''' and '''Sonic Unleashed.'''

	== Visual Issues ==		== Visual Issues ==

NextinHKRY at 18:50, 2 May 2025

2025-05-02T18:50:04Z

← Older revision		Revision as of 18:50, 2 May 2025
Line 44:		Line 44:
	</syntaxhighlight>The same method applies to Sonic Unleashed.		</syntaxhighlight>The same method applies to Sonic Unleashed.

			<hr>
	=== Sonic Unleashed ===		=== Sonic Unleashed ===

Line 58:		Line 59:
	<code>Terrain.prm.xml</code> likely requires memory sizes to be higher. To fix this, edit <code>g_LimitSize</code> under <code>DynamicLoad</code> and <code>GI-Texture</code> to values such as '''100000000'''<small>b</small> or '''250000000'''<small>b</small>. Make sure to use sensible values as absurd values like '''999999999''' are not going to work correctly. When DLC is enabled, the game looks inside the <code>Additional</code> folder to load HD GI, the parameter for it is named <code>g_Xbox360LimitSizeWithAdditional</code>, which you also should try to increase.		<code>Terrain.prm.xml</code> likely requires memory sizes to be higher. To fix this, edit <code>g_LimitSize</code> under <code>DynamicLoad</code> and <code>GI-Texture</code> to values such as '''100000000'''<small>b</small> or '''250000000'''<small>b</small>. Make sure to use sensible values as absurd values like '''999999999''' are not going to work correctly. When DLC is enabled, the game looks inside the <code>Additional</code> folder to load HD GI, the parameter for it is named <code>g_Xbox360LimitSizeWithAdditional</code>, which you also should try to increase.

			<hr>
	=== Sonic Generations ===		=== Sonic Generations ===

Line 97:		Line 99:
	Your game might crash randomly when booting your level if the level's light field (.lft) file is too large. Try increasing the minimum cell radius in HedgeGI to reduce the light field's file size.		Your game might crash randomly when booting your level if the level's light field (.lft) file is too large. Try increasing the minimum cell radius in HedgeGI to reduce the light field's file size.

			<hr>
	=== Sonic Unleashed ===		=== Sonic Unleashed ===

Line 102:		Line 105:
	Unleashed uses V1 materials while Generations uses V3. If you try to load a V3 material in Unleashed, it'll crash. Check the version in a hex editor (7th byte), or look for <code>.texset</code>/<code>.texture</code>, those usually mean it's V1.		Unleashed uses V1 materials while Generations uses V3. If you try to load a V3 material in Unleashed, it'll crash. Check the version in a hex editor (7th byte), or look for <code>.texset</code>/<code>.texture</code>, those usually mean it's V1.

			<hr>
	=== Sonic Generations ===		=== Sonic Generations ===

NextinHKRY: Formatting fixes

2025-05-02T18:45:33Z

Formatting fixes

Show changes

Skyth at 18:03, 2 May 2025

2025-05-02T18:03:13Z

← Older revision		Revision as of 18:03, 2 May 2025
Line 15:		Line 15:
	You might need <code>@LYR(trans)</code> or <code>@LYR(punch)</code> tags on your material names. See the [[How To Import Custom Terrain in Sonic Generations/Sonic Unleashed\|terrain importing guide]] for more info.		You might need <code>@LYR(trans)</code> or <code>@LYR(punch)</code> tags on your material names. See the [[How To Import Custom Terrain in Sonic Generations/Sonic Unleashed\|terrain importing guide]] for more info.

	Your texture might be compressed using <code>BC1</code>/<code>DXT1</code>, which ~~doesn’t~~ support alpha channels. Use <code>BC3</code>/<code>DXT5</code> instead.		Your texture might be compressed using <code>BC1</code>/<code>DXT1</code>, which doesn't support alpha channels. Use <code>BC3</code>/<code>DXT5</code> instead.

	=== Missing Terrain Models ===		=== Missing Terrain Models ===
Line 34:		Line 34:

	=== Red Materials (Sonic Generations) ===		=== Red Materials (Sonic Generations) ===
	This happens when a material points to a shader that ~~doesn’t~~ exist. To see all available shaders, unpack <code>shader_r_add.ar.00</code> inside <code>bb3.cpk</code> and check for <code>.shader-list</code> files.		This happens when a material points to a shader that doesn't exist. To see all available shaders, unpack <code>shader_r_add.ar.00</code> inside <code>bb3.cpk</code> and check for <code>.shader-list</code> files.

	=== Invisible Materials (Sonic Unleashed) ===		=== Invisible Materials (Sonic Unleashed) ===
	This happens when a material points to a shader that ~~doesn’t~~ exist. To see all available shaders, unpack <code>shader.ar</code> in the base game directory and check for <code>.shader-list</code> files.		This happens when a material points to a shader that doesn't exist. To see all available shaders, unpack <code>shader.ar</code> in the base game directory and check for <code>.shader-list</code> files.

	=== Low Quality or Missing GI Textures ===		=== Low Quality or Missing GI Textures ===
Line 80:		Line 80:

	=== Missing Material Files ===		=== Missing Material Files ===
	Unlike newer games, missing materials can crash Generations/Unleashed. For Sonic Unleashed, only having the <code>.material</code> file ~~isn’t~~ enough, you also need the matching <code>.texset</code> and <code>.texture</code> files.		Unlike newer games, missing materials can crash Generations/Unleashed. For Sonic Unleashed, only having the <code>.material</code> file isn't enough, you also need the matching <code>.texset</code> and <code>.texture</code> files.

	=== Incorrect Material Format (Sonic Unleashed) ===		=== Incorrect Material Format (Sonic Unleashed) ===
	Unleashed uses V1 materials while Generations uses V3. If you try to load a V3 material in Unleashed, ~~it’ll~~ crash. Check the version in a hex editor (7th byte), or look for <code>.texset</code>/<code>.texture</code>, those usually mean it's V1.		Unleashed uses V1 materials while Generations uses V3. If you try to load a V3 material in Unleashed, it'll crash. Check the version in a hex editor (7th byte), or look for <code>.texset</code>/<code>.texture</code>, those usually mean it's V1.

	=== Periods in File Names ===		=== Periods in File Names ===
	File names with extra periods break stuff. For example, <code>Material.000.material</code> gets read as <code>.000.material</code>, and the game ~~won’t~~ recognize it properly.		File names with extra periods break stuff. For example, <code>Material.000.material</code> gets read as <code>.000.material</code>, and the game won't recognize it properly.

	=== Instance Names Starting with "ins" ===		=== Instance Names Starting with "ins" ===