How To Use Sonic GLvl with Sonic Unleashed: Difference between revisions
No edit summary |
No edit summary |
||
| (9 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Notice|type=note|content=This guide covers how to setup Sonic Unleashed Xbox 360 levels in GLvl, but does not cover how to use this tool or how to set it up for PS3 levels. It's recommended that you also read the [[How To Use Sonic GLvl with Sonic Generations|Sonic Generations GLvl guide]].}}{{Notice|type=info|content=This guide uses the following tools: | {{Notice|type=note|content=This guide covers how to setup Sonic Unleashed Xbox 360 levels in GLvl, but does not cover how to use this tool or how to set it up for PS3 levels. It's recommended that you also read the [[How To Use Sonic GLvl with Sonic Generations|Sonic Generations GLvl guide]].}}{{Notice|type=info|content=This guide uses the following tools: | ||
* [[ | * [[SonicGLvl|SonicGLvl]] | ||
* [[ | * [[HedgeArcPack]]}} | ||
The latest [[SonicGLvl]] can now open Sonic Unleashed levels without needing to decompress any archive or move around files. Open a level through '''"File > Open Level"''' and select the # archive of a level of your choice. Refer to the [[Sonic Unleashed Stage IDs|Stage IDs]] page to find the level that you need. | |||
== Setting Up Shaders == | |||
To display the level with game-accurate graphics, you need to copy the '''"shader.ar"''' file from your game installation to SonicGLvl's '''"database/shaders"''' folder. SonicGLvl will warn you about this if you have not done this step. | |||
== | == Copying Files To Your Mod == | ||
If you open a level directly from the game files, you have the risk of corrupting your installation when you save your changes. It's recommended to first copy the files to a mod, and open the level from your mod directory. As an example, the files you need to copy for Windmill Isle Act 2 (Day) are as follows: | |||
* <code>Packed/ActD_MykonosAct2/Stage.pfd</code> | |||
* <code>#ActD_MykonosAct2.ar.00</code> | |||
* <code>#ActD_MykonosAct2.arl</code> | |||
* <code>ActD_MykonosAct2.ar.00</code> | |||
* <code>ActD_MykonosAct2.arl</code> | |||
The stage ID and the amount of AR files you need to copy will vary between levels. | |||
Note that if you simply want to view the levels in SonicGLvl without making any changes, opening them from the base game files is fine. This advice is for when you want to make modifications to the level. | |||
== Missing Textures == | |||
Sonic Unleashed stores stage textures in different archives to share them between levels and save space. If you open a level from your game directory, SonicGLvl will automatically extract them to its '''"cache/country_name/slot_resources"''' folder. | |||
However, if you open the level from a DLC or your mod files, and not copy over these archives, SonicGLvl won't be able to find the textures. To solve this, you can first open a level from the respective country region from the base game folder, then re-open the level from your DLC or mod directory. | |||
As an example, for Apotos, the common texture archives are named as follows: | |||
* <code>CmnActD_Terrain_Mykonos</code> | |||
* <code>CmnActN_Terrain_Mykonos</code> | |||
* <code>CmnMykonos</code> | |||
== Missing Models == | |||
SonicGLvl does not come with the game assets, so objects are going to appear as cubes. To solve this, you need to extract the relevant AR files to SonicGLvl's "database/resources" folder. Most required assets are stored in <code>SonicActionCommon/EvilActionCommon</code> archives in the base game. [[HedgeArcPack]] can be used to directly extract the archives to the resources folder. | |||
If you are unable to find the model for an object, you can open the corresponding object template from "database/objects" folder, and look for an Extra parameter with model as the type:<syntaxhighlight lang="xml"><Extra type="model" name="cmn_obj_sk2_hintring.model" /></syntaxhighlight>In this example, the HintRing object uses the <code>cmn_obj_sk2_hintring.model</code> file. You can then search for this file name in the [https://raw.githubusercontent.com/blueskythlikesclouds/SkythTools/refs/heads/master/Sonic%20Unleashed/File%20Index.txt Sonic Unleashed File Index] to find the archive it's stored in, and extract it. | |||
{{Notice|type=warn|content=If you extract SonicActionCommon_Petra, a material file with invalid characters in its file name is going to crash SonicGLvl! Make sure to remove the faulty file to make it work: ptr_sk_dart01__NSP_CMN_ChaoTexSpecNrmTanVC____NPR_XB_������__.material}}{{Notice|type=warn|content=Some Sonic Unleashed object templates are currently incorrectly configured to load Sonic Generations model names. If you have the 2011 version of Sonic Generations installed, you can extract cmn100/cmn200 to the resources folder as a temporary workaround.}} | |||
Latest revision as of 15:36, 2 May 2025
The latest SonicGLvl can now open Sonic Unleashed levels without needing to decompress any archive or move around files. Open a level through "File > Open Level" and select the # archive of a level of your choice. Refer to the Stage IDs page to find the level that you need.
Setting Up Shaders
To display the level with game-accurate graphics, you need to copy the "shader.ar" file from your game installation to SonicGLvl's "database/shaders" folder. SonicGLvl will warn you about this if you have not done this step.
Copying Files To Your Mod
If you open a level directly from the game files, you have the risk of corrupting your installation when you save your changes. It's recommended to first copy the files to a mod, and open the level from your mod directory. As an example, the files you need to copy for Windmill Isle Act 2 (Day) are as follows:
Packed/ActD_MykonosAct2/Stage.pfd#ActD_MykonosAct2.ar.00#ActD_MykonosAct2.arlActD_MykonosAct2.ar.00ActD_MykonosAct2.arl
The stage ID and the amount of AR files you need to copy will vary between levels.
Note that if you simply want to view the levels in SonicGLvl without making any changes, opening them from the base game files is fine. This advice is for when you want to make modifications to the level.
Missing Textures
Sonic Unleashed stores stage textures in different archives to share them between levels and save space. If you open a level from your game directory, SonicGLvl will automatically extract them to its "cache/country_name/slot_resources" folder.
However, if you open the level from a DLC or your mod files, and not copy over these archives, SonicGLvl won't be able to find the textures. To solve this, you can first open a level from the respective country region from the base game folder, then re-open the level from your DLC or mod directory.
As an example, for Apotos, the common texture archives are named as follows:
CmnActD_Terrain_MykonosCmnActN_Terrain_MykonosCmnMykonos
Missing Models
SonicGLvl does not come with the game assets, so objects are going to appear as cubes. To solve this, you need to extract the relevant AR files to SonicGLvl's "database/resources" folder. Most required assets are stored in SonicActionCommon/EvilActionCommon archives in the base game. HedgeArcPack can be used to directly extract the archives to the resources folder.
If you are unable to find the model for an object, you can open the corresponding object template from "database/objects" folder, and look for an Extra parameter with model as the type:
<Extra type="model" name="cmn_obj_sk2_hintring.model" />
In this example, the HintRing object uses the cmn_obj_sk2_hintring.model file. You can then search for this file name in the Sonic Unleashed File Index to find the archive it's stored in, and extract it.