Resources

Resources are the data files that contain things like 3D models, textures, animations and any other kind of assets. Many of these resources are stored in proprietary formats optimized for fast loading times, and thus require special tools to be edited by modders. Many of them are also built using proprietary SEGA technologies, like the ASM animation system. On this page we provide a list of all known resources supported by the Hedgehog Engine, their support in various games and tools that can be used to edit them.

Archives

Archives are compressed archives ("zip files") that contain most of the game's data.

Name	Description	Extension	Engine name	Editing tools
Packfile	Compressed archive containing most other resources.	.pac	Packfile	HedgeArcPack
Packfile Info	Contains information about a packfile.		PackfileInfo
Packfile Extended Info	Contains extended information about a packfile.		PackfileExtendedInfo
Depend	Stores information about packfile dependencies.	.pac.d	ResDepend	N/A
Pac General			ResPacGeneral
Virtual Archive			VirtualArchive
AR File	Archive containing resources.	.ar		HedgeArcPack
ARL File	Link file containing data on what each .ar file stores and its appropriate splits.	.arl		HedgeArcPack

Levels

Levels are a new system in Sonic Frontiers and up that allow the game to dynamically load other resources when they are needed. They specify which resources need to be loaded to load a certain "level". This is a system similar to Unreal Engine's level system.

Name	Description	Extension	Engine name	Editing tools
Level	A special resource that's only used to check whether a level has been loaded in the engine. It does not contain any data.	.level	ResLevel	N/A
Master Level	Information about levels: which levels depend on each other, and also which resources to load in order to load a level.	.mlevel	ResMasterLevel	KnuxTools Restoration Issue Pocketknife

Configuration Parameters

Name	Description	Extension	Engine name	Editing tools
Reflection	Reflection-enabled configuration data. Contains parameters that can be edited by developers without changing game code.	.rfl	ResReflection	DevTools Restoration Issue Pocketknife 010 Editor Binary Templates

Set Objects

Set object data is what specifies where game objects are placed and how they are configured. This is what you'll be editing most when making a stage mod.

Name	Description	Extension	Engine name	Editing tools
ObjectWorld / GEdit	Object placement and parameter data (HE2).	.gedit	ResObjectWorld	Blendhog Level Creator DevTools HedgeSet Restoration Issue Pocketknife
Orca: Set Object	Object placement and parameter data (HE1).	.orc	ResOrcaData	HedgeEdit Restoration Issue Pocketknife GLVL

Gismos

Gismos are small reusable objects (that can potentially have physics applied) intended usually for decoration.

Name	Description	Extension	Engine name	Editing tools
Gismo Config Design	Defines the properties of gismo objects.	.gismod	ResGismoConfigDesign	KnuxTools
Gismo Config Plan		.gismop	ResGismoConfigPlan	KnuxTools

Models

Name	Description	Extension	Engine name	Editing tools
Model	Contains 3D model information (also contains an armature).	.model	ResModel	ModelConverter modelfbx HEIO
Terrain Model	Contains 3D model information specifically for terrain models. Similar to "Model" but does not contain an armature.	.terrain-model	ResTerrainModel	Blendhog Level Creator ModelConverter modelfbx HEIO
Heightfield	Height field maps.	.heightfield	ResHeightField	HeightFielder
Model Pointcloud	Placement information for model or terrain model instances.	.pcmodel	ResPointcloudModel	Blendhog Level Creator KnuxTools Restoration Issue Pocketknife
Orca: Map	Placement information for model or terrain model instances.	.map.bin	ResDivMap	KnuxTools
MIRAGE Model Instance Info	Contains information about model instances.	.model-instanceinfo	ResMirageModelInstanceInfo
MIRAGE Terrain Instance Info	Contains information about terrain model instances.	.terrain-instanceinfo	ResMirageTerrainInstanceInfo	KnuxTools
Vertex Link Info		.vli	ResVertexLinkInfo
MetaTerrainInstance	A file containing model and lightfield data capable of animating, commonly used for grass and clouds.	.mti

Textures

Name	Description	Extension	Engine name	Editing tools
Texture	2D textures for model skinning.	.dds	ResTexture	nVidia Texture Tools Exporter DirectX texconv GIMP (cannot read BC7) Paint.NET
Streaming Texture	Streamed 2D textures.		ResStreamingTexture
Streaming Texture Package	A list of 2D texture data for streaming	.ntsp	ResTextureStreamingPackage	NeedleTextureStreamingUtility

Materials

Name	Description	Extension	Engine name	Editing tools
Material	Material information. Contains shader parameters and texture names.	.material	ResMaterial	HedgeEdit Restoration Issue Pocketknife HEIO
Terrain Material	Terrain material information.	.terrain-material	ResTerrainMaterial	KnuxTools
Material	Contains shader information and texset resource information.	.material		HedgeEdit
Texture	Contains parameter information for texture files linked to a material.	.texture		HedgeEdit
Texset	Contains groupings of textures linked to a material.	.texset		HedgeEdit

Animations

All kinds of animation data.

Name	Description	Extension	Engine name	Editing tools
PXD Skeleton	Skeleton for PXD animations.	.skl.pxd	ResSkeletonPxd	Sonic Frontiers Animation Tools
PXD Animation	Animation data.	.anm.pxd	ResAnimationPxd	Sonic Frontiers Animation Tools
PBA Skeleton	Skeleton for physics based animations.	.pba	ResPhysicalSkeleton	DevTools
Animation State Machine	Animation State Machine data. Handles animation blending, animation states, animation triggers, etc.	.asm	ResAnimator	DevTools Restoration Issue Pocketknife
HelperBone	Currently unknown.	.helperbone.bin	ResHelperBone
Material Animation	Material animations.	.mat-anim	ResAnimMaterial	KwasTools (he_anim_tool)
UV Animation	Texture UV animations (presumably Wii SRT0).	.uv-anim	ResAnimTexSrt	KwasTools (he_anim_tool)
Texture Pattern Animation	Texture pattern animations (presumably Wii PAT0).	.pt-anim	ResAnimTexPat	KwasTools (he_anim_tool)
Visibility Animation	Bone visibility animations (presumably Wii VIS0).	.vis-anim	ResAnimVis	KwasTools (he_anim_tool)
Camera Animation	Camera animations.	.cam-anim	ResAnimCameraContainer	KwasTools (he_anim_tool)
Light Animation	Light animations.	.lit-anim	ResAnimLightContainer	KwasTools (he_anim_tool)
Vertex Animation Texture	Vertex animation textures (textures that efficiently encode large scale animations on vertices).	.vat	ResVertexAnimationTexture	Restoration Issue Pocketknife
Havok Skeleton	Skeleton for Havok Animations	.skl.hkx
Havok Animation	Animation data.	.anm.hkx

Lighting

Name	Description	Extension	Engine name	Editing tools
MIRAGE Light	MIRAGE point lights.	.light	ResMirageLight
MIRAGE Lightfield	MIRAGE light field data.	.lft	ResMirageLightField
SH Lightfield	Spherical harmonics based light field data.	.lf	ResSHLightField	KnuxTools
Probe	IBL probe data.	.probe	ResProbe
Light Pointcloud	Instance placement information for point lights.	.pcrt	ResPointcloudLight	KnuxTools AshDumpTool

FxCol

FxCol defines collision shapes in the game world that can apply post processing effects when the player walks through them.

Name	Description	Extension	Engine name	Editing tools
FxColFile2	FxCol configuration.	.fxcol	ResFxColFile2	DevTools Restoration Issue Pocketknife

SvCol

SvCol defines collision shapes in the game world that control sector visibility (a form of culling).

Name	Description	Extension	Engine name	Editing tools
SvCol2	SvCol configuration.	.svcol	ResSvCol2	KnuxTools

Effects

Name	Description	Extension	Engine name	Editing tools
Cyan Effect	Particle effect systems.	.cemt	ResEffect	CEMT Color Editing Tool
Particle Location	Database of particle effects with transform values and sounds	.effdb	ResParticleLocation	AshDumpTool

Physics

Name	Description	Extension	Engine name	Editing tools
Bullet Mesh	Bullet physics engine mesh. Used for collision detection.	.btmesh	ResPhysicsMesh	btmesh HEIO
Bullet Soft Body	Bullet physics engine soft body.	.btsb	ResSoftBody
Bullet Skinned Mesh Collider	Bullet physics engine skinned mesh collider. Not exactly known what this is currently.	.btsmc	ResSkinnedMeshCollider
Collision Pointcloud	Instance placement info for collision meshes.	.pccol	ResPointCloudCollision	KnuxTools AshDumpTool

Paths

Paths are 3D splines that the game engine uses for various tasks, e.g. to generate grind rails, calculate projectile movements, generate replicated objects and keep the player on a 2D rail.

Name	Description	Extension	Engine name	Editing tools
Orca: Spline Path	Contains path information.	.path.bin	ResSplinePath	Restoration Issue Pocketknife
Orca: Spline Path 2	Contains path information.	.path2.bin	ResSplinePath2	KnuxTools
Path	Contains path information.	.path	ResSplinePath	Blendhog Level Creator Restoration Issue Pocketknife KnuxTools

Occlusion Capsule

Name	Description	Extension	Engine name	Editing tools
Occlusion Capsule	Occlusion capsules	.occ	ResOcclusionCapsule

Atmosphere

Name	Description	Extension	Engine name	Editing tools
Atmospheric Fog	Atmospheric fog data.	?	ResAtmosphericFog

Density (vegetation)

Density is HE's GPU based vegetation system.

Name	Description	Extension	Engine name	Editing tools
Density Setting	Configures the Hedgehog Engine density system. Configures all the density system's parameters and references density models.	.densitysetting	ResDensitySetting	Restoration Issue Pocketknife
Density Point Cloud	Placement of pre-baked density models.	.densitypointcloud	ResDensityPointCloud	Blendhog Level Creator
Density Instance			ResDensityInstance
Terrain Grass Info		.grass.bin	ResTerrainGrassInfo

NavMesh

Navmeshes are meshes that the game's AI actors can use to navigate the map.

Name	Description	Extension	Engine name	Editing tools
NavMesh Config	Navmesh configuration	.nmc	ResNavMeshConfig
NavMesh Tile	Navmesh tile	.nmt	ResNavMeshTile
Navigation Mesh	Navigation mesh map	.navi.xml / .navi.xmlbin	NavigationMesh

AI State Machine

The AI state machine controls AI behavior of enemies in game.

Name	Description	Extension	Engine name	Editing tools
AI State Machine	Configuration for the AI State Machine	.aism	ResAIStateMachine	AshDump

Cinematics

Name	Description	Extension	Engine name	Editing tools
Scene	Legacy cinematics system.	.scene	ResScene	DevTools
DvScene	Cinematics.	.dvscene	ResDvScene	010 Editor Binary Templates DevTools DvSceneTool
USM	CRIware's video format	.usm

Decals

Name	Description	Extension	Engine name	Editing tools
Decal	Decals. Referenced in FxColManager.	?	ResDecal
Decal Pointcloud	Placement information for decal instances. Referenced in FxColManager.	?	ResDecalPointcloud

Shaders

Name	Description	Extension	Engine name	Editing tools
Vertex Shader	Vertex shaders.	.vso	ResVertexShader
Pixel Shader	Pixel shaders.	.pso	ResFragmentShader
Compute Shader	Compute shaders	.cso	ResComputeShader
Shader List	List of shaders.	.shader-list	ResShaderList

Audio

Name	Description	Extension	Engine name	Editing tools
Atom Config	CRIware Atom configuration data.	.acf	ResAtomConfig
Atom Cue Sheet	CRIware Atom cue sheet. Contains the game's audio and cue/AISAC information.	.acb	ResAtomCueSheet	KwasTools (cri_utf_tool) SonicAudioTools (Deprecated) Eternity Audio Tool (Outdated)

UI

Name	Description	Extension	Engine name	Editing tools
SurfRide SWIF	Describes UI layout and animations. Similar to a primitive version of Adobe Flash.	.swif	ResSurfRideProject	DevTools 010 Editor Binary Templates

Scripting

Name	Description	Extension	Engine name	Editing tools
Lua	A Lua script.	.lua	ResLuaData	Any text editor

Haptics

Name	Description	Extension	Engine name	Editing tools
Vibration	Haptics vibration information.	.vib	ResVibration	DevTools

Clipmap

Name	Description	Extension	Engine name	Editing tools
Clipmap Ocean		.cob	ResClipmapOcean

Localization

Name	Description	Extension	Engine name	Editing tools
Converse Project	Localization project data.	.cnvrs-proj	ResTextProject	Converse Editor
Converse Text	Localization text data.	.cnvrs-text	ResText	Puyo Text Editor Converse Editor
Converse Meta	Localization metadata.	.cnvrs-meta	ResTextMeta	Converse Editor

Fonts

Name	Description	Extension	Engine name	Editing tools
Bitmap Font	Bitmap fonts.	.bfnt	ResBitmapFont
Scalable Font Set	Vector fonts.	.scfnt	ResScalableFontSet
Optical Kerning	Information about optical text kerning.	.okern	ResOpticalKerning

Unicode

Name	Description	Extension	Engine name	Editing tools
ICU data	Data for libicu (unicode library)	.icu	ResIcuData

Acceleration Structures

Name	Description	Extension	Engine name	Editing tools
K-D Tree	A serialized k-d tree. This resource has only been seen as a runtime resource in the engine or embedded in Path resources.	N/A	ResKdTree

Unknown

Name	Description	Extension	Engine name	Editing tools
Name Extra		.nextra	ResNameExtra
Pointcloud		.pointcloud	ResPointcloud