HEModdingWiki - User contributions [en]

Sonic Frontiers/Internals/GOComponent

2025-12-13T13:56:35Z

Ashrindy: Usage example

== GOComponent ==
'''GOComponent''' ''(Game Object Component)'' is a component that usually has certain functionality to easily access and use systems, methods and such in a game object. GOCs are attached to '''Game Objects''', which add basic functionality or easy control over certain aspects, such as '''GOCVisualModel''' adds an easy way to show a model at the Game Objects position.

== Usage ==
Every GOComponent needs to be first created, this can be done using a simple function found in every [[Sonic Frontiers/Internals/Game Object|Game Object]]:<syntaxhighlight lang="cpp">
// CreateComponent is a function in the hh::game::GameObject class, most oftenly used in the AddCallback function
hh::game::GOCVibration* gocVibration = CreateComponent<hh::game::GOCVibration>(); // Creates the component GOCVibration for use
</syntaxhighlight>After the creation, you're able to initialize it in anyway possible, do any kind of preparation before adding it to the [[Sonic Frontiers/Internals/Game Object|Game Object]]:<syntaxhighlight lang="cpp">
// AddComponent is a function found in the hh::game::GameObject class, it's most oftenly used in the AddCallback function
AddComponent(gocVibration); // Adds the GOCVibration to the Game Object
</syntaxhighlight>Full example:<syntaxhighlight lang="cpp">
// Create the GOC
app_cmn::rfl::GOCRflParameter* gocRflParam = CreateComponent<app_cmn::rfl::GOCRflParameter>();

// GOC preparation
app_cmn::rfl::GOCRflParameter::SetupInfo gocRflParamDesc{}; // Initialize the SetupInfo struct
gocRflParamDesc.capacity = 6;
gocRflParam->Setup(gocRflParamDesc);

// Add the GOC
AddComponent(gocRflParam);
</syntaxhighlight>

== GOComponents ''(currently in rangers-sdk)'' ==

=== Animation ===

* GOCAnimation
* GOCAnimationBlend
* GOCAnimationSimple
* GOCAnimationSingle
* GOCAnimator
* GOCCharacterIk
* GOCLookAt
* GOCPhysicalAnimation

=== Boss ===

* GOCBossActionSelect
* GOCBossCyloopColliderHelper
* GOCBossMoveableRange

=== Collision ===

* GOCBoxCollider
* GOCCapsuleCollider
* GOCColliderQuery
* GOCCollisionQuery
* GOCCylinderCollider
* GOCHeightFieldCollider
* GOCMeshCollider
* GOCMoveSphereColliderQuery
* GOCSphereCollider

=== Effect ===

* GOCEffect
* GOCParticleLocator

=== Enemy ===

* GOCAI
* GOCEnemyAttackSign

=== General ===

* GOCActivator
* GOCContact
* GOCCyloopPoint
* GOCEvent
* GOCEventCollision
* GOCGravity
* GOCGrind
* GOCHealth
* GOCHitStop
* GOCNavMeshAgent
* GOCTargetPositionHelper
* GOCTransform
* GOCParamBlackboard
* GOCScript
* PathComponent

=== Graphics ===

* GOCCamera
* GOCOcclusionCapsule
* GOCPointLight
* GOCRenderTexture
* GOCVisualDebugDraw
* GOCVisualModel
* GOCVisualTransformed
* GOCVisualUserModel

=== HID ===

* GOCInput
* GOCVibration

=== Movement ===

* GOCMotor
* GOCMotorConstant
* GOCMotorOnPath
* GOCMotorRotate
* GOCMovement

=== Player ===

* GOCPlayerCollider
* GOCPlayerEffect
* GOCPlayerHsm
* GOCPlayerKinematicParams
* GOCPlayerParameter
* GOCPlayerState
* GOCPlayerVisual

=== Reflection ===

* [[Sonic Frontiers/Internals/GOCRflParameter|GOCRflParameter]]

=== Sound ===

* GOCSound

=== User Interface ===

* GOCSprite
* GOCUICollider
* GOCUIComposition

Sonic Frontiers/Internals/GOCRflParameter

2025-12-13T13:44:40Z

Ashrindy: Added GOCRflParameter Frontiers

'''GOCRflParameter''' located in the <code>app_cmn::rfl</code> namespace, is a simple [[Sonic Frontiers/Internals/GOComponent|GOComponent]] for storing and accessing [[Resources/Reflection|Reflection]] parameters through a [[Sonic Frontiers/Internals/Game Object|Game Object]].

== Usage ==
It follows the same way of creation as every other [[Sonic Frontiers/Internals/GOComponent|GOComponent]].

The struct of the SetupInfo/Description for this component is simple:<syntaxhighlight lang="cpp">
struct SetupInfo {
unsigned int capacity; // The amount of parameters that are going to be used at first
};
</syntaxhighlight>This leads to the setup in general being primitive, as all that's needed is to provide the amount of parameters that are gonna be stored at first.<syntaxhighlight lang="cpp">
app_cmn::rfl::GOCRflParameter::SetupInfo gocRflParamDesc{}; // Initialize the SetupInfo/Description struct

gocRflParamDesc.capacity = 6; // Specify the amount of parameters that are gonna be used at first

gocRflParam->Setup(gocRflParamDesc); // This sets up the GOComponent for proper usage
</syntaxhighlight>Afterwards, you are able to add your [[Resources/Reflection|Reflection]] parameters.<syntaxhighlight lang="cpp">
hh::fnd::ResReflection* myRefl; // Get or create your Reflection info

gocRflParam->SetParameter(myRefl, 0); // Set the Reflection info to an index, that is then going to be used to access the parameter

</syntaxhighlight>To get the [[Resources/Reflection|Reflection]] parameters.<syntaxhighlight lang="cpp">
MyReflStruct* myRefl = gocRflParam->GetParameter<MyReflStruct>(0); // Get the parameter at index 0 as MyReflStruct
</syntaxhighlight>

Sonic Frontiers/Internals/GOCRflParameter

2025-12-13T13:02:14Z

Ashrindy:

Sonic Frontiers/Internals/GOComponent

2025-12-13T13:00:41Z

Ashrindy: /* Reflection */

Sonic Frontiers/Internals/GOCRflParameter

2025-12-13T13:00:06Z

Ashrindy: Created page with "**GOCRflParameter** located in the `app_cmn::rfl` namespace, is a simple GOComponent for storing and accessing Reflection parameters through a Game Object."

**GOCRflParameter** located in the `app_cmn::rfl` namespace, is a simple GOComponent for storing and accessing Reflection parameters through a Game Object.

Tools/NeedleTextureStreamingUtility

2025-09-09T17:41:05Z

Ashrindy:

{{Infobox tool
| name = NeedleTextureStreamingUtility
| purpose = Editing NTSP and NTSI files.
| developer = Justin113D
| website = https://github.com/Justin113D/NeedleTextureStreamingUtility
| download = https://github.com/Justin113D/NeedleTextureStreamingUtility/releases
|programming_language=C#}}

'''NeedleTextureStreamingUtility''' is a command-line tool for extracting, packing and checking [[Resources/Streaming Texture Package|NTSP]] files and [[Resources/Texture|NTSI]] (streamed DDS) files.

== Usage ==
The tool is a simple command-line tool, the following arguments can be used such as:

<code>NeedleTextureStreamingUtility.exe pack "C:\Textures" my_custom_package.ntsp</code>

=== Arguments ===

* <code>unpack <NTSI DDS file/directory> [NTSP directory]</code> - extracts the texture data from an [[Resources/Streaming Texture Package|NTSP]] into the DDS file
* <code>pack <DDS file directory> [Output Name]</code> - creates an [[Resources/Streaming Texture Package|NTSP]] file and NTSI files from DDS files in a folder
* <code>info <NTSI DDS file | NTSP file></code> - shows basic info about inputted file

Tools/NeedleTextureStreamingUtility

2025-09-09T17:39:20Z

Ashrindy: Created page with "'''NeedleTextureStreamingUtility''' is a command-line tool for extracting, packing and checking NTSP files and NTSI (streamed DDS) files. == Usage == The tool is a simple command-line tool, the following arguments can be used such as: <code>NeedleTextureStreamingUtility.exe pack C:\Textures my_custom_package.ntsp</code> === Arguments === * <code>unpack <NTSI DDS file/directory> [NTSP directory]</code> - e..."

'''NeedleTextureStreamingUtility''' is a command-line tool for extracting, packing and checking [[Resources/Streaming Texture Package|NTSP]] files and [[Resources/Texture|NTSI]] (streamed DDS) files.

== Usage ==
The tool is a simple command-line tool, the following arguments can be used such as:

<code>NeedleTextureStreamingUtility.exe pack C:\Textures my_custom_package.ntsp</code>

=== Arguments ===

* <code>unpack <NTSI DDS file/directory> [NTSP directory]</code> - extracts the texture data from an [[Resources/Streaming Texture Package|NTSP]] into the DDS file
* <code>pack <DDS file directory> [Output Name]</code> - creates an [[Resources/Streaming Texture Package|NTSP]] file and NTSI files from DDS files in a folder
* <code>info <NTSI DDS file | NTSP file></code> - shows basic info about inputted file

Tools

2025-09-09T17:04:18Z

Ashrindy: /* Texture editing tools */

This page is a list of modding tools that can be used to edit Hedgehog Engine resources.

== Archive unpackers ==

* [[Tools/HedgeArcPack|HedgeArcPack]]
* [https://github.com/soopercool101/BrawlCrate BrawlCrate]

== Level Editors ==

* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/DevTools|DevTools]]
* [[Tools/HedgeEdit|HedgeEdit]]
* [[Tools/GLVL|GLVL]]

== Parameter editing tools ==

* [[Tools/DevTools|DevTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]

* [https://www.sweetscape.com/010editor/ 010 Editor] with [[Tools/010 Editor Binary Templates|RFL binary templates]]

== Modeling and Animation tools ==

* [https://www.blender.org/ Blender]
* [[Tools/HEIO|HEIO]]
* [[Tools/ModelConverter|ModelConverter]]
* [[Tools/modelfbx|modelfbx]]
* [[Tools/Sonic Frontiers Animation Tools|Sonic Frontiers Animation Tools]]
* [[Tools/DevTools|DevTools]] (ASM editor)

== Texture editing tools ==

* [https://developer.nvidia.com/texture-tools-exporter nVidia Texture Tools Exporter]
* [https://github.com/microsoft/DirectXTex/wiki/Texconv DirectX Texconv]
* [https://www.gimp.org/ GIMP]
* [https://www.getpaint.net/ Paint.NET]
* [[Tools/SkythTools|NeedleTextureStreamingPackage]]
* [[Tools/NeedleTextureStreamingUtility|NeedleTextureStreamingUtility]]

== Audio tools ==

* [[Tools/KwasTools|KwasTools]] (cri_utf_tool, cri_awb_tool)
* [https://github.com/libertyernie/LoopingAudioConverter LoopingAudioConverter]
* [https://www.foobar2000.org/ foobar2000] (with [https://www.foobar2000.org/components/view/foo_input_vgmstream libvgmstream plugin])
* [[Tools/SonicAudioTools|SonicAudioTools]] (Deprecated)
* [[Tools/Eternity Audio Tool|Eternity Audio Tool]] (Outdated)

== GI baking tools ==

* [[Tools/HedgeGI|HedgeGI]]

== Localization editing tools ==

* [[Tools/Puyo Text Editor|Puyo Text Editor]]
* [[Tools/Converse Editor|Converse Editor]]

== UI editing tools ==

* [[Tools/DevTools|DevTools]] (SurfRide Editor)

== Cutscene editing tools ==

* [[Tools/DevTools|DevTools]] (DvScene Editor)

== General resource conversion tools ==

* [[Tools/HedgeTools|HedgeTools]]
* [[Tools/SkythTools|SkythTools]]
* [[Tools/HedgeNeedle|HedgeNeedle]]
* [[Tools/KnuxTools|KnuxTools]]
* [[Tools/KwasTools|KwasTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/010 Editor Binary Templates|010 Editor Binary Templates]]
* [[Tools/AshDumpTool|AshDumpTool]]

== Other useful tools ==

* [https://code.visualstudio.com/ Visual Studio Code]
* [https://www.sweetscape.com/010editor/ 010 Editor]

Resources

2025-09-09T17:02:24Z

Ashrindy: /* Textures */

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
|
|}

Resources/DvScene

2025-08-27T12:07:41Z

Ashrindy:

{{Infobox Resource|type=[[Resources#Cinematics|Cinematics]]|extension=.dvscene|games=* [[Games/Sonic Frontiers|Sonic Frontiers]]
* [[Games/Shadow Generations|Shadow Generations]]|tools=* [[Tools/010 Editor Binary Templates|DiEventTemplate]]
* [[Tools/DvSceneTool|DvSceneTool]]
* [[Tools/DevTools|DevTools]]|status=Almost finished|container=|name=DvScene}}

'''DvScene''' ''(also known as DiEvent)'' is a file format that's been used in Hedgehog Engine 2 since [[Games/Sonic Frontiers|Sonic Frontiers]], it's a collection of nodes and resources that are easily editable for simple modification or creation of new cutscenes/cinematics.

The format and sub-system originates from the [[wikipedia:Yakuza_(franchise)|Yakuza game series]] in which it was known as '''DiEvent'''.

== File Structure ==
Each '''DvScene''' consists of 2 parts, '''DvCommon''' and '''DvResource'''.

=== DvCommon ===
'''DvCommon''' consists of:

* '''Frame start and end'''.
* '''Number of visual nodes''' (not confirmed).
* '''Cuts''', the timestamps of every camera cut in the cinematic.
* '''Pages''', for skipping frames in the cutscene, based on a set condition. Used for QTEs.
* '''Resource Cuts''', timestamps when the Resources should deload (all of the time it's a single item, obviously).
* '''Node''', the main Path DvNode.

The main path DvNode is the base node of the entire dvscene. Path standing for its Node Category.

'''Every DvNode contains:'''

* '''GUID''', used to connect the node to resources or just to easily tell them apart. Every node has a unique GUID.
* '''Name''', to easily organize the nodes.
* '''Node Category''', changes the nodes type, each node type does something else.
* '''Node Flags'''
* '''Priority'''
* '''Child Nodes''', the child nodes of the node.
* '''Node Data''', the parameters and values that change based on the Node Category.

The node data is dependant on the Node Category, every category has its own set of parameters.
{| class="wikitable"
|+Node Categories in Sonic Frontiers
!Name
!Description
!In-Engine Name
!Basic structure
|-
|Path
|Transforms the child nodes of this node
|DvNodePath
|Contains a Matrix4x4 which is then used to do transforms.
|-
|Camera
|Creates a Camera Object in to the cinematic
|DvNodeCamera
|Usually empty, but it has support for a list of Frame Progressions, used to skip frames in the camera animation.
|-
|Camera Motion
|Adds animation to the parent node Camera
|DvNodeCameraMotion
|Contains the frame start and end of the camera animation. The GUID connects the node to a Resource to set the [[Resources/Camera Animation|Camera Animation]] file.
|-
|Character
|Creates a Character Model Object in to the cinematic
|DvNodeCharacter
|Contains the Model Name, Skeleton Name and sometimes a so called Internal Name is used; mostly used for characters that are very common, such as Sonic, Tails etc. These have a special shortcut for each, i.e. '''sh - Shadow, snc - Sonic, kn - Knuckles'''. The GUID connects the node to a Resource to set the [[Resources/Animation State Machine|Animation State Machine]] file.
|-
|Character Motion
|Adds animation to the parent node Character
|DvNodeCharacterMotion
|Contains the frame start and end of the animation, [[Resources/Animation State Machine|Animation State Machine]] state name and animation speed. The GUID connects the node to a Resource to set the animation file.
|-
|Model
|Adds a Model Object in to the cinematic
|DvNodeModel
|The exact same as Character.
|-
|Model Motion
|Adds animation to the parent node Model
|DvNodeModelMotion
|The exact same as Character Motion
|-
|Model Node
|Creates a node to which other nodes can be attached as if it was the bone of the parent Character node
|DvNodeModelNode
|Contains the bones name.
|-
|Element
|Subcategory for nodes, contains mostly game specific elements such as DvElementRifleBeastLighting from [[Games/Sonic Frontiers|Sonic Frontiers]]
|DvElement
|Contains the Element ID, frame start and end, play type of the element and update timing of the element.
There's only 3 Element Play Types and they're very straight forward, Normal - plays the element normally; OneShot - plays only once; Always - plays always.

Update timing is a value that consists of multiple different types to change the update timings of the element, alot of these have yet to be found purposes.
|}

=== DvResource ===
'''DvResource''' is an array of resources that are loaded for a '''DvScene'''. These are connected with '''GUIDs''' to several '''DvNode types'''.

They only consist of a '''filename''', '''GUID''' and '''file type'''.
{| class="wikitable"
|+Resource Types in Sonic Frontiers
!Name
!File extension
!Used by Node
|-
|Character
|'''[[Resources/Animation State Machine|(.asm)]]'''
|Character
|-
|Camera Motion
|'''[[Resources/Camera Animation|(.cam-anim)]]'''
|Camera Motion
|-
|Character Motion
|'''[[Resources/PXD Animation|(.anm.pxd)]]'''
|Character Motion
|-
|Model
|'''[[Resources/Animation State Machine|(.asm)]]'''
|Model
|}

== Technical Info ==
All of the pointers in DvScene are 32-bit and relative to DvCommon.

This is a structure that's used throughout DvScene, it's an easy way to read an array.<syntaxhighlight lang="c++" start="0">
template<typename T>
struct DvObject{
int count; // amount of items in the array
int size; // the total size of of all the elements
long long unknown; // no instance with data here has been found
T items; // the array itself, not a pointer
};
</syntaxhighlight>

DvScene starts with two simple values, the pointers to DvCommon and DvResource<syntaxhighlight lang="c++">
struct DvScene{
DvCommon* common; // 32-bit pointer relative to DvCommon
DvObject<DvResource>* resources; // 32-bit pointer relative to DvCommon
};
</syntaxhighlight>

Before going into DvCommon, we first need to define the structures that are used in DvCommon.

There's a fairly easy to use system for skipping frames for either translation issues or QTEs. They're called DvPages. <syntaxhighlight lang="c++">struct DvCondition{
int type; // the condition type
uint parametersSize; // the size of condition dataa
long unknown; // no instance with data here has been found
char parameterData; // the data of the parameter, different for every condtion type
};

struct DvTransition{
uint destinationPageID; // the page it should jump to
uint conditionCount; // amount of conditions
ulong conditionSize; // size of conditions
};

struct DvPage{
uint unk0; // unknown
uint unk1; // unknown
uint frameStart; // the start tick of the page, it's in ticks meaning it's * 100
uint frameEnd; // the end tick of the page, it's in ticks meaning it's * 100
uint transitionCount; // amount of transitions
uint transitionSize; // size of transitions
uint skipFrame; // the tick the cutscene should skip to, it's in ticks meaning it's * 100
uint index; // the pages index
uint pageSize; // size of the pageData
char empty[12];
char name[32]; // the name of the page
char pageData; // the data of the page, hasn't been researched
DvTransition transitions;
};</syntaxhighlight>The DvPages use ticks, or also could be called just a ''truncated float.''

The important part of DvScene's, the DvNode.<syntaxhighlight lang="c++">
struct DvNode{
Guid guid; // unique identifier for the node, also used for connection with DvResource
uint nodeCategory; // the type of node
uint nodeSize; // size of the node data
uint childCount; // amount of child nodes
uint nodeFlags; // yet to be researched
uint priority; // the priority of the node when reading
char empty[12];
char name[64]; // the name of the node
char nodeData; // the data of the node, different for every node category
DvNode childNodes; // the children of this node
};
</syntaxhighlight>The Node Data is different for every single Node Category, it's the parameters of the node itself.

Now the controller of DvScenes, DvCommon.<syntaxhighlight lang="c++">
struct DvDisableFrame{
float start;
float end;
};

struct DvCommon{
long unknown; // not read by the game
float frameStart; // the start frame of the cutscene
float frameEnd; // the end frame of the cutscene
uint drawNodeNumber; // amount of visual nodes (unconfirmed, not read by the game)
DvObject<float>* cuts; // every camera cut in cutscene
DvObject<DvPage>* pages; // pages, used for QTEs and such
DvObject<DvDisableFrame>* disableFrames; // ranges, which when playing the cutscene will get skipped
DvObject<float>* resourceCuts; // when the resource should deload, always has just one item
DvObject<float>* soundCuts; // not read by the game
DvNode* node; // the main node of the cutscene
float chainCameraIn; // not read by the game
float chainCameraOut; // not read by the game
int type; // unknown
int skipPointTick; // not read by the game
};
</syntaxhighlight>All of the pointers are 32-bit and relative to DvCommon itself.

The second important part of DvScene, is the DvResource.<syntaxhighlight lang="c++">
struct DvResource{
Guid guid; // unique identifier for the resource, used to connect with DvNodes
uint type; // the file type this resource is trying to use
uint unk0; // unknown, always 0
uint unk1; // unknown, always 1
char filename[192]; // the filename of the file it's loading
char unk2[596]; // unknown, could still be just space for the filename
};
</syntaxhighlight>

Resources/DvScene

2025-08-27T12:07:26Z

Ashrindy:

{{Infobox Resource|type=[[Resources#Cinematics|Cinematics]]|extension=.dvscene|games=* [[Games/Sonic Frontiers|Sonic Frontiers]]
* [[Games/Shadow Generations|Shadow Generations]]|tools=* [[Tools/010 Editor Binary Templates|DiEventTemplate]]
* [[Tools/DvSceneTool|DvSceneTool]]
* [[Tools/DevTools|DevTools]]|status=Almost finished|container=|name=DvScene}}

'''DvScene''' ''(also known as DiEvent)'' is a file format that's been used in Hedgehog Engine 2 since [[Games/Sonic Frontiers|Sonic Frontiers]], it's a collection of nodes and

resources that are easily editable for simple modification or creation of new cutscenes/cinematics.

The format and sub-system originates from the [[wikipedia:Yakuza_(franchise)|Yakuza game series]] in which it was known as '''DiEvent'''.

== File Structure ==
Each '''DvScene''' consists of 2 parts, '''DvCommon''' and '''DvResource'''.

=== DvCommon ===
'''DvCommon''' consists of:

* '''Frame start and end'''.
* '''Number of visual nodes''' (not confirmed).
* '''Cuts''', the timestamps of every camera cut in the cinematic.
* '''Pages''', for skipping frames in the cutscene, based on a set condition. Used for QTEs.
* '''Resource Cuts''', timestamps when the Resources should deload (all of the time it's a single item, obviously).
* '''Node''', the main Path DvNode.

The main path DvNode is the base node of the entire dvscene. Path standing for its Node Category.

'''Every DvNode contains:'''

* '''GUID''', used to connect the node to resources or just to easily tell them apart. Every node has a unique GUID.
* '''Name''', to easily organize the nodes.
* '''Node Category''', changes the nodes type, each node type does something else.
* '''Node Flags'''
* '''Priority'''
* '''Child Nodes''', the child nodes of the node.
* '''Node Data''', the parameters and values that change based on the Node Category.

The node data is dependant on the Node Category, every category has its own set of parameters.
{| class="wikitable"
|+Node Categories in Sonic Frontiers
!Name
!Description
!In-Engine Name
!Basic structure
|-
|Path
|Transforms the child nodes of this node
|DvNodePath
|Contains a Matrix4x4 which is then used to do transforms.
|-
|Camera
|Creates a Camera Object in to the cinematic
|DvNodeCamera
|Usually empty, but it has support for a list of Frame Progressions, used to skip frames in the camera animation.
|-
|Camera Motion
|Adds animation to the parent node Camera
|DvNodeCameraMotion
|Contains the frame start and end of the camera animation. The GUID connects the node to a Resource to set the [[Resources/Camera Animation|Camera Animation]] file.
|-
|Character
|Creates a Character Model Object in to the cinematic
|DvNodeCharacter
|Contains the Model Name, Skeleton Name and sometimes a so called Internal Name is used; mostly used for characters that are very common, such as Sonic, Tails etc. These have a special shortcut for each, i.e. '''sh - Shadow, snc - Sonic, kn - Knuckles'''. The GUID connects the node to a Resource to set the [[Resources/Animation State Machine|Animation State Machine]] file.
|-
|Character Motion
|Adds animation to the parent node Character
|DvNodeCharacterMotion
|Contains the frame start and end of the animation, [[Resources/Animation State Machine|Animation State Machine]] state name and animation speed. The GUID connects the node to a Resource to set the animation file.
|-
|Model
|Adds a Model Object in to the cinematic
|DvNodeModel
|The exact same as Character.
|-
|Model Motion
|Adds animation to the parent node Model
|DvNodeModelMotion
|The exact same as Character Motion
|-
|Model Node
|Creates a node to which other nodes can be attached as if it was the bone of the parent Character node
|DvNodeModelNode
|Contains the bones name.
|-
|Element
|Subcategory for nodes, contains mostly game specific elements such as DvElementRifleBeastLighting from [[Games/Sonic Frontiers|Sonic Frontiers]]
|DvElement
|Contains the Element ID, frame start and end, play type of the element and update timing of the element.
There's only 3 Element Play Types and they're very straight forward, Normal - plays the element normally; OneShot - plays only once; Always - plays always.

Update timing is a value that consists of multiple different types to change the update timings of the element, alot of these have yet to be found purposes.
|}

=== DvResource ===
'''DvResource''' is an array of resources that are loaded for a '''DvScene'''. These are connected with '''GUIDs''' to several '''DvNode types'''.

They only consist of a '''filename''', '''GUID''' and '''file type'''.
{| class="wikitable"
|+Resource Types in Sonic Frontiers
!Name
!File extension
!Used by Node
|-
|Character
|'''[[Resources/Animation State Machine|(.asm)]]'''
|Character
|-
|Camera Motion
|'''[[Resources/Camera Animation|(.cam-anim)]]'''
|Camera Motion
|-
|Character Motion
|'''[[Resources/PXD Animation|(.anm.pxd)]]'''
|Character Motion
|-
|Model
|'''[[Resources/Animation State Machine|(.asm)]]'''
|Model
|}

== Technical Info ==
All of the pointers in DvScene are 32-bit and relative to DvCommon.

This is a structure that's used throughout DvScene, it's an easy way to read an array.<syntaxhighlight lang="c++" start="0">
template<typename T>
struct DvObject{
int count; // amount of items in the array
int size; // the total size of of all the elements
long long unknown; // no instance with data here has been found
T items; // the array itself, not a pointer
};
</syntaxhighlight>

DvScene starts with two simple values, the pointers to DvCommon and DvResource<syntaxhighlight lang="c++">
struct DvScene{
DvCommon* common; // 32-bit pointer relative to DvCommon
DvObject<DvResource>* resources; // 32-bit pointer relative to DvCommon
};
</syntaxhighlight>

Before going into DvCommon, we first need to define the structures that are used in DvCommon.

There's a fairly easy to use system for skipping frames for either translation issues or QTEs. They're called DvPages. <syntaxhighlight lang="c++">struct DvCondition{
int type; // the condition type
uint parametersSize; // the size of condition dataa
long unknown; // no instance with data here has been found
char parameterData; // the data of the parameter, different for every condtion type
};

struct DvTransition{
uint destinationPageID; // the page it should jump to
uint conditionCount; // amount of conditions
ulong conditionSize; // size of conditions
};

struct DvPage{
uint unk0; // unknown
uint unk1; // unknown
uint frameStart; // the start tick of the page, it's in ticks meaning it's * 100
uint frameEnd; // the end tick of the page, it's in ticks meaning it's * 100
uint transitionCount; // amount of transitions
uint transitionSize; // size of transitions
uint skipFrame; // the tick the cutscene should skip to, it's in ticks meaning it's * 100
uint index; // the pages index
uint pageSize; // size of the pageData
char empty[12];
char name[32]; // the name of the page
char pageData; // the data of the page, hasn't been researched
DvTransition transitions;
};</syntaxhighlight>The DvPages use ticks, or also could be called just a ''truncated float.''

The important part of DvScene's, the DvNode.<syntaxhighlight lang="c++">
struct DvNode{
Guid guid; // unique identifier for the node, also used for connection with DvResource
uint nodeCategory; // the type of node
uint nodeSize; // size of the node data
uint childCount; // amount of child nodes
uint nodeFlags; // yet to be researched
uint priority; // the priority of the node when reading
char empty[12];
char name[64]; // the name of the node
char nodeData; // the data of the node, different for every node category
DvNode childNodes; // the children of this node
};
</syntaxhighlight>The Node Data is different for every single Node Category, it's the parameters of the node itself.

Now the controller of DvScenes, DvCommon.<syntaxhighlight lang="c++">
struct DvDisableFrame{
float start;
float end;
};

struct DvCommon{
long unknown; // not read by the game
float frameStart; // the start frame of the cutscene
float frameEnd; // the end frame of the cutscene
uint drawNodeNumber; // amount of visual nodes (unconfirmed, not read by the game)
DvObject<float>* cuts; // every camera cut in cutscene
DvObject<DvPage>* pages; // pages, used for QTEs and such
DvObject<DvDisableFrame>* disableFrames; // ranges, which when playing the cutscene will get skipped
DvObject<float>* resourceCuts; // when the resource should deload, always has just one item
DvObject<float>* soundCuts; // not read by the game
DvNode* node; // the main node of the cutscene
float chainCameraIn; // not read by the game
float chainCameraOut; // not read by the game
int type; // unknown
int skipPointTick; // not read by the game
};
</syntaxhighlight>All of the pointers are 32-bit and relative to DvCommon itself.

The second important part of DvScene, is the DvResource.<syntaxhighlight lang="c++">
struct DvResource{
Guid guid; // unique identifier for the resource, used to connect with DvNodes
uint type; // the file type this resource is trying to use
uint unk0; // unknown, always 0
uint unk1; // unknown, always 1
char filename[192]; // the filename of the file it's loading
char unk2[596]; // unknown, could still be just space for the filename
};
</syntaxhighlight>

Resources/DvScene

2025-08-27T12:06:29Z

Ashrindy: /* Technical Info */

{{Infobox Resource|type=[[Resources#Cinematics|Cinematics]]|extension=.dvscene|games=* [[Games/Sonic Frontiers|Sonic Frontiers]]
* [[Games/Shadow Generations|Shadow Generations]]|tools=* [[Tools/010 Editor Binary Templates|DiEventTemplate]]
* [[Tools/DvSceneTool|DvSceneTool]]|status=Almost finished|container=|name=DvScene}}

'''DvScene''' ''(also known as DiEvent)'' is a file format that's been used in Hedgehog Engine 2 since [[Games/Sonic Frontiers|Sonic Frontiers]], it's a collection of nodes and

resources that are easily editable for simple modification or creation of new cutscenes/cinematics.

The format and sub-system originates from the [[wikipedia:Yakuza_(franchise)|Yakuza game series]] in which it was known as '''DiEvent'''.

There are no proper ways currently to edit '''.dvscene''' except for an [[Tools/010 Editor Binary Templates|010 Editor Binary Template]].

== File Structure ==
Each '''DvScene''' consists of 2 parts, '''DvCommon''' and '''DvResource'''.

=== DvCommon ===
'''DvCommon''' consists of:

* '''Frame start and end'''.
* '''Number of visual nodes''' (not confirmed).
* '''Cuts''', the timestamps of every camera cut in the cinematic.
* '''Pages''', for skipping frames in the cutscene, based on a set condition. Used for QTEs.
* '''Resource Cuts''', timestamps when the Resources should deload (all of the time it's a single item, obviously).
* '''Node''', the main Path DvNode.

The main path DvNode is the base node of the entire dvscene. Path standing for its Node Category.

'''Every DvNode contains:'''

* '''GUID''', used to connect the node to resources or just to easily tell them apart. Every node has a unique GUID.
* '''Name''', to easily organize the nodes.
* '''Node Category''', changes the nodes type, each node type does something else.
* '''Node Flags'''
* '''Priority'''
* '''Child Nodes''', the child nodes of the node.
* '''Node Data''', the parameters and values that change based on the Node Category.

The node data is dependant on the Node Category, every category has its own set of parameters.
{| class="wikitable"
|+Node Categories in Sonic Frontiers
!Name
!Description
!In-Engine Name
!Basic structure
|-
|Path
|Transforms the child nodes of this node
|DvNodePath
|Contains a Matrix4x4 which is then used to do transforms.
|-
|Camera
|Creates a Camera Object in to the cinematic
|DvNodeCamera
|Usually empty, but it has support for a list of Frame Progressions, used to skip frames in the camera animation.
|-
|Camera Motion
|Adds animation to the parent node Camera
|DvNodeCameraMotion
|Contains the frame start and end of the camera animation. The GUID connects the node to a Resource to set the [[Resources/Camera Animation|Camera Animation]] file.
|-
|Character
|Creates a Character Model Object in to the cinematic
|DvNodeCharacter
|Contains the Model Name, Skeleton Name and sometimes a so called Internal Name is used; mostly used for characters that are very common, such as Sonic, Tails etc. These have a special shortcut for each, i.e. '''sh - Shadow, snc - Sonic, kn - Knuckles'''. The GUID connects the node to a Resource to set the [[Resources/Animation State Machine|Animation State Machine]] file.
|-
|Character Motion
|Adds animation to the parent node Character
|DvNodeCharacterMotion
|Contains the frame start and end of the animation, [[Resources/Animation State Machine|Animation State Machine]] state name and animation speed. The GUID connects the node to a Resource to set the animation file.
|-
|Model
|Adds a Model Object in to the cinematic
|DvNodeModel
|The exact same as Character.
|-
|Model Motion
|Adds animation to the parent node Model
|DvNodeModelMotion
|The exact same as Character Motion
|-
|Model Node
|Creates a node to which other nodes can be attached as if it was the bone of the parent Character node
|DvNodeModelNode
|Contains the bones name.
|-
|Element
|Subcategory for nodes, contains mostly game specific elements such as DvElementRifleBeastLighting from [[Games/Sonic Frontiers|Sonic Frontiers]]
|DvElement
|Contains the Element ID, frame start and end, play type of the element and update timing of the element.
There's only 3 Element Play Types and they're very straight forward, Normal - plays the element normally; OneShot - plays only once; Always - plays always.

Update timing is a value that consists of multiple different types to change the update timings of the element, alot of these have yet to be found purposes.
|}

=== DvResource ===
'''DvResource''' is an array of resources that are loaded for a '''DvScene'''. These are connected with '''GUIDs''' to several '''DvNode types'''.

They only consist of a '''filename''', '''GUID''' and '''file type'''.
{| class="wikitable"
|+Resource Types in Sonic Frontiers
!Name
!File extension
!Used by Node
|-
|Character
|'''[[Resources/Animation State Machine|(.asm)]]'''
|Character
|-
|Camera Motion
|'''[[Resources/Camera Animation|(.cam-anim)]]'''
|Camera Motion
|-
|Character Motion
|'''[[Resources/PXD Animation|(.anm.pxd)]]'''
|Character Motion
|-
|Model
|'''[[Resources/Animation State Machine|(.asm)]]'''
|Model
|}

== Technical Info ==
All of the pointers in DvScene are 32-bit and relative to DvCommon.

This is a structure that's used throughout DvScene, it's an easy way to read an array.<syntaxhighlight lang="c++" start="0">
template<typename T>
struct DvObject{
int count; // amount of items in the array
int size; // the total size of of all the elements
long long unknown; // no instance with data here has been found
T items; // the array itself, not a pointer
};
</syntaxhighlight>

DvScene starts with two simple values, the pointers to DvCommon and DvResource<syntaxhighlight lang="c++">
struct DvScene{
DvCommon* common; // 32-bit pointer relative to DvCommon
DvObject<DvResource>* resources; // 32-bit pointer relative to DvCommon
};
</syntaxhighlight>

Before going into DvCommon, we first need to define the structures that are used in DvCommon.

There's a fairly easy to use system for skipping frames for either translation issues or QTEs. They're called DvPages. <syntaxhighlight lang="c++">struct DvCondition{
int type; // the condition type
uint parametersSize; // the size of condition dataa
long unknown; // no instance with data here has been found
char parameterData; // the data of the parameter, different for every condtion type
};

struct DvTransition{
uint destinationPageID; // the page it should jump to
uint conditionCount; // amount of conditions
ulong conditionSize; // size of conditions
};

struct DvPage{
uint unk0; // unknown
uint unk1; // unknown
uint frameStart; // the start tick of the page, it's in ticks meaning it's * 100
uint frameEnd; // the end tick of the page, it's in ticks meaning it's * 100
uint transitionCount; // amount of transitions
uint transitionSize; // size of transitions
uint skipFrame; // the tick the cutscene should skip to, it's in ticks meaning it's * 100
uint index; // the pages index
uint pageSize; // size of the pageData
char empty[12];
char name[32]; // the name of the page
char pageData; // the data of the page, hasn't been researched
DvTransition transitions;
};</syntaxhighlight>The DvPages use ticks, or also could be called just a ''truncated float.''

The important part of DvScene's, the DvNode.<syntaxhighlight lang="c++">
struct DvNode{
Guid guid; // unique identifier for the node, also used for connection with DvResource
uint nodeCategory; // the type of node
uint nodeSize; // size of the node data
uint childCount; // amount of child nodes
uint nodeFlags; // yet to be researched
uint priority; // the priority of the node when reading
char empty[12];
char name[64]; // the name of the node
char nodeData; // the data of the node, different for every node category
DvNode childNodes; // the children of this node
};
</syntaxhighlight>The Node Data is different for every single Node Category, it's the parameters of the node itself.

Now the controller of DvScenes, DvCommon.<syntaxhighlight lang="c++">
struct DvDisableFrame{
float start;
float end;
};

struct DvCommon{
long unknown; // not read by the game
float frameStart; // the start frame of the cutscene
float frameEnd; // the end frame of the cutscene
uint drawNodeNumber; // amount of visual nodes (unconfirmed, not read by the game)
DvObject<float>* cuts; // every camera cut in cutscene
DvObject<DvPage>* pages; // pages, used for QTEs and such
DvObject<DvDisableFrame>* disableFrames; // ranges, which when playing the cutscene will get skipped
DvObject<float>* resourceCuts; // when the resource should deload, always has just one item
DvObject<float>* soundCuts; // not read by the game
DvNode* node; // the main node of the cutscene
float chainCameraIn; // not read by the game
float chainCameraOut; // not read by the game
int type; // unknown
int skipPointTick; // not read by the game
};
</syntaxhighlight>All of the pointers are 32-bit and relative to DvCommon itself.

The second important part of DvScene, is the DvResource.<syntaxhighlight lang="c++">
struct DvResource{
Guid guid; // unique identifier for the resource, used to connect with DvNodes
uint type; // the file type this resource is trying to use
uint unk0; // unknown, always 0
uint unk1; // unknown, always 1
char filename[192]; // the filename of the file it's loading
char unk2[596]; // unknown, could still be just space for the filename
};
</syntaxhighlight>

Tools/DvSceneTool

2025-08-27T12:02:41Z

Ashrindy:

{{Infobox tool
| name = DvSceneTool
| logo = File:DvSceneTool_screenshot.png
| purpose = Editing dvscene files, the brains of cinematics.
| developer = Ashrindy
| website = https://github.com/Ashrindy/DvSceneTool
| download = https://github.com/Ashrindy/DvSceneTool/releases
|programming_language=C#|logo_caption=Design of the app with ev1770_mov opened}}'''DvSceneTool''' is a modding tool that allows you to edit [[Resources/DvScene|DvScene]] files, which are the brains of cinematics.

This tool works on a template system, meaning it's easy to add or edit knowledge about game specific [[Resources/DvScene|DvScenes]].

Tools/DvSceneTool

2025-08-27T11:56:20Z

Ashrindy:

Tools/DvSceneTool

2025-08-27T11:54:07Z

Ashrindy: Created page with "{{Infobox tool | name = DvSceneTool | logo = File:DvSceneTool_screenshot.jpg | purpose = Editing dvscene files, the brains of cinematics. | developer = Ashrindy | website = https://github.com/Ashrindy/DvSceneTool | download = https://github.com/Ashrindy/DvSceneTool/releases |programming_language=C#|logo_caption=Design of the app with ev1770_mov opened}}"

{{Infobox tool
| name = DvSceneTool
| logo = File:DvSceneTool_screenshot.jpg
| purpose = Editing dvscene files, the brains of cinematics.
| developer = Ashrindy
| website = https://github.com/Ashrindy/DvSceneTool
| download = https://github.com/Ashrindy/DvSceneTool/releases
|programming_language=C#|logo_caption=Design of the app with ev1770_mov opened}}

File:DvSceneTool screenshot.png

2025-08-27T11:53:40Z

Ashrindy:

Resources

2025-08-27T11:33:42Z

Ashrindy: /* Cinematics */

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
|
|}

== 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
|
|}

Sonic Frontiers/Internals/GOComponent

2025-08-12T19:15:38Z

Ashrindy:

Sonic Frontiers/Internals/GOComponent

2025-08-09T20:56:01Z

Ashrindy: /* GOComponent */

== GOComponent ==
'''GOComponent''' ''(Game Object Component)'' is a part of a very basic '''ECS''' ''(Entity Component System)'' which the '''HE2''' utilizes. GOCs are attached to '''Game Objects''', which add basic functionality or easy control over certain aspects, such as '''GOCVisualModel''' adds an easy way to show a model at the Game Objects position.

== GOComponents ''(currently in rangers-sdk)'' ==

=== Animation ===

* GOCAnimation
* GOCAnimationBlend
* GOCAnimationSimple
* GOCAnimationSingle
* GOCAnimator
* GOCCharacterIk
* GOCLookAt
* GOCPhysicalAnimation

=== Boss ===

* GOCBossActionSelect
* GOCBossCyloopColliderHelper
* GOCBossMoveableRange

=== Collision ===

* GOCBoxCollider
* GOCCapsuleCollider
* GOCColliderQuery
* GOCCollisionQuery
* GOCCylinderCollider
* GOCHeightFieldCollider
* GOCMeshCollider
* GOCMoveSphereColliderQuery
* GOCSphereCollider

=== Effect ===

* GOCEffect
* GOCParticleLocator

=== Enemy ===

* GOCAI
* GOCEnemyAttackSign

=== General ===

* GOCActivator
* GOCContact
* GOCCyloopPoint
* GOCEvent
* GOCEventCollision
* GOCGravity
* GOCGrind
* GOCHealth
* GOCHitStop
* GOCNavMeshAgent
* GOCTargetPositionHelper
* GOCTransform
* GOCParamBlackboard
* GOCScript
* PathComponent

=== Graphics ===

* GOCCamera
* GOCOcclusionCapsule
* GOCPointLight
* GOCRenderTexture
* GOCVisualDebugDraw
* GOCVisualModel
* GOCVisualTransformed
* GOCVisualUserModel

=== HID ===

* GOCInput
* GOCVibration

=== Movement ===

* GOCMotor
* GOCMotorConstant
* GOCMotorOnPath
* GOCMotorRotate
* GOCMovement

=== Player ===

* GOCPlayerCollider
* GOCPlayerEffect
* GOCPlayerHsm
* GOCPlayerKinematicParams
* GOCPlayerParameter
* GOCPlayerState
* GOCPlayerVisual

=== Reflection ===

* GOCRflParameter

=== Sound ===

* GOCSound

=== User Interface ===

* GOCSprite
* GOCUICollider
* GOCUIComposition

Sonic Frontiers/Internals/GOComponent

2025-08-09T20:51:46Z

Ashrindy: Created page with "== GOComponent == == GOComponents == === Animation === * GOCAnimation * GOCAnimationBlend * GOCAnimationSimple * GOCAnimationSingle * GOCAnimator * GOCCharacterIk * GOCLookAt * GOCPhysicalAnimation === Boss === * GOCBossActionSelect * GOCBossCyloopColliderHelper * GOCBossMoveableRange === Collision === * GOCBoxCollider * GOCCapsuleCollider * GOCColliderQuery * GOCCollisionQuery * GOCCylinderCollider * GOCHeightFieldCollider * GOCMeshCollider * GOCMoveSphereCollide..."

== GOComponent ==

== GOComponents ==

=== Animation ===

* GOCAnimation
* GOCAnimationBlend
* GOCAnimationSimple
* GOCAnimationSingle
* GOCAnimator
* GOCCharacterIk
* GOCLookAt
* GOCPhysicalAnimation

=== Boss ===

* GOCBossActionSelect
* GOCBossCyloopColliderHelper
* GOCBossMoveableRange

=== Collision ===

* GOCBoxCollider
* GOCCapsuleCollider
* GOCColliderQuery
* GOCCollisionQuery
* GOCCylinderCollider
* GOCHeightFieldCollider
* GOCMeshCollider
* GOCMoveSphereColliderQuery
* GOCSphereCollider

=== Effect ===

* GOCEffect
* GOCParticleLocator

=== Enemy ===

* GOCAI
* GOCEnemyAttackSign

=== General ===

* GOCActivator
* GOCContact
* GOCCyloopPoint
* GOCEvent
* GOCEventCollision
* GOCGravity
* GOCGrind
* GOCHealth
* GOCHitStop
* GOCNavMeshAgent
* GOCTargetPositionHelper
* GOCTransform
* GOCParamBlackboard
* GOCScript
* PathComponent

=== Graphics ===

* GOCCamera
* GOCOcclusionCapsule
* GOCPointLight
* GOCRenderTexture
* GOCVisualDebugDraw
* GOCVisualModel
* GOCVisualTransformed
* GOCVisualUserModel

=== HID ===

* GOCInput
* GOCVibration

=== Movement ===

* GOCMotor
* GOCMotorConstant
* GOCMotorOnPath
* GOCMotorRotate
* GOCMovement

=== Player ===

* GOCPlayerCollider
* GOCPlayerEffect
* GOCPlayerHsm
* GOCPlayerKinematicParams
* GOCPlayerParameter
* GOCPlayerState
* GOCPlayerVisual

=== Reflection ===

* GOCRflParameter

=== Sound ===

* GOCSound

=== User Interface ===

* GOCSprite
* GOCUICollider
* GOCUIComposition

Sonic Frontiers/Internals

2025-08-09T20:51:03Z

Ashrindy:

* [[Sonic Frontiers/Internals/GOComponent|GOComponent]]

Sonic Frontiers/Internals/GOComponents

2025-08-09T20:47:56Z

Ashrindy: Created page with "== GOComponents == === Animation === * GOCAnimation * GOCAnimationBlend * GOCAnimationSimple * GOCAnimationSingle * GOCAnimator * GOCCharacterIk * GOCLookAt * GOCPhysicalAnimation === Boss === * GOCBossActionSelect * GOCBossCyloopColliderHelper * GOCBossMoveableRange === Collision === * GOCBoxCollider * GOCCapsuleCollider * GOCColliderQuery * GOCCollisionQuery * GOCCylinderCollider * GOCHeightFieldCollider * GOCMeshCollider * GOCMoveSphereColliderQuery * GOCSphereC..."

== GOComponents ==

=== Animation ===

* GOCAnimation
* GOCAnimationBlend
* GOCAnimationSimple
* GOCAnimationSingle
* GOCAnimator
* GOCCharacterIk
* GOCLookAt
* GOCPhysicalAnimation

=== Boss ===

* GOCBossActionSelect
* GOCBossCyloopColliderHelper
* GOCBossMoveableRange

=== Collision ===

* GOCBoxCollider
* GOCCapsuleCollider
* GOCColliderQuery
* GOCCollisionQuery
* GOCCylinderCollider
* GOCHeightFieldCollider
* GOCMeshCollider
* GOCMoveSphereColliderQuery
* GOCSphereCollider

=== Effect ===

* GOCEffect
* GOCParticleLocator

=== Enemy ===

* GOCAI
* GOCEnemyAttackSign

=== General ===

* GOCActivator
* GOCContact
* GOCCyloopPoint
* GOCEvent
* GOCEventCollision
* GOCGravity
* GOCGrind
* GOCHealth
* GOCHitStop
* GOCNavMeshAgent
* GOCTargetPositionHelper
* GOCTransform
* GOCParamBlackboard
* GOCScript
* PathComponent

=== Graphics ===

* GOCCamera
* GOCOcclusionCapsule
* GOCPointLight
* GOCRenderTexture
* GOCVisualDebugDraw
* GOCVisualModel
* GOCVisualTransformed
* GOCVisualUserModel

=== HID ===

* GOCInput
* GOCVibration

=== Movement ===

* GOCMotor
* GOCMotorConstant
* GOCMotorOnPath
* GOCMotorRotate
* GOCMovement

=== Player ===

* GOCPlayerCollider
* GOCPlayerEffect
* GOCPlayerHsm
* GOCPlayerKinematicParams
* GOCPlayerParameter
* GOCPlayerState
* GOCPlayerVisual

=== Reflection ===

* GOCRflParameter

=== Sound ===

* GOCSound

=== User Interface ===

* GOCSprite
* GOCUICollider
* GOCUIComposition

Sonic Frontiers/Internals

2025-08-09T20:34:56Z

Ashrindy:

* [[Sonic Frontiers/Internals/GOComponents|GOComponents]]

Sonic Frontiers/Internals

2025-08-09T20:34:18Z

Ashrindy: Created page with "GOComponents"

GOComponents

Sonic Frontiers

2025-08-09T20:06:24Z

Ashrindy:

{{Infobox game
| name = Sonic Frontiers
| developer = Sonic Team
| publisher = SEGA
| release_date = November 8, 2022
| engine = Hedgehog Engine 2
|logo=File:Sonic-frontiers.jpg|logo_caption=Sonic Frontiers Key Art}}

'''Sonic Frontiers''' ''(codenamed rangers)'' was released on the 8th of November, 2022.

It uses Hedgehog Engine 2, but has some notable differences to [[Sonic Forces]], the previous game to use HE2, including differences in file structure and file formats used.

* [[Sonic Frontiers/Guides|Guides]]
* [[Sonic Frontiers/Internals|Internals]]

=== Resource References ===

* [[Sonic Frontiers/Heightmaps|Heightmaps]]
* [[Sonic Frontiers/ID Mappings|ID Mappings]]
* [[Sonic Frontiers/StageData_Parameters|StageData Parameters]]
* [[Sonic Frontiers/Master_Trial_Parameters|Master Trial Parameters]]

Tools

2025-04-03T20:55:48Z

Ashrindy:

This page is a list of modding tools that can be used to edit Hedgehog Engine resources.

== Archive unpackers ==

* [[Tools/HedgeArcPack|HedgeArcPack]]
* [https://github.com/soopercool101/BrawlCrate BrawlCrate]

== Level Editors ==

* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/DevTools|DevTools]]
* [[Tools/HedgeEdit|HedgeEdit]]
* [[Tools/GLVL|GLVL]]

== Parameter editing tools ==

* [[Tools/DevTools|DevTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]

* [https://www.sweetscape.com/010editor/ 010 Editor] with [[Tools/010 Editor Binary Templates|RFL binary templates]]

== Modeling and Animation tools ==

* [https://www.blender.org/ Blender]
* [[Tools/HEIO|HEIO]]
* [[Tools/ModelConverter|ModelConverter]]
* [[Tools/modelfbx|modelfbx]]
* [[Tools/Sonic Frontiers Animation Tools|Sonic Frontiers Animation Tools]]
* [[Tools/DevTools|DevTools]] (ASM editor)

== Texture editing tools ==

* [https://developer.nvidia.com/texture-tools-exporter nVidia Texture Tools Exporter]
* [https://github.com/microsoft/DirectXTex/wiki/Texconv DirectX Texconv]
* [https://www.gimp.org/ GIMP]
* [https://www.getpaint.net/ Paint.NET]
* [[Tools/SkythTools|NeedleTextureStreamingPackage]]

== Audio tools ==

* [[Tools/KwasTools|KwasTools]] (cri_utf_tool, cri_awb_tool)
* [https://github.com/libertyernie/LoopingAudioConverter LoopingAudioConverter]
* [https://www.foobar2000.org/ foobar2000] (with [https://www.foobar2000.org/components/view/foo_input_vgmstream libvgmstream plugin])
* [[Tools/SonicAudioTools|SonicAudioTools]] (Deprecated)
* [[Tools/Eternity Audio Tool|Eternity Audio Tool]] (Outdated)

== GI baking tools ==

* [[Tools/HedgeGI|HedgeGI]]

== Localization editing tools ==

* [[Tools/Puyo Text Editor|Puyo Text Editor]]
* [[Tools/Converse Editor|Converse Editor]]

== UI editing tools ==

* [[Tools/DevTools|DevTools]] (SurfRide Editor)

== Cutscene editing tools ==

* [[Tools/DevTools|DevTools]] (DvScene Editor)

== General resource conversion tools ==

* [[Tools/HedgeTools|HedgeTools]]
* [[Tools/SkythTools|SkythTools]]
* [[Tools/HedgeNeedle|HedgeNeedle]]
* [[Tools/KnuxTools|KnuxTools]]
* [[Tools/KwasTools|KwasTools]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/010 Editor Binary Templates|010 Editor Binary Templates]]
* [[Tools/AshDumpTool|AshDumpTool]]

== Other useful tools ==

* [https://code.visualstudio.com/ Visual Studio Code]
* [https://www.sweetscape.com/010editor/ 010 Editor]

Tools/Converse Editor

2025-03-31T09:15:47Z

Ashrindy:

{{Infobox tool
| name = Converse Editor
| purpose = Editing text/converse related files
| developer = Ashrindy
| website = https://github.com/Ashrindy/ConverseEditor
| download = https://github.com/Ashrindy/ConverseEditor/releases
|programming_language=C#}}

'''Converse Editor''' is a WIP text editing tool for Hedgehog Engine 2 games, primarily focusing on [[Sonic Frontiers|Sonic Frontiers]] and [[Shadow Generations|Shadow Generations]] as of now. It has a GUI, unlike older tools used before such as [[Tools/Puyo Text Editor|Puyo Text Editor]].

Resources/Density Setting

2025-01-27T12:27:24Z

Ashrindy:

{{Infobox Resource|type=[[Resources#Density (vegetation)|Density (vegetation)]]|extension=.densitysetting|games=* [[Sonic Frontiers|Sonic Frontiers]]|tools=* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]|status=Mostly done|container=BINA|name=Density Setting}} ''''''Density Setting'''''' is used to setup precomputed foliage that's used in ''''''[[Resources/Density Point Cloud|Density Point Cloud]].''''''

Resources/Density Point Cloud

2025-01-27T12:22:29Z

Ashrindy:

{{Infobox Resource|type=[[Resources#Density (vegetation)|Density (vegetation)]]|extension=.densitypointcloud|games=* [[Sonic Frontiers|Sonic Frontiers]]|tools=* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]
* [[Tools/KnuxTools|KnuxTools]]
* [[Tools/AshDumpTool|AshDumpTool]]|status=Done|container=BINA|name=Density Point Cloud}}''''''Density Point Cloud'''''' is used to store precomputed foliage such as trees, grass, moss etc.It's communicates with''''''[[Resources/Density Setting|Density Setting]]'''.'''

Can be turned off with NeedleFxSceneData RFL using the '''precomputedEnabled''' variable.

Resources/Terrain Material

2025-01-27T10:35:07Z

Ashrindy:

{{Infobox Resource|name=Terrain Material|container=BINA|status=A few unknown values, otherwise done|extension=.terrain-material|games=* [[Sonic Frontiers|Sonic Frontiers]]|tools=* [[Tools/KnuxTools|KnuxTools]]|type=[[Resources#Materials|Materials]]}}

'''Terrain Materials''' are materials that are assigned to a heightmap through the use of an splatmap. The splatmap uses R8_UNORM DirectDraw encoding.

Each colour on the splatmap corresponds to a certain material ID, defined in a terrain-material file. Each material entry in the terrain-material file contains a material type, index to identify the material, an Albedo and PRM map for the base texture, and an Albedo, PRM and Displacement map for the detail.

The base texture is simply the texture that will be seen from a distance, when detail hasn't loaded in yet.

Detail is extra geometry that will be rendered when the player is close up, it is displaced from the surface of the heightmap based on the displacement texture of the material.

Draw distance for detail is determined in the stage's NeedleFxSceneData RFL.

Resources/Terrain Material

2025-01-27T10:34:16Z

Ashrindy:

{{Infobox Resource|name=Terrain Material|container=BINA|status=A few unknown values, otherwise done|extension=.terrain-material|games=* [[Sonic Frontiers|Sonic Frontiers]]|tools=* [[Tools/KnuxTools|KnuxTools]]|type=[[Resources#Materials|Materials]]}}

Terrain materials are materials that are assigned to a heightmap through the use of an splatmap. The splatmap uses R8_UNORM DirectDraw encoding.

Each colour on the splatmap corresponds to a certain material ID, defined in a terrain-material file. Each material entry in the terrain-material file contains a material type, index to identify the material, an Albedo and PRM map for the base texture, and an Albedo, PRM and Displacement map for the detail.

The base texture is simply the texture that will be seen from a distance, when detail hasn't loaded in yet.

Detail is extra geometry that will be rendered when the player is close up, it is displaced from the surface of the heightmap based on the displacement texture of the material.

Draw distance for detail is determined in the stage's NeedleFxSceneData RFL.

Resources/Terrain Material

2025-01-27T10:29:48Z

Ashrindy:

{{Infobox Resource|name=Terrain Material|container=BINA|status=A few unknown values, otherwise done|extension=.terrain-material|games=* [[Sonic Frontiers|Sonic Frontiers]]|tools=* [[Tools/KnuxTools|KnuxTools]]}}

Terrain materials are materials that are assigned to a heightmap through the use of an splatmap. The splatmap uses R8_UNORM DirectDraw encoding.

Each colour on the splatmap corresponds to a certain material ID, defined in a terrain-material file. Each material entry in the terrain-material file contains a material type, index to identify the material, an Albedo and PRM map for the base texture, and an Albedo, PRM and Displacement map for the detail.

The base texture is simply the texture that will be seen from a distance, when detail hasn't loaded in yet.

Detail is extra geometry that will be rendered when the player is close up, it is displaced from the surface of the heightmap based on the displacement texture of the material.

Draw distance for detail is determined in the stage's NeedleFxSceneData RFL.

Resources/Terrain Material

2025-01-27T10:28:59Z

Ashrindy:

{{Infobox Resource|name=Terrain Material|container=BINA|status=A few unknown values, otherwise done|extension=.terrain-material|games=* [[Sonic Frontiers|Sonic Frontiers]]}}

Terrain materials are materials that are assigned to a heightmap through the use of an splatmap. The splatmap uses R8_UNORM DirectDraw encoding.

Each colour on the splatmap corresponds to a certain material ID, defined in a terrain-material file. Each material entry in the terrain-material file contains a material type, index to identify the material, an Albedo and PRM map for the base texture, and an Albedo, PRM and Displacement map for the detail.

The base texture is simply the texture that will be seen from a distance, when detail hasn't loaded in yet.

Detail is extra geometry that will be rendered when the player is close up, it is displaced from the surface of the heightmap based on the displacement texture of the material.

Draw distance for detail is determined in the stage's NeedleFxSceneData RFL.

Resources/Terrain Material

2025-01-27T10:26:19Z

Ashrindy:

{{Infobox Resource|name=Terrain Material|container=BINA|status=A few unknown values, otherwise done}}

Terrain materials are materials that are assigned to a heightmap through the use of an splatmap. The splatmap uses R8_UNORM DirectDraw encoding.

Each colour on the splatmap corresponds to a certain material ID, defined in a terrain-material file. Each material entry in the terrain-material file contains a material type, index to identify the material, an Albedo and PRM map for the base texture, and an Albedo, PRM and Displacement map for the detail.

The base texture is simply the texture that will be seen from a distance, when detail hasn't loaded in yet.

Detail is extra geometry that will be rendered when the player is close up, it is displaced from the surface of the heightmap based on the displacement texture of the material.

Draw distance for detail is determined in the stage's NeedleFxSceneData RFL.

Resources/ObjectWorld / GEdit

2025-01-27T10:23:40Z

Ashrindy: /* Technical info */

{{Infobox Resource|type=[[Resources#Set Objects|Set Objects]]|extension=.gedit|games=* [[Sonic Forces|Sonic Forces]]
* [[Sonic Origins|Sonic Origins]]
* [[Sonic Frontiers|Sonic Frontiers]]
* [[Shadow Generations|Shadow Generations]]|tools=* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/DevTools|DevTools]]
* [[Tools/HedgeSet|HedgeSet]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]|status=Done|container=BINA|name=Object World}}
'''Object World''' ''(more well known as GEdit)'' is the set object data format for Hedgehog Engine 2 games. Set object data is a list of objects that should spawn in the stage, such as Springs, Rings, Goal Rings and more.

== File Format ==
It's made up of a list of objects using '''[[Resources/Reflection|Reflection]]''' for their parameters.

Each object containing:

- '''GUID''', unique for every object as its their identifier

- '''Parent GUID''', the object its parented to, referenced by a GUID

- '''Object Name''', the name of the object

- '''Type Name''', name of the object type

- '''Position''', the position of the object

- '''Rotation''', the rotation of the object

- '''Components''', a list of Game Object Components ''(more known as tags),'' they are used to spawn GOComponents for the Game Object such as GOCActivator (RangeSpawning), to determine the Game Objects spawning distance

- '''Parameters''', these are just the parameters of the object, every Object Type has a set of their own, e.g. Springs have a parameter for the velocity for when the player touches them. These are using [[Resources/Reflection|Reflection]]. The reflection resources are included in their entirety (minus BinaryFile container), but the parameter pointer points directly to the data. I.e., in games that use Reflection v2, which contains a small header, the headers are included in the gedit resource, but the pointers point to the internal data object.

== Technical info ==
Structs taken from [https://www.github.com/angryzor/universal-csl universal-csl]<syntaxhighlight lang="c++">
struct ComponentData {
unsigned long long unk1;
const char* type;
unsigned long long size;
void* data; // reflection
};
</syntaxhighlight><syntaxhighlight lang="c++">struct ObjectTransformData {
Position position;
Position rotation;
};

struct ObjectId {
// Forces
unsigned int id{};

// Frontiers and onward
uint64_t objectId{};
uint64_t groupId{};
};

struct ObjectData {
enum class Flag : unsigned int {
DEALLOCATE,
DEALLOCATE_SPAWNER_DATA,
};

Bitset<Flag> flags;
const char* gameObjectClass;
VariableString name; // const char* in Forces
ObjectId id;
ObjectId parentID;
ObjectTransformData transform;
ObjectTransformData localTransform;
Array<ComponentData*> componentData;
void* spawnerData; // reflection
};</syntaxhighlight><syntaxhighlight lang="c++">
struct ObjectWorldData {
unsigned int unk1;
unsigned int unk2;
unsigned char flags;
Array<ObjectData*> objects;
};
</syntaxhighlight>

Resources/ObjectWorld / GEdit

2025-01-27T10:22:50Z

Ashrindy:

{{Infobox Resource|type=[[Resources#Set Objects|Set Objects]]|extension=.gedit|games=* [[Sonic Forces|Sonic Forces]]
* [[Sonic Origins|Sonic Origins]]
* [[Sonic Frontiers|Sonic Frontiers]]
* [[Shadow Generations|Shadow Generations]]|tools=* [[Tools/Blendhog Level Creator|Blendhog Level Creator]]
* [[Tools/DevTools|DevTools]]
* [[Tools/HedgeSet|HedgeSet]]
* [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]]|status=Done|container=BINA|name=Object World}}
'''Object World''' ''(more well known as GEdit)'' is the set object data format for Hedgehog Engine 2 games. Set object data is a list of objects that should spawn in the stage, such as Springs, Rings, Goal Rings and more.

== File Format ==
It's made up of a list of objects using '''[[Resources/Reflection|Reflection]]''' for their parameters.

Each object containing:

- '''GUID''', unique for every object as its their identifier

- '''Parent GUID''', the object its parented to, referenced by a GUID

- '''Object Name''', the name of the object

- '''Type Name''', name of the object type

- '''Position''', the position of the object

- '''Rotation''', the rotation of the object

- '''Components''', a list of Game Object Components ''(more known as tags),'' they are used to spawn GOComponents for the Game Object such as GOCActivator (RangeSpawning), to determine the Game Objects spawning distance

- '''Parameters''', these are just the parameters of the object, every Object Type has a set of their own, e.g. Springs have a parameter for the velocity for when the player touches them. These are using [[Resources/Reflection|Reflection]]. The reflection resources are included in their entirety (minus BinaryFile container), but the parameter pointer points directly to the data. I.e., in games that use Reflection v2, which contains a small header, the headers are included in the gedit resource, but the pointers point to the internal data object.

== Technical info ==
Structs taken from [https://www.github.com/angryzor/universal-csl universal-csl]<syntaxhighlight lang="c++">
struct ComponentData {
unsigned long long unk1;
const char* type;
unsigned long long size;
void* data; // reflection
};
</syntaxhighlight><syntaxhighlight lang="c++">
struct ObjectTransformData {
Position position;
Position rotation;
};

struct ObjectId {
// Forces
unsigned int id{};

// Frontiers and onward
uint64_t objectId{};
uint64_t groupId{};
};

struct ObjectData {
enum class Flag : unsigned int {
DEALLOCATE,
DEALLOCATE_SPAWNER_DATA,
};

Bitset<Flag> flags;
const char* gameObjectClass;
VariableString name; // const char* in Forces
ObjectId id;
ObjectId parentID;
ObjectTransformData transform;
ObjectTransformData localTransform;
Array<ComponentData*> componentData;
void* spawnerData; // reflection
};
</syntaxhighlight><syntaxhighlight lang="c++">
struct ObjectWorldData {
unsigned int unk1;
unsigned int unk2;
unsigned char flags;
Array<ObjectData> objects;
};
</syntaxhighlight>

Resources/Particle Location

2025-01-27T10:05:24Z

Ashrindy:

{{Infobox Resource|type=[[Resources#Effects|Effects]]|extension=.effdb|games=* [[Sonic Forces|Sonic Forces]]
* [[Sonic Origins|Sonic Origins]]
* [[Sonic Frontiers|Sonic Frontiers]]
* [[Shadow Generations|Shadow Generations]]|tools=* [[Tools/AshDumpTool|AshDumpTool]]|status=Done|container=BINA|name=Particle Location}}'''Particle Location''' ''(also known as effdb and Particle Locator)'' is the so called Effect Database format that's used to spawn particles and sound effects for any Animation State. It coincides with the '''[[Resources/Animation State Machine|Animation State Machine]]''' format as it contains an array for every state in that file.

Every state can have any amount of [[Resources/Cyan Effect|particles]] and/or sounds ''(in [[Sonic Forces]] only one sound can be used per state)'' attached to it, every particle can have its own offset in terms of position, rotation and scale.

== File Format ==
It's made up of a list of states each containing a list of particles and sounds.

Each state containing:

- '''State name''', the name of the state it should add onto

- '''Particles''', list of the particles that should be added

- '''Sounds''', list of the sounds that should be used, a simple list of sound names, ''(in [[Sonic Forces]] this is not an array but just a singular sound name)''

Now, each particle contains:

- '''Attached to bone''', decides whetever it should be attached to a bone

- '''Use Position''', decides if it should use the position value

- '''Use Rotation''', decides if it should use the rotation value

- '''Use Scale''', decides if it should use the scale value

- '''Particle Name''', the name of the [[Resources/Cyan Effect|particle (.cemt)]] it should use

- '''Bone name''', the name of the bone it should attach to, won't be used if the Attached to bone is set to false

- '''Position''', a position offset it should attach with, won't be used if the Use Position is set to false

- '''Rotation''', a rotation offset it should attach with, won't be used if the Use Rotation is set to false

- '''Scale''', a scale offset it should attach with, won't be used if the Use Scale is set to false

== Technical info ==
<syntaxhighlight lang="c++">
struct Particle {
enum class Flag : unsigned char {
IGNORE_RELATIVE_POSITION,
USE_POSITION,
USE_ROTATION,
USE_SCALE,
};

bool attachedToBone;
Bitset<Flag> flags;
const char* particleName;
const char* boneName;
Vector3 position;
Quaternion rotation;
Vector3 scale;
};
</syntaxhighlight><syntaxhighlight lang="c++">
struct State {
const char* stateName;
int particleCount;
Particle particles*;
int soundNameCount;
const char** soundNames; // in Forces const char*
};
</syntaxhighlight><syntaxhighlight lang="c++">
struct EffdbData{
unsigned int magic;
unsigned int version;
int stateCount;
State* states;
};
</syntaxhighlight>

Resources

2025-01-26T16:09:04Z

Ashrindy: /* Levels */

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
|
|N/A
|-
|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
|
|}

== 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
|
|-
|[[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
|
|-
|[[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
|
|-
|[[Resources/Visibility Animation|Visibility Animation]]
|Bone visibility animations (presumably Wii VIS0).
|.vis-anim
|ResAnimVis
|
|-
|[[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
|
|-
|[[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
|
|-
|[[Resources/DvScene|DvScene]]
|Cinematics.
|.dvscene
|ResDvScene
|
* [[Tools/010 Editor Binary Templates|010 Editor Binary Templates]]
|-
|[[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
|
|}

== 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
|
|}

Sonic Frontiers/ID Mappings

2025-01-26T16:02:41Z

Ashrindy: /* Characters */

== Worlds ==
{| class="wikitable"
|+World ID Guide
!Letter
!World Type
|-
|r
|Island
|-
|t
|Training/Master Trial
|-
|d
|Cyberspace Level
|-
|f
|Fishing Spot, usually w1
|-
|h
|Hacking Level, usually w1
|-
|b
|Battle Rush Stage
|-
|w1
|Grassy Island
|-
|w2
|Desert Island
|-
|w3
|Volcanic Island
|-
|w4
|Unknown
|-
|w5
|Miscellaneous
|-
|w6
|Green Hill
|-
|w7
|Chemical Plant
|-
|w8
|Sky Sanctuary
|-
|w9
|Eternal Highway
|}
All the IDs have been obtained from '''raw/script/script_resident.pac/stagedata.lua'''.
{| class="wikitable sortable mw-collapsible"
|+World IDs
!Name
!ID
!2D/3D
|-
|[Unused] Alpha Kronos
|w1r01
| -
|-
|[Unused] Beta Kronos
|w1r02
| -
|-
|Kronos Island
|w1r03
|Mixed
|-
|Ares Island
|w2r01
|Mixed
|-
|Chaos Island
|w3r01
|Mixed
|-
|Rhea Island
|w1r05
|Mixed
|-
|Ouranos Island
|w1r04
|Mixed
|-
|Final Horizon Ouranos Island
|w1r06
|3D
|-
|[Unused] Unknown Island
|w4r01
| -
|-
|The End Boss
|w5r01
| -
|-
|Training Room
|w5t01
|3D
|-
|Master Trial Arena
|w5t02
|3D
|-
|1-1
|w6d01
|3D
|-
|1-2
|w8d01
|3D
|-
|1-3
|w9d04
|2D
|-
|1-4
|w6d02
|3D
|-
|1-5
|w7d04
|3D
|-
|1-6
|w6d06
|2D
|-
|1-7
|w9d06
|3D
|-
|2-1
|w6d05
|2D
|-
|2-2
|w8d03
|3D
|-
|2-3
|w7d02
|2D
|-
|2-4
|w7d06
|3D
|-
|2-5
|w8d04
|2D
|-
|2-6
|w6d03
|3D
|-
|2-7
|w8d05
|2D
|-
|3-1
|w6d04
|3D
|-
|3-2
|w6d08
|2D
|-
|3-3
|w8d02
|3D
|-
|3-4
|w6d09
|2D
|-
|3-5
|w6d07
|3D
|-
|3-6
|w8d06
|2D
|-
|3-7
|w7d03
|2D
|-
|4-1
|w7d08
|3D
|-
|4-2
|w9d02
|3D
|-
|4-3
|w7d01
|3D
|-
|4-4
|w9d03
|3D
|-
|4-5
|w6d10
|3D
|-
|4-6
|w7d07
|2D
|-
|4-7
|w9d05
|3D
|-
|4-8
|w7d05
|3D
|-
|4-9
|w9d07
|3D
|-
|4-A [1-4 Remix]
|w6d21
|3D
|-
|4-B [3-1 Remix]
|w6d22
|3D
|-
|4-C [4-5 Remix]
|w6d23
|3D
|-
|4-D [4-3 Remix]
|w7d21
|3D
|-
|4-E [1-5 Remix]
|w7d22
|3D
|-
|4-F [2-4 Remix]
|w7d23
|3D
|-
|4-G [4-2 Remix]
|w9d21
|3D
|-
|4-H [4-4 Remix]
|w9d22
|3D
|-
|4-I [1-7 Remix]
|w9d23
|3D
|}

== Bosses and Minibosses ==
All internal names were obtained from '''"raw\miniboss"''' and '''"raw\boss"'''
{| class="wikitable sortable mw-collapsible"
|+Miniboss Internal Names
!In-Game Name
!Internal Name
|-
|Asura
|Ashura
|-
|Ninja
|Blade
|-
|Caterpillar
|Charger
|-
|Tower
|Daruma
|-
|Squid
|Flyer
|-
|Shark
|Skier
|-
|Spider
|Spider
|-
|Sumo
|Sumo
|-
|Tank
|Tyrant
|-
|Fortress
|Warship
|}

{| class="wikitable sortable mw-collapsible"
|+Boss Internal Names
!In-Game Name
!Internal Name
|-
|Giganto
|Giant
|-
|Wyvern
|Dragon
|-
|Knight
|Knight
|-
|Supreme
|Rifle
|-
|Supreme (The End)
|RifleBeast
|-
|The End
|the_end
|}

== Enemies ==
All internal names were obtained from '''"raw\enemy"'''
{| class="wikitable sortable mw-collapsible"
|+Open Zone Enemy Internal Names
!In-Game Name
!Internal Name
|-
|Soldier
|Jellyman/Man
|-
|Cyclone
|Twister
|-
|Shell
|Defender
|-
|Sniper
|Sniper
|-
|Jellyfish
|Umbrella
|-
|Wolf
|Wolf
|-
|Bubble
|Bubble
|-
|Banger
|Bommer
|-
|Eagle
|Bird
|-
|Capture
|Robber
|-
|Balloon
|Aquaball
|-
|Hopper
|Jumper
|}

{| class="wikitable sortable mw-collapsible"
|+Cyber Space Enemy Internal Names
!In-Game Name
!Internal Name
|-
|Motobug
|Motora
|-
|Buzz Bomber/Buzzer
|Beeton
|-
|Spinner
|SpinnerI
|-
|Chopper
|Batabata
|-
|Egg Robo
|EggRobo
|-
|Crabmeat
|Ganigani
|-
|Spiny
|Lander
|-
|Grabber
|Grabber
|-
|Helicopter
|Helicopter
|-
|Tank
|Tank
|-
|Cannon
|CannonType
|}

== Characters ==
All internal names were obtained from '''"raw/character"'''
{| class="wikitable"
|+Character Internal Name
!Name
!Internal Name
|-
|Cyber Amy
|amy
|-
|Birthday styled Amy
|amy_birthday
|-
|Amy
|amy_orig
|-
|Playable Amy
|amyP
|-
|Ancients
|ancients
|-
|Child Ancients
|ancientschild
|-
|Master King Ancients
|ancientsexpertking
|-
|Ancients General
|ancientsgeneral
|-
|Ancients Senior
|ancientssenior
|-
|Ancients Woman
|ancientswoman
|-
|Big The Cat
|big
|-
|Eggman
|eggman
|-
|Eggman and Eggmobile
|eggmanT
|-
|Eggman and Eggmobile NPC
|eggmobileride
|-
|Cyber Knuckles
|knuckles
|-
|Birthday styled Knuckles
|knuckles_birthday
|-
|Knuckles
|knuckles_orig
|-
|Playable Knuckles
|knucklesP
|-
|Kronos Koco Accessories
|kodamaA
|-
|Ares Koco Accessories
|kodamaB
|-
|Chaos Koco Accessories
|kodamaC
|-
|Birthday Koco Accessories
|kodamabirthday
|-
|Koco Child
|kodamachild
|-
|Koco
|kodamacommon
|-
|Crown Koco
|kodamacrown
|-
|Pilot Koco
|kodamadisciple
|-
|Easter Koco
|kodamaegg
|-
|Elder Koco
|kodamaelder
|-
|FH Elder Koco
|kodamaelder02
|-
|FH Expert/Trial Koco
|kodamaexpert
|-
|FH Master Koco
|kodamaexpertking
|-
|FH Tablet Koco
|kodamahack
|-
|Lover Koco
|kodamalover
|-
|FH Map Koco
|kodamamap
|-
|Mother Koco
|kodamamother
|-
|FH Skill Point Koco
|kodamapeddler
|-
|FH Training Dummy Koco
|kodamapunch
|-
|Soldier Koco
|kodamasoldier
|-
|Hermit Koco
|kodamaster
|-
|FH Hermit Koco
|kodamaster02
|-
|FH Tower Koco
|kodamatower
|-
|Warrior Koco
|kodamawarrior
|-
|Sage
|sage
|-
|Sonic
|sonic
|-
|Birthday styled Sonic
|sonic_birthday
|-
|Sonic with a Crown
|sonic_crown
|-
|Sonic's Board
|sonicboard
|-
|Corrupted Sonic
|soniccyber
|-
|Sonic (unknown changes)
|sonicT
|-
|Super Sonic
|supersonic
|-
|Super Sonic 2
|supersonic2
|-
|Cyber Super Sonic
|supersoniccyber
|-
|Damaged Super Sonic
|supersonicdamage
|-
|Cyber Tails
|tails
|-
|Birthday styled Tails
|tails_birthday
|-
|Tails
|tails_orig
|-
|Shadow Tails
|tails_shadow
|-
|Playable Tails
|tailsP
|}

== DLC ==
{| class="wikitable"
|+
!DLC Name
!ID
|-
|Digital Art Book
|artbook
|-
|Mini Digital Soundtrack
|soundtrack
|-
|Sonic Adventure 2 Shoes
|dlccrm
|-
|Digital Deluxe Edition
|dlcddx
|-
|Monster Hunter Collaboration Pack
|dlcmhr
|-
|Holiday Cheer Suit
|dlcxmas
|}

== Events ==
''Undocumented''

Sonic Frontiers

2025-01-26T15:17:49Z

Ashrindy:

{{Infobox game
| name = Sonic Frontiers
| developer = Sonic Team
| publisher = SEGA
| release_date = November 8, 2022
| engine = Hedgehog Engine 2
|logo=File:Sonic-frontiers.jpg|logo_caption=Sonic Frontiers Key Art}}

'''Sonic Frontiers''' ''(codenamed rangers)'' was released on the 8th of November, 2022.

It uses Hedgehog Engine 2, but has some notable differences to [[Sonic Forces]], the previous game to use HE2, including differences in file structure and file formats used.

* [[Sonic Frontiers/Guides|Guides]]

=== Resource References ===

* [[Sonic Frontiers/Heightmaps|Heightmaps]]
* [[Sonic Frontiers/ID Mappings|ID Mappings]]
* [[Sonic Frontiers/StageData_Parameters|StageData Parameters]]
* [[Sonic Frontiers/Master_Trial_Parameters|Master Trial Parameters]]

File:Sonic-frontiers.jpg

2025-01-26T15:17:08Z

Ashrindy:

Tools/AshDumpTool

2025-01-26T15:13:03Z

Ashrindy:

{{Infobox tool|name=AshDumpTool|purpose=Converting binary formats to XML and back|developer=Ashrindy|download=https://github.com/Ashrindy/AshDumpLib/releases|website=https://github.com/Ashrindy/AshDumpLib|programming_language=C#}}'''AshDumpTool''' is a pack of tools used to convert from a non-human readable format to a more human readable format such as [[wikipedia:XML|XML]].

''Requires [https://dotnet.microsoft.com/en-us/download/dotnet/7.0 .NET 7.0 Runtime]''

[https://github.com/Ashrindy/AshDumpLib/releases Can be found here!]

== Supported formats ==

* [[Resources/Particle Location|Particle Location (.effdb)]]
* [[Resources/Model Pointcloud|Model Pointcloud (.pcmodel)]]
* [[Resources/Collision Pointcloud|Collision Pointcloud (.pccol)]]
* [[Resources/Light Pointcloud|Light Pointcloud (.pcrt)]]
* [[Resources/Density Point Cloud|Density Point Cloud (.densitypointcloud)]]

Sonic Forces

2025-01-26T15:12:28Z

Ashrindy:

{{Infobox game
| name = Sonic Forces
| developer = Sonic Team, Hardlight
| publisher = SEGA
| release_date = November 7, 2017
| engine = Hedgehog Engine 2
|logo=File:Sonic-forces.jpg|logo_caption=Sunset Heights}}

'''Sonic Forces''' ''(codenamed wars)'' was released on the 7th of November, 2017.

It uses Hedgehog Engine 2, and is one of the earliest Sonic games to use it.

File:Sonic-forces.jpg

2025-01-26T15:11:22Z

Ashrindy: Screenshot of Sonic Forces

== Summary ==
Screenshot of Sonic Forces

Tools/DevTools

2025-01-26T15:08:31Z

Ashrindy:

{{Infobox tool
| name = HE2 DevTools
| logo = File:HE2_DevTools_screenshot.jpg
| purpose = Debugging and live editing of resources.
| developer = angryzor
| website = https://github.com/angryzor/sonic-frontiers-devtools
| download = https://github.com/angryzor/sonic-frontiers-devtools/releases
|programming_language=C++|logo_caption=Hot reloading textures}}

'''DevTools''' is a modding and debugging tool that allows you to inspect the engine's internals while ingame. You can use it to troubleshoot issues, edit resources with live feedback and edit [[Resources/ObjectWorld / GEdit|gedit]] levels.

The tool runs on the [[Tools/Restoration Issue Pocketknife|Restoration Issue Pocketknife]] tool for its functions.

Tools/KnuxTools

2025-01-26T15:07:23Z

Ashrindy:

{{Infobox tool|name=KnuxTools|purpose=Converting binary formats to JSON and back|developer=KnuxFan|download=https://github.com/Knuxfan24/KnuxLib/releases|programming_language=C#}}'''KnuxTools''' is a collection of converters in one single application. It's mostly used for [[Resources/Model Pointcloud|PointCloud]], [[Resources/MasterLevel|MasterLevel]] and [[Resources/SplinePath|SplinePath]].

Tools/Restoration Issue Pocketknife

2025-01-26T15:06:58Z

Ashrindy:

{{Infobox tool|name=Restoration Issue Pocketknife|purpose=Converting binary formats to JSON and back|developer=angryzor|website=https://github.com/angryzor/rip|download=https://github.com/angryzor/rip/releases|programming_language=C++}}'''Restoration Issue Pocketknife''', also known as RIP, is used to rip HE2 binary game resources from and to other formats in particular JSON.

Tool created by [https://gamebanana.com/members/729953 angryzor]: https://gamebanana.com/tools/18503

Tools/HedgeEdit

2025-01-26T15:05:44Z

Ashrindy:

{{Infobox tool|name=HedgeEdit|logo=File:Hedgeedit.jpg|purpose=Editing stages, materials, set data, scripts and more.|developer=Radfordhound, Sajid|website=[https://gamebanana.com/wips/48616| HedgeEdit on GameBanana]|logo_caption=w3a01|programming_language=C#}}'''HedgeEdit''' is a standalone level editor app in which you're able to edit the objects, terrain and more. Supports all Hedgehog Engine games up till [[Sonic Forces]].

Tools/modelfbx

2025-01-26T15:01:27Z

Ashrindy:

{{Infobox tool|name=modelfbx|purpose=Converting [[Resources/Model|.models]] to fbx|developer=Darío|download=[https://github.com/DarioSamo/libgens-sonicglvl/blob/master/bin/modelfbx.exe| modelfbx in libgens repository]}}'''modelfbx''' is a tool created by Darío to easily convert Hedgehog Engine .[[Resources/Model|model]] files to the more used format FBX.

Tools/ModelConverter

2025-01-26T14:55:32Z

Ashrindy:

{{Infobox tool|name=Model Converter|purpose=Converting fbx to [[Resources/Model|.models]]|developer=Skyth|website=https://github.com/blueskythlikesclouds/ModelConverter|download=https://github.com/blueskythlikesclouds/ModelConverter/releases}}'''ModelConverter''' is a tool created by Skyth for converting FBX files to .[[Resources/Model|model]] files, with support for all Hedgehog Engine games. Some games utilise the same converter mode; [[Sonic Origins|Origins]] and [[Shadow Generations]] use the [[Sonic Frontiers|Frontiers]] mode.