Unleashed-Generations Havok Collision Attributes

Sonic Unleashed and Sonic Generations have several collision tags that they use to determine the type of terrain, its properties, and what can collide with what else. These attributes can be applied to .hkx files with Havok Converter. To learn how to apply these tags to collision meshes, check out Adding Collision Tags with Havok Converter.

Material Type

swa_attribute (1260399450)

Index	Type	Notes
0	Unknown
1	Normal	This plays Concrete footstep sounds
2	DeepWater	Requires Convex Hull meshes
3	Rock	This also plays Concrete footstep sounds
4	Dirt
5	Wood
6	Grass
7	Snow	This requires an extra file to be added in Generations, add a file called ef_ch_sns_yh1_smoke_snow.dds to prevent it from crashing the game
8	Metal
9	Sand	Generations will play Concrete sound effects instead
10	Glass
11	ShallowWater	Sonic can walk inside the collision with @Water in the name, otherwise he can only walk on the collision
12	Dead	Kills the player if touched
13	Damage
14	NoDeadWater	Water that doesn't make you drown, use Box or Convex Hull meshes in Generations
15	NoEffect	Will play no footsteps or emit any particles in Unleashed In Generations this will still play footstep sounds
16	Oil	Only in Generations
17	PinballGlass	Only in Generations, used in Casino Night Zone
18	WrongWay	Only in Generations
19	Lava	Only in Generations
20	Poison	Only in Generations

Collision Properties

Most of the parameters here are boolean parameters, with 0 value indicating it's disabled, and 1 indicating it's enabled.

Parameter Name	ID	Description
swa_evil_isbalance_ground	122999549	This is used for the Werehog to detect if he should start balancing on a tight strip, and its also used for Classic Sonic to detect where a ledge is.
swa_isIce_ground	246659335	If enabled, this'll make the ground slippery (like in Holoska in Sonic Unleashed). This requires some extra files to be present to make it work; if these files are missing, the game will crash when the collision is touched by the player.
swa_col_other	620872783	If enabled, anything that isn't the player or the camera will collide with the object.
intersectional_way	1009866916	Generations only, used in Casino Night Zone.
swa_sonic_isbeltconveyor	1196263925	Used for the BeltConveyorCollision object in Generations and the Egg_BeltCollision/Egg_BeltCollisionSV objects in Unleashed, the value of this field is the speed of the conveyor belt.
swa_sonic_isplayerwall	1368296714	Used to indicate if a surface can be used for wall-jumping.
swa_col_specific	1330259859	This is set to 1 by default, setting it to 2 or 3 will make the IKs for Sonic adjust to the terrain.
swa_col_attacking	1651585625
swa_col_camera	1706239430	If enabled, the camera will collide with this object.
pinball_glass	2040148113	Generations only, used in Casino Night Zone.
swa_col_player	2088238466	If enabled, the player will collide with the object.

Mesh Name Tags

Rigid bodies can have custom properties that are detected by the game itself to determine their interactions with other objects. These tags are added at the end of mesh names with an @ symbol as the separator (e.g. ghz_sea@Water). These properties are Case-Sensitive.

Name	Notes
@Balance	Unleashed only
@DamageFall
@DisableThrowColl
@DisableTemColl
@EnableQtoW / @enableQtoW	Generations only
@Spiral / @spiral	Generations only
@Slide	Requires a path with an ID of 888 to be present in the stage.
@NoStanding
@NoCamera	Allows the camera to pass through the collision mesh
@IceGround
@Water	Allows Sonic to go inside the collision mesh when using ShallowWater type

Collision Shapes

Havok Converter allows you to specify the shape of your collision meshes by appending tags to their names. By default, rigid bodies are created as mesh shapes, which might be incompatible with certain properties such as @Water. This is where you need to pick a collision shape that fits your use case. These tags are Case-Sensitive.

Name	Notes
@CONVEX(true)	Convex Hull mesh, most recommended outside mesh shapes
@CONVEX(1)	Same as @CONVEX(true) but shorter way of specifying it
@BOX	Axis aligned box that covers the whole mesh
@SPHERE	Largest sphere that covers the whole mesh
@CYLINDER	Axis aligned cylinder
@CAPSULE	Axis aligned capsule