Editing 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.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Packfile|Packfile]]
|Compressed archive containing most other resources.
|.pac
|Packfile
|
* [[Tools/HedgeArcPack|HedgeArcPack]]
|-
|[[Resources/Packfile Info|Packfile Info]]
|Contains information about a packfile.
|
|PackfileInfo
|
|-
|[[Resources/Packfile Extended Info|Packfile Extended Info]]
|Contains extended information about a packfile.
|
|PackfileExtendedInfo
|
|-
|[[Resources/Depend|Depend]]
|Stores information about packfile dependencies.
|.pac.d
|ResDepend
|N/A
|-
|[[Resources/Pac General|Pac General]]
|
|
|ResPacGeneral
|
|-
|[[Resources/Virtual Archive|Virtual Archive]]
|
|
|VirtualArchive
|
|-
|AR File
|Archive containing resources.
|.ar
|
|
* [[Tools/HedgeArcPack|HedgeArcPack]]
|-
|ARL File
|Link file containing data on what each .ar file stores and its appropriate splits.
|.arl
|
|
* [[Tools/HedgeArcPack|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.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Level|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
|-
|[[Resources/Master Level|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
|
* [[Tools/KnuxTools|KnuxTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
|}

== Configuration Parameters ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Reflection|Reflection]]
|Reflection-enabled configuration data. Contains parameters that can be edited by developers without changing game code.
|.rfl
|ResReflection
|
* [[Tools/DevTools|DevTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/010 Editor Binary Templates|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.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/ObjectWorld / GEdit|ObjectWorld / GEdit]]
|Object placement and parameter data (HE2).
|.gedit
|ResObjectWorld
|
* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/DevTools|DevTools]]
* [[Tools/HedgeSet|HedgeSet]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
|-
|[[Resources/Orca: Set Object|Orca: Set Object]]
|Object placement and parameter data (HE1).
|.orc
|ResOrcaData
|
* [[Tools/HedgeEdit|HedgeEdit]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/GLVL|GLVL]]
|}

== Gismos ==
Gismos are small reusable objects (that can potentially have physics applied) intended usually for decoration.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Gismo Config Design|Gismo Config Design]]
|Defines the properties of gismo objects.
|.gismod
|ResGismoConfigDesign
|
* [[Tools/KnuxTools|KnuxTools]]
|-
|[[Resources/Gismo Config Plan|Gismo Config Plan]]
|
|.gismop
|ResGismoConfigPlan
|
* [[Tools/KnuxTools|KnuxTools]]
|}

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

== Textures ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Texture|Texture]]
|2D textures for model skinning.
|.dds
|ResTexture
|
* [https://developer.nvidia.com/texture-tools-exporter nVidia Texture Tools Exporter]
* DirectX texconv
* [https://www.gimp.org/ GIMP (cannot read BC7)]
* [https://www.getpaint.net/ Paint.NET]
|-
|[[Resources/Streaming Texture|Streaming Texture]]
|Streamed 2D textures.
|
|ResStreamingTexture
|
|-
|[[Resources/Streaming Texture Package|Streaming Texture Package]]
|A list of 2D texture data for streaming
|.ntsp
|ResTextureStreamingPackage
|
* [[Tools/NeedleTextureStreamingUtility|NeedleTextureStreamingUtility]]
|}

== Materials ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Material|Material]]
|Material information. Contains shader parameters and texture names.
|.material
|ResMaterial
|
* [[Tools/HedgeEdit|HedgeEdit]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/HEIO|HEIO]]
|-
|[[Resources/Terrain Material|Terrain Material]]
|Terrain material information.
|.terrain-material
|ResTerrainMaterial
|
* [[Tools/KnuxTools|KnuxTools]]
|-
|[[Material (Unleashed)|Material]]
|Contains shader information and texset resource information.
|.material
|
|
* [[Tools/HedgeEdit|HedgeEdit]]
|-
|Texture
|Contains parameter information for texture files linked to a material.
|.texture
|
|
* [[Tools/HedgeEdit|HedgeEdit]]
|-
|Texset
|Contains groupings of textures linked to a material.
|.texset
|
|
* [[Tools/HedgeEdit|HedgeEdit]]
|}

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

== Lighting ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/MIRAGE Light|MIRAGE Light]]
|MIRAGE point lights.
|.light
|ResMirageLight
|
|-
|[[Resources/MIRAGE Lightfield|MIRAGE Lightfield]]
|MIRAGE light field data.
|.lft
|ResMirageLightField
|
|-
|[[Resources/SH Lightfield|SH Lightfield]]
|Spherical harmonics based light field data.
|.lf
|ResSHLightField
|
* [[Tools/KnuxTools|KnuxTools]]
|-
|[[Resources/Probe|Probe]]
|IBL probe data.
|.probe
|ResProbe
|
|-
|[[Resources/Light Pointcloud|Light Pointcloud]]
|Instance placement information for point lights.
|.pcrt
|ResPointcloudLight
|
* [[Tools/KnuxTools|KnuxTools]]
* [[Tools/AshDumpTool|AshDumpTool]]
|}

== FxCol ==
FxCol defines collision shapes in the game world that can apply post processing effects when the player walks through them.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/FxColFile2|FxColFile2]]
|FxCol configuration.
|.fxcol
|ResFxColFile2
|
* [[Tools/DevTools|DevTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
|}

== SvCol ==
SvCol defines collision shapes in the game world that control sector visibility (a form of culling).
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/SvCol2|SvCol2]]
|SvCol configuration.
|.svcol
|ResSvCol2
|
* [[Tools/KnuxTools|KnuxTools]]
|}

== Effects ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Cyan Effect|Cyan Effect]]
|Particle effect systems.
|.cemt
|ResEffect
|
* [[Tools/CEMT Color Editing Tool|CEMT Color Editing Tool]]
|-
|[[Resources/Particle Location|Particle Location]]
|Database of particle effects with transform values and sounds
|.effdb
|ResParticleLocation
|
* [[Tools/AshDumpTool|AshDumpTool]] 
|}

== Physics ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Bullet Mesh|Bullet Mesh]]
|Bullet physics engine mesh. Used for collision detection.
|.btmesh
|ResPhysicsMesh
|
* [[Tools/btmesh|btmesh]]
* [[Tools/HEIO|HEIO]]
|-
|[[Resources/Bullet Soft Body|Bullet Soft Body]]
|Bullet physics engine soft body.
|.btsb
|ResSoftBody
|
|-
|[[Resources/Bullet Skinned Mesh Collider|Bullet Skinned Mesh Collider]]
|Bullet physics engine skinned mesh collider. Not exactly known what this is currently.
|.btsmc
|ResSkinnedMeshCollider
|
|-
|[[Resources/Collision Pointcloud|Collision Pointcloud]]
|Instance placement info for collision meshes.
|.pccol
|ResPointCloudCollision
|
* [[Tools/KnuxTools|KnuxTools]] 
* [[Tools/AshDumpTool|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.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Orca: Spline Path|Orca: Spline Path]]
|Contains path information.
|.path.bin
|ResSplinePath
|
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
|-
|[[Resources/Orca: Spline Path 2|Orca: Spline Path 2]]
|Contains path information.
|.path2.bin
|ResSplinePath2
|
* [[Tools/KnuxTools|KnuxTools]]

|-
|[[Resources/Path|Path]]
|Contains path information.
|.path
|ResSplinePath
|
* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/KnuxTools|KnuxTools]]

|}

== Occlusion Capsule ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Occlusion Capsule|Occlusion Capsule]]
|Occlusion capsules
|.occ
|ResOcclusionCapsule
|}

== Atmosphere ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Atmospheric Fog|Atmospheric Fog]]
|Atmospheric fog data.
|?
|ResAtmosphericFog
|}

== Density (vegetation) ==
Density is HE's GPU based vegetation system.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Density Setting|Density Setting]]
|Configures the Hedgehog Engine density system. Configures all the density system's parameters and references density models.
|.densitysetting
|ResDensitySetting
|
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
|-
|[[Resources/Density Point Cloud|Density Point Cloud]]
|Placement of pre-baked density models.
|.densitypointcloud
|ResDensityPointCloud
|
* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
|-
|[[Resources/Density Instance|Density Instance]]
|
|
|ResDensityInstance
|
|-
|[[Resources/Terrain Grass Info|Terrain Grass Info]]
|
|.grass.bin
|ResTerrainGrassInfo
|
|}

== NavMesh ==
Navmeshes are meshes that the game's AI actors can use to navigate the map.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/NavMesh Config|NavMesh Config]]
|Navmesh configuration
|.nmc
|ResNavMeshConfig
|
|-
|[[Resources/NavMesh Tile|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.
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/AI State Machine|AI State Machine]]
|Configuration for the AI State Machine
|.aism
|ResAIStateMachine
|[[Tools/010 Editor Binary Templates|AshDump]]
|}

== Cinematics ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Scene|Scene]]
|Legacy cinematics system.
|.scene
|ResScene
|
* [[Tools/DevTools|DevTools]]
|-
|[[Resources/DvScene|DvScene]]
|Cinematics.
|.dvscene
|ResDvScene
|
* [[Tools/010 Editor Binary Templates|010 Editor Binary Templates]]
* [[Tools/DevTools|DevTools]]
* [[Tools/DvSceneTool|DvSceneTool]]
|-
|[[Resources/USM|USM]]
|CRIware's video format
|.usm
|
|
|}

== Decals ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Decal|Decal]]
|Decals. Referenced in FxColManager.
|?
|ResDecal
|
|-
|[[Resources/Decal Pointcloud|Decal Pointcloud]]
|Placement information for decal instances. Referenced in FxColManager.
|?
|ResDecalPointcloud
|
|}

== Shaders ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Vertex Shader|Vertex Shader]]
|Vertex shaders.
|.vso
|ResVertexShader
|
|-
|[[Resources/Pixel Shader|Pixel Shader]]
|Pixel shaders.
|.pso
|ResFragmentShader
|
|-
|[[Resources/Compute Shader|Compute Shader]]
|Compute shaders
|.cso
|ResComputeShader
|
|-
|[[Resources/Shader List|Shader List]]
|List of shaders.
|.shader-list
|ResShaderList
|
|}

== Audio ==
{| class="wikitable"
!Name
!Description
!Extension
!Engine name
!Editing tools
|-
|[[Resources/Atom Config|Atom Config]]
|CRIware Atom configuration data.
|.acf
|ResAtomConfig
|
|-
|[[Resources/Atom Cue Sheet|Atom Cue Sheet]]
|CRIware Atom cue sheet. Contains the game's audio and cue/AISAC information.
|.acb
|ResAtomCueSheet
|
* [[Tools/KwasTools|KwasTools]] (cri_utf_tool)
* [[Tools/SonicAudioTools|SonicAudioTools]] (Deprecated)
* [[Tools/Eternity Audio Tool|Eternity Audio Tool]] (Outdated)
|}

== UI ==
{| class="wikitable"
!Name
!Description
!Extension
!Engine name
!Editing tools
|-
|[[Resources/SurfRide SWIF|SurfRide SWIF]]
|Describes UI layout and animations. Similar to a primitive version of Adobe Flash.
|.swif
|ResSurfRideProject
|
* [[Tools/DevTools|DevTools]]
* [[Tools/010 Editor Binary Templates|010 Editor Binary Templates]]
|}

== Scripting ==
{| class="wikitable"
!Name
!Description
!Extension
!Engine name
!Editing tools
|-
|[[Resources/Lua|Lua]]
|A Lua script.
|.lua
|ResLuaData
|
* Any text editor
|}

== Haptics ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Vibration|Vibration]]
|Haptics vibration information.
|.vib
|ResVibration
|
* [[Tools/DevTools|DevTools]]
|}

== Clipmap ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Clipmap Ocean|Clipmap Ocean]]
|
|.cob
|ResClipmapOcean
|
|}

== Localization ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Converse Project|Converse Project]]
|Localization project data.
|.cnvrs-proj
|ResTextProject
|
* [[Tools/Converse Editor|Converse Editor]]
|-
|[[Resources/Converse Text|Converse Text]]
|Localization text data.
|.cnvrs-text
|ResText
|
* [[Tools/Puyo Text Editor|Puyo Text Editor]]
* [[Tools/Converse Editor|Converse Editor]]
|-
|[[Resources/Converse Meta|Converse Meta]]
|Localization metadata.
|.cnvrs-meta
|ResTextMeta
|
* [[Tools/Converse Editor|Converse Editor]]
|}

== Fonts ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Bitmap Font|Bitmap Font]]
|Bitmap fonts.
|.bfnt
|ResBitmapFont
|
|-
|[[Resources/Scalable Font Set|Scalable Font Set]]
|Vector fonts.
|.scfnt
|ResScalableFontSet
|
|-
|[[Resources/Optical Kerning|Optical Kerning]]
|Information about optical text kerning.
|.okern
|ResOpticalKerning
|
|}

== Unicode ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/ICU data|ICU data]]
|Data for libicu (unicode library)
|.icu
|ResIcuData
|
|}

== Acceleration Structures ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/K-D Tree|K-D Tree]]
|A serialized [[wikipedia:K-d_tree|k-d tree]]. This resource has only been seen as a runtime resource in the engine or embedded in [[Resources/Path|Path]] resources.
|N/A
|ResKdTree
|
|}

== Unknown ==
{| class="wikitable"
! Name !! Description
!Extension
!Engine name!! Editing tools
|-
|[[Resources/Name Extra|Name Extra]]
|
|.nextra
|ResNameExtra
|
|-
|[[Resources/Pointcloud|Pointcloud]]
|
|.pointcloud
|ResPointcloud
|
|}