SA Docs - User contributions [en]

Sonic Adventure/Camera Data

2026-10-19T20:25:12Z

ItsEasyActually: Fixed some broken links in the first table.

Below you will find the current documentation on cameras used within SADX. This article is segmented into a couple of parts to help with understanding the data. If you're looking specifically for information on the camera types

= Structures =

== Camera Entry ==
Camera data can be found inside of the CAM binary files. These files follow the same naming scheme found with SET files. The first two digits are the stage, second two are the act, and the letter at the end is the character.

The files are formatted similarly to SET files as well. Each entry in the file is 0x40 (64) bytes. A "null" cam object is stored initially which indicates the number of cameras inside of the file. The number is stored as an Integer while the rest of the entry is empty.

The actual camera entries are formatted as follows. Each section is explained more in depth later.

{| class="wikitable" style="width:auto";
!Address||Name||Data Type||Description
|-
| 0x00
| scMode
| char
| [[Sonic Adventure/Camera Data#Camera Types|Camera Type]]
|-
| 0x01
| scPriority
| char
| [[Sonic Adventure/Camera Data#Camera Priority|Priority]]
|-
| 0x02
| ucAdjType
| char
| [[Sonic Adventure/Camera Data#Camera Adjustment|Adjustment Type]]
|-
| 0x03
| scColType
| char
| [[Sonic Adventure/Camera Data#Camera Collision|Collision Type]]
|-
| 0x04
| xColAng
| unsigned __int16
| X Collision Angle, Only used by Cube and Plane Collision Types
|-
| 0x06
| yColAng
| unsigned __int16
| Y Collision Angle, Only used by Cube and Plane Collision Types
|-
| 0x08
| xColPos
| float
| X Collision Position, Always Used
|-
| 0x0C
| yColPos
| float
| Y Collision Position, Always Used
|-
| 0x10
| zColPos
| float
| Z Collision Position, Always Used
|-
| 0x14
| xColScl
| float
| X Collision Scale, Used by Cube and Plane Collision Types
|-
| 0x18
| yColScl
| float
| Y Collision Scale, Used by Cube and Plane Collision Types
|-
| 0x1C
| zColScl
| float
| Z Collision Scale, Used by Cube and Sphere Collision Types
|-
| 0x20
| xCamAng
| unsigned __int16
| X Camera Angle, Usage varies per Camera Mode
|-
| 0x22
| yCamAng
| unsigned __int16
| Y Camera Angle, Usage varies per Camera Mode
|-
| 0x24
| xDirPos
| float
| X Target Position, Usage varies per Camera Mode
|-
| 0x28
| yDirPos
| float
| Y Target Position, Usage varies per Camera Mode
|-
| 0x2C
| zDirPos
| float
| Z Target Position, Usage varies per Camera Mode
|-
| 0x30
| xCamPos
| float
| X Camera Position, Usage varies per Camera Mode
|-
| 0x34
| yCamPos
| float
| Y Camera Position, Usage varies per Camera Mode
|-
| 0x38
| zCamPos
| float
| Z Camera Position, Usage varies per Camera Mode
|-
| 0x3C
| fDistance
| float
| Distance to Player, Usage varies per Camera Mode
|}

== Camera Parameters ==
Sonic Adventure takes the data from the [[Sonic Adventure/Camera Data#Camera Entry|Camera Entry]] and applies it to a Camera Parameter struct which is then what is used when setting up a camera. Below is documentation on the Camera Parameters and how the Entry data is applied. These Parameters will be used below to explain how the data is processed in each mode and if it comes from the parameters themselves or hard set from the Camera Mode itself. Most of this isn't major information to know as the tools and game handle most of this. This is simply for documentation purposes.

{| class="wikitable" style="width:auto";
!Address||Name||Data Type||Data Source
|-
| 0x00
| xCamAng
| unsigned __int16
| Taken from CameraEntry->xCamAng
|-
| 0x02
| yCamAng
| unsigned __int16
| Taken from CameraEntry->yCamAng
|-
| 0x04
| xCamPos
| float
| Taken from CameraEntry->xCamPos
|-
| 0x08
| xCamPos
| float
| Taken from CameraEntry->yCamPos
|-
| 0x0C
| xCamPos
| float
| Taken from CameraEntry->zCamPos
|-
| 0x10
| xDirPos
| float
| Taken from CameraEntry->xDirPos
|-
| 0x14
| xDirPos
| float
| Taken from CameraEntry->yDirPos
|-
| 0x18
| xDirPos
| float
| Taken from CameraEntry->zDirPos
|-
| 0x1C
| fDistance
| float
| Taken from CameraEntry->fDistance
|-
| 0x20
| ulTimer
| unsigned int
| Timer that starts when the Camera is activated
|}

= Enums =

== Camera Types ==
There are a total of 75 cameras SADX has. That might sound like a lot, but it's due to most of the cameras having variants that change a few of the additional parameters. Additionally, only about 18 of the camera base types are used in the cam layout files. The rest either go unused or are only used in scripted sequences such as boss fights or cutscenes.

Below is every camera type listed out by ID, name, and the preset values for the level and the direct mode. Each cam name links to specific details for each base camera type. You can find more info on Camera Levels [[Sonic Adventure/Camera Data#Camera Level|here]] and more info on the Direct Mode [[Sonic Adventure/Camera Data#Direct Mode|here]]

{| class="wikitable" style="width:auto";
!ID||Name||Level||Direct Mode
|-
| 0x00
| [[Sonic Adventure/Camera Data#FOLLOW|CAMMD_FOLLOW]]
| CLEVEL_NORMAL
| CDM_TGTOFST
|-
| 0x01
| [[Sonic Adventure/Camera Data#FOLLOW|CAMMD_A_FOLLOW]]
| CLEVEL_AREA
| CDM_TGTOFST
|-
| 0x02
| [[Sonic Adventure/Camera Data#FOLLOW|CAMMD_C_FOLLOW]]
| CLEVEL_COMPULSION
| CDM_TGTOFST
|-
| 0x03
| [[Sonic Adventure/Camera Data#FOLLOW|CAMMD_COL_FOLLOW]]
| CLEVEL_COLLISION
| CDM_TGTOFST
|-
| 0x04
| [[Sonic Adventure/Camera Data#KNUCKLES|CAMMD_KNUCKLES]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x05
| [[Sonic Adventure/Camera Data#KNUCKLES|CAMMD_A_KNUCKLES]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x06
| [[Sonic Adventure/Camera Data#KNUCKLES|CAMMD_C_KNUCKLES]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x07
| [[Sonic Adventure/Camera Data#KNUCKLES|CAMMD_COL_KNUCKLES]]
| CLEVEL_COLLISION
| CDM_LOOKAT
|-
| 0x08
| [[Sonic Adventure/Camera Data#KNUCKLES2|CAMMD_KNUCKLES2]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x09
| [[Sonic Adventure/Camera Data#KNUCKLES2|CAMMD_A_KNUCKLES2]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x0A
| [[Sonic Adventure/Camera Data#KNUCKLES2|CAMMD_C_KNUCKLES2]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x0B
| [[Sonic Adventure/Camera Data#KNUCKLES2|CAMMD_COL_KNUCKLES2]]
| CLEVEL_COLLISION
| CDM_LOOKAT
|-
| 0x0C
| [[Sonic Adventure/Camera Data#MAGONOTE|CAMMD_MAGONOTE]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x0D
| [[Sonic Adventure/Camera Data#MAGONOTE|CAMMD_A_MAGONOTE]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x0E
| [[Sonic Adventure/Camera Data#MAGONOTE|CAMMD_C_MAGONOTE]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x0F
| [[Sonic Adventure/Camera Data#MAGONOTE|CAMMD_COL_MAGONOTE]]
| CLEVEL_COLLISION
| CDM_LOOKAT
|-
| 0x10
| [[Sonic Adventure/Camera Data#SONIC|CAMMD_SONIC]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x11
| [[Sonic Adventure/Camera Data#SONIC|CAMMD_A_SONIC]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x12
| [[Sonic Adventure/Camera Data#SONIC|CAMMD_C_SONIC]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x13
| [[Sonic Adventure/Camera Data#SONIC|CAMMD_COL_SONIC]]
| CLEVEL_COLLISION
| CDM_LOOKAT
|-
| 0x14
| [[Sonic Adventure/Camera Data#ASHLAND|CAMMD_ASHLAND]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x15
| [[Sonic Adventure/Camera Data#ASHLAND|CAMMD_A_ASHLAND]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x16
| [[Sonic Adventure/Camera Data#ASHLAND|CAMMD_C_ASHLAND]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x17
| [[Sonic Adventure/Camera Data#ASHLAND_I|CAMMD_ASHLAND_I]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x18
| [[Sonic Adventure/Camera Data#ASHLAND_I|CAMMD_A_ASHLAND_I]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x19
| [[Sonic Adventure/Camera Data#ASHLAND_I|CAMMD_C_ASHLAND_I]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x1A
| [[Sonic Adventure/Camera Data#FISHING|CAMMD_FISHING]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x1B
| [[Sonic Adventure/Camera Data#FISHING|CAMMD_A_FISHING]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x1C
| [[Sonic Adventure/Camera Data#FIXED|CAMMD_FIXED]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x1D
| [[Sonic Adventure/Camera Data#FIXED|CAMMD_A_FIXED]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x1E
| [[Sonic Adventure/Camera Data#FIXED|CAMMD_C_FIXED]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x1F
| [[Sonic Adventure/Camera Data#KLAMATH|CAMMD_KLAMATH]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x20
| [[Sonic Adventure/Camera Data#KLAMATH|CAMMD_A_KLAMATH]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x21
| [[Sonic Adventure/Camera Data#KLAMATH|CAMMD_C_KLAMATH]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x22
| [[Sonic Adventure/Camera Data#LINE|CAMMD_LINE]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x23
| [[Sonic Adventure/Camera Data#LINE|CAMMD_A_LINE]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x24
| [[Sonic Adventure/Camera Data#NEWFOLLOW|CAMMD_NEWFOLLOW]]
| CLEVEL_NORMAL
| CDM_CAMSTATUS
|-
| 0x25
| [[Sonic Adventure/Camera Data#NEWFOLLOW|CAMMD_A_NEWFOLLOW]]
| CLEVEL_AREA
| CDM_CAMSTATUS
|-
| 0x26
| [[Sonic Adventure/Camera Data#NEWFOLLOW|CAMMD_C_NEWFOLLOW]]
| CLEVEL_COMPULSION
| CDM_CAMSTATUS
|-
| 0x27
| [[Sonic Adventure/Camera Data#POINT|CAMMD_POINT]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x28
| [[Sonic Adventure/Camera Data#POINT|CAMMD_A_POINT]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x29
| [[Sonic Adventure/Camera Data#POINT|CAMMD_C_POINT]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x2A
| [[Sonic Adventure/Camera Data#SONIC_P|CAMMD_SONIC_P]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x2B
| [[Sonic Adventure/Camera Data#SONIC_P|CAMMD_A_SONIC_P]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x2C
| [[Sonic Adventure/Camera Data#SONIC_P|CAMMD_C_SONIC_P]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x2D
| [[Sonic Adventure/Camera Data#ADVERTISE|CAMMD_ADVERTISE]]
| CLEVEL_EVENT
| CDM_TGTOFST
|-
| 0x2E
| [[Sonic Adventure/Camera Data#BACK|CAMMD_BACK]]
| CLEVEL_EVENT
| CDM_CAMSTATUS
|-
| 0x2F
| [[Sonic Adventure/Camera Data#BACK2|CAMMD_BACK2]]
| CLEVEL_EVENT
| CDM_LOOKAT
|-
| 0x30
| [[Sonic Adventure/Camera Data#BUILDING|CAMMD_BUILDING]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x31
| [[Sonic Adventure/Camera Data#CART|CAMMD_CART]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x32
| [[Sonic Adventure/Camera Data#CHAOS|CAMMD_CHAOS]]
| CLEVEL_EVENT
| CDM_CAMSTATUS
|-
| 0x33
| [[Sonic Adventure/Camera Data#CHAOS_P|CAMMD_CHAOS_P]]
| CLEVEL_NORMAL
| CDM_CAMSTATUS
|-
| 0x34
| [[Sonic Adventure/Camera Data#CHAOS_STINIT|CAMMD_CHAOS_STINIT]]
| CLEVEL_NORMAL
| CDM_CAMSTATUS
|-
| 0x35
| [[Sonic Adventure/Camera Data#CHAOS_STD|CAMMD_CHAOS_STD]]
| CLEVEL_NORMAL
| CDM_CAMSTATUS
|-
| 0x36
| [[Sonic Adventure/Camera Data#CHAOS_W|CAMMD_CHAOS_W]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x37
| [[Sonic Adventure/Camera Data#E101R|CAMMD_E101R]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x38
| [[Sonic Adventure/Camera Data#E103|CAMMD_E103]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x39
| [[Sonic Adventure/Camera Data#EGM3|CAMMD_EGM3]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x3A
| [[Sonic Adventure/Camera Data#FOLLOW_G|CAMMD_FOLLOW_G]]
| CLEVEL_NORMAL
| CDM_TGTOFST
|-
| 0x3B
| [[Sonic Adventure/Camera Data#FOLLOW_G|CAMMD_A_FOLLOW_G]]
| CLEVEL_AREA
| CDM_TGTOFST
|-
| 0x3C
| [[Sonic Adventure/Camera Data#LR|CAMMD_LR]]
| CLEVEL_EVENT
| CDM_LOOKAT
|-
| 0x3D
| [[Sonic Adventure/Camera Data#COLLI|CAMMD_COLLI]]
| CLEVEL_COLLISION
| CDM_LOOKAT
|-
| 0x3E
| [[Sonic Adventure/Camera Data#RuinWaka1|CAMMD_RuinWaka1]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x3F
| [[Sonic Adventure/Camera Data#SNOWBOARD|CAMMD_SNOWBOARD]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x40
| [[Sonic Adventure/Camera Data#SURVEY|CAMMD_SURVEY]]
| CLEVEL_COLLISION
| CDM_CAMSTATUS
|-
| 0x41
| [[Sonic Adventure/Camera Data#TAIHO|CAMMD_TAIHO]]
| CLEVEL_NORMAL
| CDM_CAMSTATUS
|-
| 0x42
| [[Sonic Adventure/Camera Data#TORNADE|CAMMD_TORNADE]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x43
| [[Sonic Adventure/Camera Data#TWO_HARES|CAMMD_TWO_HARES]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x44
| [[Sonic Adventure/Camera Data#LEAVE|CAMMD_LEAVE]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x45
| [[Sonic Adventure/Camera Data#AVOID|CAMMD_AVOID]]
| CLEVEL_NORMAL
| CDM_LOOKAT
|-
| 0x46
| [[Sonic Adventure/Camera Data#AVOID|CAMMD_A_AVOID]]
| CLEVEL_AREA
| CDM_LOOKAT
|-
| 0x47
| [[Sonic Adventure/Camera Data#AVOID|CAMMD_C_AVOID]]
| CLEVEL_COMPULSION
| CDM_LOOKAT
|-
| 0x48
| [[Sonic Adventure/Camera Data#AVOID|CAMMD_COL_AVOID]]
| CLEVEL_COLLISION
| CDM_LOOKAT
|-
| 0x49
| [[Sonic Adventure/Camera Data#EDITOR|CAMMD_EDITOR]]
| CLEVEL_DEBUG
| CDM_TGTOFST
|-
| 0x4A
| [[Sonic Adventure/Camera Data#GURIGURI|CAMMD_GURIGURI]]
| CLEVEL_DEBUG
| CDM_TGTOFST
|-
| 0x4B
| [[Sonic Adventure/Camera Data#PATHCAM|CAMMD_PATHCAM]]
| CLEVEL_EVENT
| CDM_CAMSTATUS
|-
| 0x4C
| [[Sonic Adventure/Camera Data#KOSCAM|CAMMD_KOSCAM]]
| CLEVEL_COLLISION
| CDM_CAMSTATUS
|}

=== Camera Level ===
This sets how the camera acts when the player intersects with the set boundaries for the camera.

{| class="wikitable" style="width:auto";
!ID||Name||Description
|-
| 0x00
| CLEVEL_NORMAL
| Standard, activates the camera when interacting with the bounds
|-
| 0x01
| CLEVEL_AREA
| Camera is only active when inside the camera bounds
|-
| 0x02
| CLEVEL_EVENT
| Non-standard, used for cameras being used for events or special cameras
|-
| 0x03
| CLEVEL_COMPULSION
| No functional difference from Area
|-
| 0x04
| CLEVEL_COLLISION
| Pushes the camera outside of the of bounds
|-
| 0x05
| CLEVEL_DEBUG
| Not used
|}

=== Direct Mode ===

{| class="wikitable" style="width:auto";
!ID||Name||Description
|-
| 0x00
| CDM_NONE
| No calculations
|-
| 0x01
| CDM_TGTOFST
| Calculates Position from the Target, Distance, and Angle
|-
| 0x02
| CDM_LOOKAT
| Copies Position and Calculates the Angle from the Target
|-
| 0x03
| CDM_CAMSTATUS
| Directly copies the Position and Angle only
|}

== Camera Priority ==
The Cam Priority is how cameras interact with others when their bounding areas overlap. The camera with a higher value will be the priority when passing through its boundaries.

== Camera Adjustment ==
The Cam Adjustment is how the camera will ease between the active camera and the next camera the player enters. Below is a list of all of the adjustment types.

'''Editor's Note: Descriptions will come. These are kind of hard to explain. The commonly used one tends to be the RELATIVE3'''

{| class="wikitable" style="width:auto";
!ID||Name||Description
|-
| 0x00
| CAMADJ_NONE
| No transition, camera will snap into the next location.
|-
| 0x01
| CAMADJ_NORMAL
|
|-
| 0x02
| CAMADJ_NORMAL_S
|
|-
| 0x03
| CAMADJ_SLOW
|
|-
| 0x04
| CAMADJ_SLOW_S
|
|-
| 0x05
| CAMADJ_TIME
|
|-
| 0x06
| CAMADJ_THREE1
|
|-
| 0x07
| CAMADJ_THREE1C
|
|-
| 0x08
| CAMADJ_THREE2
|
|-
| 0x09
| CAMADJ_THREE2C
|
|-
| 0x0A
| CAMADJ_THREE3
|
|-
| 0x0B
| CAMADJ_THREE3C
|
|-
| 0x0C
| CAMADJ_THREE4
|
|-
| 0x0D
| CAMADJ_THREE4C
|
|-
| 0x0E
| CAMADJ_THREE5
|
|-
| 0x0F
| CAMADJ_THREE5C
|
|-
| 0x10
| CAMADJ_RELATIVE1
|
|-
| 0x11
| CAMADJ_RELATIVE1C
|
|-
| 0x12
| CAMADJ_RELATIVE2
|
|-
| 0x13
| CAMADJ_RELATIVE2C
|
|-
| 0x14
| CAMADJ_RELATIVE3
|
|-
| 0x15
| CAMADJ_RELATIVE3C
|
|-
| 0x16
| CAMADJ_RELATIVE4
|
|-
| 0x17
| CAMADJ_RELATIVE4C
|
|-
| 0x18
| CAMADJ_RELATIVE5
|
|-
| 0x19
| CAMADJ_RELATIVE5C
|
|-
| 0x1A
| CAMADJ_RELATIVE6C
|
|-
| 0x1B
| CAMADJ_FORFREECAMERA
|
|}

== Camera Collision ==
Cameras have three types of collision they rely on to use as boundaries for the player to come into contact with for activation.

{| class="wikitable" style="width:auto";
!ID||Name||Description
|-
| 0x00
| CAMCOL_SPHERE
| Sphere, uses Collision Scale Z to set scale.
|-
| 0x01
| CAMCOL_PLANE
| Plane, uses Collision Scale X and Y to set scale.
|-
| 0x02
| CAMCOL_BLOCK
| Cube, uses Collision Scale XYZ to set scale.
|}

= Camera Modes Explained =
Below is a more in-depth look at the different Camera Modes that are used in the game. The Data and Usage tables are shared with how SALVL is currently formatted. This has the potential to change in the future. As such, the below table shows which [parameters](#camera-parameters) are for each common name in the event things change in the future.

{| class="wikitable" style="width:auto";
!Common Name||Parameter Name
|-
| Camera Angle X
| xCamAng
|-
| Camera Angle Y
| yCamAng
|-
| Target Position X
| xDirPos
|-
| Target Position Y
| yDirPos
|-
| Target Position X
| zDirPos
|-
| Camera Position X
| xCamPos
|-
| Camera Position Y
| yCamPos
|-
| Camera Position Z
| zCamPos
|-
| Distance
| fDistance
|}

== FOLLOW ==
* Simply follows the player. Can be rotated using the triggers. Does not rotate on its own.
* '''Parameters are not used.'''

== KNUCKLES ==
* Follows the player and adjusts rotation based on player movement.
* '''Parameters are not used.'''

== KNUCKLES2 ==
* Same as [[Sonic Adventure/Camera Data#KNUCKLES|KNUCKLES]] except it has additional angle and position calculations.
* '''Parameters are not used'''

== MAGONOTE ==
* Very close to the player. Attempts to calculate a little bit ahead of the player when the player moves.
* '''Parameters are not used.'''

== SONIC ==
* Follows the player and will zoom in and out based on player speed.
* Additional Notes: Sets up Deadzone and Distance values to calculate the camera zoom and has modifier angles to help keep the camera smooth.
* Min Deadzone: 20.0f
* Max Deadzone: 90.0f
* Min Distance: 35.0f
* Max Distance: 60.0f
* Center X Angle: 0xFFFFF1C8
* Center Steady: 0x00
* '''Parameters are not used.'''

== ASHLAND ==
* Fixed point camera, follows the player's movement while active.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Unused
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Unused
|-
| Target Position Y
| Unused
|-
| Target Position X
| Unused
|-
| Camera Position X
| Sets Camera X Position
|-
| Camera Position Y
| Sets Camera Y Position
|-
| Camera Position Z
| Sets Camera Z Position
|-
| Distance
| Unused
|}

== ASHLAND_I ==
* Just like [[Sonic Adventure/Camera Data#ASHLAND|ASHLAND]] except it does not check the LR flag.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Unused
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Unused
|-
| Target Position Y
| Unused
|-
| Target Position X
| Unused
|-
| Camera Position X
| Sets Camera X Position
|-
| Camera Position Y
| Sets Camera Y Position
|-
| Camera Position Z
| Sets Camera Z Position
|-
| Distance
| Unused
|}

== FISHING ==
* Called by the fishing game, should not be used in normal cam files.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== FIXED ==
* Fixed camera position and target. No influence from the player.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Unused
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Sets the Target Position X
|-
| Target Position Y
| Sets the Target Position Y
|-
| Target Position Z
| Sets the Target Position Z
|-
| Camera Position X
| Sets the Camera Position X
|-
| Camera Position Y
| Sets the Camera Position Y
|-
| Camera Position Z
| Sets the Camera Position Z
|-
| Distance
| Unused
|}

== KLAMATH ==
* Focuses on target horizontally, keeps the player in the center of the view. Checks geometry and camera collisions.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Vertical distance override, multiplied by 0.1f
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Sets the Target Position X
|-
| Target Position Y
| Unused
|-
| Target Position Z
| Sets the Target Position Z
|-
| Camera Position X
| Unused
|-
| Camera Position Y
| Unused
|-
| Camera Position Z
| Unused
|-
| Distance
| Distance from player, multiplied by 0.5f. Except vertically if Angle X is set.
|}

== LINE ==
* Follows player and has a target point. Camera doesn't move vertically.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Unused
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Sets the Target X Position
|-
| Target Position Y
| Unused
|-
| Target Position Z
| Sets the Target Z Position
|-
| Camera Position X
| Unused
|-
| Camera Position Y
| Unused
|-
| Camera Position Z
| Unused
|-
| Distance
| Unused
|}

== NEWFOLLOW ==
* Camera doesn't function properly. It spins at the player's location on screen.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== POINT ==
* Targets a point and keeps the player between the camera and the point. Checks geometry and camera collisions.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| If not 0, ignores collision with geometry
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Sets the Target X Position
|-
| Target Position Y
| Sets the Target Y Position
|-
| Target Position Z
| Sets the Target Z Position
|-
| Camera Position X
| Unused
|-
| Camera Position Y
| Unused
|-
| Camera Position Z
| Unused
|-
| Distance
| Distance from player
|}

== SONIC_P ==
* Same as the [[Sonic Adventure/Camera Data#SONIC|Sonic]] camera except it's customizable.
* Additional Notes: Sets up Deadzone and Distance values to calculate the camera zoom and has modifier angles to help keep the camera smooth. See below table for how the parameters are used for the Deadzone and Distance.

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Camera Center X Angle
|-
| Camera Angle Y
| Camera Steady
|-
| Target Position X
| Maximum Deadzone
|-
| Target Position Y
| Minimum Distance
|-
| Target Position Z
| Maximum Distance
|-
| Camera Position X
| Unused
|-
| Camera Position Y
| Unused
|-
| Camera Position Z
| Unused
|-
| Distance
| Minimum Deadzone
|}

== ADVERTISE ==
* This camera is broken. It sits at the world origin (0,0,0) and does not rotate.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== BACK ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== BACK2 ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== BUILDING ==
* Focuses in front of the player on the Y Axis. Observed player from "above." It's what is used when the player is normally playing in Speed Highway Act 2.
* '''Parameters are not used.'''
* '''Only used in Speed Highway 2'''

== CART ==
* Only usable when inside of a cart otherwise it remains static where it spawns.
* '''Parameters are not used.'''
* '''Only used in Twinkle Park 1'''

== CHAOS ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for Chaos Boss Fights, not for normal gameplay.'''

== CHAOS_P ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for Chaos Boss Fights, not for normal gameplay.'''

== CHAOS_STINIT ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for Chaos Boss Fights, not for normal gameplay.'''

== CHAOS_STD ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for Chaos Boss Fights, not for normal gameplay.'''

== CHAOS_W ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for Chaos Boss Fights, not for normal gameplay.'''

== E101R ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for the E-101r Boss, not for normal gameplay.'''

== E103 ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for the E-Series Fights, not for normal gameplay.'''

== EGM3 ==
* '''Crashes the Game in normal gameplay, DO NOT USE'''
* '''Parameters are not used.'''
* '''Scripted Camera for the Eggman Bosses, not for normal gameplay.'''

== FOLLOW_G ==
* Functions almost identically to the normal [[Sonic Adventure/Camera Data#FOLLOW|Follow]] cam.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== LR ==
* Functions similarly to [[Sonic Adventure/Camera Data#FOLLOW|Follow]] except it will respect level geometry and collision. It will get stuck in walls and sometimes snap into position if the player moves away too quickly.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== COLLI ==
* This is used only for helping prevent the camera from phasing into level geometry. It acts as collision that only the camera will react to.

== RuinWaka1 ==
* Used in the waterfall section of Lost World. Not intended for use outside of this level.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== SNOWBOARD ==
* Follows very close to the player and reacts quickly to any movement the player makes. You can see it in action in the snowboarding levels when the camera is behind the player.
* '''Parameters are not used.'''
* '''Only used in Icecap 3 and Sandboarding'''

== SURVEY ==
* Top down camera that follows the player.
* '''Parameters are not used.'''

== TAIHO ==
* First person camera. Not intended to use in the set file, can either lock the camera or send it off into space.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== TORNADE ==
* Rotates to follow the player while keeping the player mostly in line with the camera. Target acts like a fulcrum for the camera to pivot with. Does not work well if the player goes above or is below the Y Target position as the camera will move in the opposite direction.
* '''Only used in Windy Valley 2'''

{| class="wikitable" style="width:auto";
!Data||Usage
|-
| Camera Angle X
| Unused
|-
| Camera Angle Y
| Unused
|-
| Target Position X
| Sets the Target X Position
|-
| Target Position Y
| Sets the Target Y Position
|-
| Target Position Z
| Sets the Target Z Position
|-
| Camera Position X
| Unused
|-
| Camera Position Y
| Added to the player position to set the camera's Y position
|-
| Camera Position Z
| Unused
|-
| Distance
| Sets a modifier for calculating distance between the Camera and Target
|}

== TWO_HARES ==
* This camera is non-functional.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== LEAVE ==
* This camera is non-functional.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== AVOID ==
* Change the Camera's mode based on the avoid flag currently set. Examples of this can be found in Casinopolis being used for doorways.
* '''Parameters are not used.'''

== EDITOR ==
* This originally would have been used for editing the camera's data, but the functionality for it was stripped out. It crashes the game now.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== GURIGURI ==
* Acts like a first person camera, not intended for use by CAM files.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== PATHCAM ==
* Follows a path if available, not intended for use by CAM files.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

== KOSCAM ==
* Functions just like [[Sonic Adventure/Camera Data#SURVEY|Survey]] cams.
* '''Parameters are not used.'''
* '''Not used by the base game cam files.'''

{{SA1Navbox}}

SADX Mod Loader

2026-08-24T00:29:27Z

ItsEasyActually: Updating page, adding Character Welds page link

You can view the [https://github.com/X-Hax/sadx-mod-loader/ source code] here.

On this page, you'll find documentation on the main API that the SADX Mod Loader exports to every code based mod created for SADX. There are additional features which are documented on other pages. You can follow the below links to find documentation on those features.

[[SADX Mod Loader/Character Welds|Character Welds]]
= HelperFunctions API =

== Struct ==
Below is the initialized version of the HelperFunctions struct. For the definition of the struct, you can find that in [https://github.com/X-Hax/sadx-mod-loader/blob/master/SADXModLoader/include/SADXModInfo.h SADXModInfo.h]
{{DocHeader|header=HelperFunctions|content=
<syntaxhighlight lang="cpp">
HelperFunctions helperFunctions =
{
ModLoaderVer,
&RegisterStartPosition,
&ClearStartPositionList,
&RegisterFieldStartPosition,
&ClearFieldStartPositionList,
&RegisterPathList,
&ClearPathListList,
&RegisterCharacterPVM,
&ClearCharacterPVMList,
&RegisterCommonObjectPVM,
&ClearCommonObjectPVMList,
&RegisterTrialLevel,
&ClearTrialLevelList,
&RegisterTrialSubgame,
&ClearTrialSubgameList,
&GetMainSavePath,
&GetChaoSavePath,
&GetReplaceablePath,
&_ReplaceFile,
&SetWindowTitle,
&RegisterSoundList,
&RegisterMusicFile,
&LoadEXEData,
&LoadDLLData,
&_ReplaceFileForce,
&PushScaleUI,
&PopScaleUI,
&SetScaleFillMode,
&GetScaleFillMode,
&ReplaceTexture,
&MipmapBlacklistGBIX,
&RegisterEnglishVoiceDuration,
&RegisterJapaneseVoiceDuration,
&RegisterCharacterWelds,
&loaderSettings,
&modList,
&weightFuncs,
&RegisterVoice,
&PushInterpolationFix,
&PopInterpolationFix,
&RegisterPermanentTexlist,
&ExpandPVMList,
&UnreplaceFile,
&PrintDebugUnicode,
&PrintDebugLocal,
&PrintDebugCodepage,
&GetFileModIndex,
&ReplaceFileAtIndex
};
</syntaxhighlight>
}}

{{Note|text=Please be aware that all examples on this page will be using <code>helperFunctions</code> which is how the variable is sent to a mod.|type=info}}
== Properties ==

=== Mod Loader Version ===
<syntaxhighlight lang="cpp">
int ModLoaderVer;
</syntaxhighlight>

This returns the version of the mod loader. This can be used to check if the user has an old version of the mod loader that may not have functionality your mod requires.
{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
if (helperFunctions.ModLoaderVer <= 10)
PrintDebug("This Mod Loader is way out of date.\n");
</syntaxhighlight>
}}

=== Mod Loader Settings ===
<syntaxhighlight lang="cpp">
LoaderSettings loaderSettings;
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Mod List ===
<syntaxhighlight lang="cpp">
std::vector<Mod> modlist;
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Weight Functions ===
<syntaxhighlight lang="cpp">
BasicWeightFuncs weightFuncs;
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}
== Functions ==

=== Register Start Position ===
<syntaxhighlight lang="cpp">
static void RegisterStartPosition(unsigned char character, const StartPosition& position)
</syntaxhighlight>

Registers a new Start Position for the specified character.
{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
StartPosition myStageStartPos = {
1, // Level ID
0, // Act ID
{ 100.0f, 200.0f, 100.0f }, // Position
0 // Y Rotation
};

// We pass our StagePosition variable as a pointer to this function
// and we have specified Sonic, so the level for this ID would now use
// our StartPosition instead of the original.
helperFunctions.RegisterStartPosition(Characters_Sonic, &myStageStartPos);
</syntaxhighlight>
}}

=== Clear Start Position List ===
<syntaxhighlight lang="cpp">
static void ClearStartPositionList(unsigned char character)
</syntaxhighlight>

Clears the Start Positions for the specified character.
{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// Running this inside of your mod's Init export would
// clear all of Sonic's Start Positions for his stages.
helperFunctions.ClearStartPositionList(Characters_Sonic);
</syntaxhighlight>
}}

=== Register Field Position ===
<syntaxhighlight lang="cpp">
static void RegisterFieldStartPosition(unsigned char character, const FieldStartPosition& position)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Clear Field Start Position List ===
<syntaxhighlight lang="cpp">
static void ClearFieldStartPositionList(unsigned char character)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Path List ===
<syntaxhighlight lang="cpp">
static void RegisterPathList(const PathDataPtr& paths)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Clear Path List List ===
<syntaxhighlight lang="cpp">
static void ClearPathListList()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Character PVM ===
<syntaxhighlight lang="cpp">
static void RegisterCharacterPVM(unsigned char character, const PVMEntry& pvm)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Clear Character PVM List ===
<syntaxhighlight lang="cpp">
static void ClearCharacterPVMList(unsigned char character)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Common Object PVM ===
<syntaxhighlight lang="cpp">
static void RegisterCommonObjectPVM(const PVMEntry& pvm)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Clear Common Object PVM List ===
<syntaxhighlight lang="cpp">
static void ClearCommonObjectPVMList()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Trial Level ===
<syntaxhighlight lang="cpp">
static void RegisterTrialLevel(unsigned char character, const TrialLevelListEntry& level)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Clear Trial Level List ===
<syntaxhighlight lang="cpp">
static void ClearTrialLevelList(unsigned char character)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Trial Subgame ===
<syntaxhighlight lang="cpp">
static void RegisterTrialSubgame(unsigned char character, const TrialLevelListEntry& level)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Clear Trial Subgame List ===
<syntaxhighlight lang="cpp">
static void ClearTrialSubgameList(unsigned char character)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Get Main Save Path ===
<syntaxhighlight lang="cpp">
static const char* GetMainSavePath()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Get Chao Save Path ===
<syntaxhighlight lang="cpp">
static const char* GetChaoSavePath()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Get Replaceable Path ===
<syntaxhighlight lang="cpp">
const char* __cdecl GetReplaceablePath(const char* path)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Replace File ===
<syntaxhighlight lang="cpp">
void _ReplaceFile(const char* src, const char* dst)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Set Window Title ===
<syntaxhighlight lang="cpp">
void SetWindowTitle(const char* title)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Sound List ===
<syntaxhighlight lang="cpp">
int RegisterSoundList(const SoundList& list)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Music File ===
<syntaxhighlight lang="cpp">
int RegisterMusicFile(const MusicInfo& track)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Load EXE Data ===
<syntaxhighlight lang="cpp">
void LoadEXEData(const wchar_t* filename, const wchar_t* mod_dir)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Load DLL Data ===
<syntaxhighlight lang="cpp">
void LoadDLLData(const wchar_t* filename, const wchar_t* mod_dir)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Replace File Force ===
<syntaxhighlight lang="cpp">
void _ReplaceFileForce(const char* src, const char* dst)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Push Scale UI ===
<syntaxhighlight lang="cpp">
void PushScaleUI(uiscale::Align align, bool is_background, float ratio_h, float ratio_v)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Pop Scale UI ===
<syntaxhighlight lang="cpp">
void PopScaleUI()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Set Scale Fill Mode ===
<syntaxhighlight lang="cpp">
void SetScaleFillMode(uiscale::FillMode mode)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Get Scale Fill Mode ===
<syntaxhighlight lang="cpp">
uiscale::FillMode GetScaleFillMode()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Replace Texture ===
<syntaxhighlight lang="cpp">
void ReplaceTexture(const char* pvm_name, const char* tex_name, const char* file_path, uint32_t gbix, uint32_t width, uint32_t height)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Mipmap Blacklist GBIX ===
<syntaxhighlight lang="cpp">
void MipmapBlacklistGBIX(Uint32 index)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register English Voice Duration ===
<syntaxhighlight lang="cpp">
void RegisterEnglishVoiceDuration(const uint16_t voiceID, const uint16_t duration)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Japanese Voice Duration ===
<syntaxhighlight lang="cpp">
void RegisterJapaneseVoiceDuration(const uint16_t voiceID, const uint16_t duration)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Character Welds ===
<syntaxhighlight lang="cpp">
void RegisterCharacterWelds(const uint8_t character, const char* iniPath)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Voice ===
<syntaxhighlight lang="cpp">
uint16_t RegisterVoice(const char* fileJP, const char* fileEN, uint16_t durationJP, uint16_t durationEN)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Push Interpolation Fix ===
<syntaxhighlight lang="cpp">
void PushInterpolationFix()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Pop Interpolation Fix ===
<syntaxhighlight lang="cpp">
void PopInterpolationFix()
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Register Permanent Texlist ===
<syntaxhighlight lang="cpp">
void RegisterPermanentTexlist(NJS_TEXLIST* texlist)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Unreplace File ===
<syntaxhighlight lang="cpp">
void UnreplaceFile(const char* file)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Expand PVM List ===
<syntaxhighlight lang="cpp">
TEX_PVMTABLE* ExpandPVMList(TEX_PVMTABLE* sourcepvmlist, const TEX_PVMTABLE &newpvmentry)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Unreplace File ===
<syntaxhighlight lang="cpp">
void UnreplaceFile(const char* file)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Print Debug Unicode ===
<syntaxhighlight lang="cpp">
void PrintDebugUnicode(char* utf8)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Print Debug Local ===
<syntaxhighlight lang="cpp">
void PrintDebugLocal(char* buf)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Print Debug Codepage ===
<syntaxhighlight lang="cpp">
void PrintDebugCodepage(char* buf, unsigned int source_cp)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Get File Mod Index ===
<syntaxhighlight lang="cpp">
int GetFileModIndex(const char* path)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

=== Replace File At Index ===
<syntaxhighlight lang="cpp">
void ReplaceFileAtIndex(const char* src, const char* dst, int modIndex)
</syntaxhighlight>

{{DocHeader|header=Example|content=
<syntaxhighlight lang="cpp">
// TODO: Write example.
</syntaxhighlight>
}}

Creating Mods/Mod Configuration

2026-08-21T02:54:38Z

ItsEasyActually: Adding images.

The Mod Manager is capable of creating configuration files, saved as <code>config.ini</code> in a mod folder, through a Mod Config system it has built in. This requires mods to supply a <code>configschema.xml</code> within their mod folders. This is what defines the Groups, Properties, and custom Enumerations that can be used for creating a configuration file for a mod to make use of.

If you're looking to create a codeless configuration system (it uses an in-built system in the mod loader for redirecting the system folders for loading), you can head over to the Codeless Configuration Setup section.

If you want a more advanced system for Configuration that requires code, please check out the Code Configuration Setup section.

== Config Schema ==
The Config Schema is an XML file that the Mod Manager will read from to generate the various elements used for a config file. Below is an example Config Schema followed by a break down on each element within a schema file.
<syntaxhighlight lang="xml">


<?xml version="1.0"?>
<ConfigSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sonicretro.org">
<Groups>
<Group name="config" display="Configuration">
<Property name="speed" display="Speed Value" type="float" defaultvalue="10">
<HelpText>Sets the speed for a custom object.</HelpText>
</Property>
<Property name="object" display="Object Type" type="ObjectType" defaultvalue="cub">
<HelpText>Sets the object model that is used.</HelpText>
</Property>
</Group>
</Groups>
<Enums>
<Enum name = "ObjectType">
<EnumMember name="cub" display="Cube" />
<EnumMember name="sph" display="Sphere" />
<EnumMember name="cyl" display="Cylinder" />
</Enum>
</Enums>
</ConfigSchema>
</syntaxhighlight>

=== Groups ===
Groups are groupings of properties that will be saved to a configuration file. They are wrapped inside of a base <code>Groups</code> element. All <code>Group</code> elements must be placed inside of the <code>Groups</code> element, just like how it is displayed in the example above.

* <code>name</code>: This is the name that is written as the Group's name within the config file. '''This is required.'''
* <code>display</code>: Optional name that will overwrite the displayed name in the Editor within the Mod Manager which can make it easier for users to read.

==== Properties ====
Properties are the actual variables written to a config file. These will always be wrapped inside of a <code>Group</code> element.

* <code>name</code>: The name of the property that will be written to the config file. '''This is required.'''
* <code>display</code>: Optional name that will overwrite the name when displaying the property in the Mod Manager if it's included.
* <code>type</code>: The type of property this is. Below is a list of currently valid types supported by the Mod Manager and Mod Loaders. '''This is required.'''
** <code>bool</code>: A boolean value. Valid values are <code>true</code> or <code>false</code>.
** <code>int</code>: An integer value. Valid values are any integer value.
** <code>float</code>: A floating point value. Valid values are any floating point value.
** <code>string</code>: A text value. Valid values are a string.
** <code>"enum"</code>: Enum types need to match the name of the <code>Enum</code> they correspond to. These are also the only supported type for Codeless Configuration. Valid values are the list of members of the specified <code>Enum</code> type.
* <code>defaultvalue</code>: This is the default value used by the property. It must be a valid value type for the supplied type. '''It is required.'''
* <code>min</code>: Optional value setting the minimum value. This is only used for <code>int</code> and <code>float</code> types.
* <code>max</code>: Optional value setting the maximum value. This is only used for <code>int</code> and <code>float</code> types.
* <code>alwaysinclude</code>: Optional boolean that, when set to true, forces the Manager to always write the property to the config file regardless of if it matches the default value or not.

===== HelpText =====
The <code>HelpText</code> element is used by a <code>Property</code> to supply a description or "helper" text to the user within the Mod Manager's editor. These are handled by doing.
<syntaxhighlight lang="xml">
<HelpText>This is how the helper text should be written.</HelpText>
</syntaxhighlight>
Please see the full Config Schema example above to see how these should be written within a <code>Property</code>.

=== Enums ===
Just like with <code>Group</code> elements being wrapped in a <code>Groups</code> element, <code>Enum</code> elements are wrapped inside of an <code>Enums</code> element.

* <code>name</code>: This sets the reference name to the <code>Enum</code> within the Mod Manager's editor. This has no impact on the written config file, but '''it is still required.'''

==== EnumMembers ====
These are the entries, or options, within an <code>Enum</code> that are utilized in the editor and are what get written to the config file when the <code>Enum</code> type is used in a property. Despite being sharing a name with enums, these are actually more like preset lists of strings that can be used.

* <code>name</code>: This is what is written as the value for a <code>Property</code> making use of an <code>Enum</code> type. '''This is required.'''
* <code>display</code>: Optional name that will be displayed in the editor when supplied.

----
Note: While any text editor can be used for writing a Config Schema file, it's recommended to use one that supports writing XML, such as Notepad++ or VSCodium.

== Codeless Configuration Setup ==
Codeless Configuration is an option for mod developers that want to include customizable asset replacement without needing to use code. As such, these are limited to ''solely'' asset replacement and have specific formatting that needs to be followed for the Mod Loader to correctly handle the asset loading redirection. They '''can''' be used in tandem with code mods that include other configuration options without the mod needing to implement its own custom asset redirection however.

=== Getting Started ===
There are two ways to setup the prerequisites needed for Codeless Configuration; using the Mod Manager or editing <code>mod.ini</code> manually. Please follow the directions for the method you wish to use.

==== Using the Mod Manager ====
In the Mod Manager, either create a new mod, use the Edit Mod option on an existing mod. This will open the Edit Mod window. In this window, locate the Include Directories entry. This is where you create the initial defaults and create the fallback folder IDs that will be stored inside the mod's <code>mod.ini</code> file. You can create multiple options for modifying different assets at the same time by separating each entry with a comma.
[[File:Example 1 for Codeless Configuration.png|center]]
In this example, the <code>sonic_sword</code> option is for editing Sonic's model while the <code>altmusica</code> would be for editing music files.

==== Manually Adding Defaults ====
If you want to edit <code>mod.ini</code> manually so you can create the sub folders as you need them, simply open your mod's folder and open <code>mod.ini</code> in a text editor of your choice. You will then need to add a new Section named "Config." Under this Section, you can create as many "Include Directories" as you need. These are formatted as <code>IncludeDirX</code> where X is the ID number. These begin as index 0. You will also need to include an <code>IncludeDirCount</code> which is the total number of directories you have setup. In our example, the following is how <code>mod.ini</code> looks:

<syntaxhighlight lang="ini">
Name=Example Codeless Config
Author=ItsEasyActually
Version=0.1
ModID=sadx.ExampleCodelessConfig
[Config]
IncludeDir0=sonic_sword
IncludeDir1=altmusica
IncludeDirCount=2
</syntaxhighlight>

=== Folder Structure ===
In your mod's folder, the default folders you just added should now be visible in the mod folder unless you modified <code>mod.ini</code> manually. This example will continue with the expectation that you have folders matching those examples.
[[File:Codeless Config Example 2.png|center]]
These sub folders act like a base mod folder which means they can contain any of the same folders a mod can contain, including the following:
* <code>system</code> (SADX only)
* <code>gd_PC</code> (SA2 only)
* <code>textures</code>
* <code>replacetex</code>

They can also contain any of the exported INI files from the SA Tools, such as <code>sonic_data.ini</code> or <code>sonic2app_data.ini</code>.

The folders that were created are just the default folders as well. You can create additional folders to be used for these options which are how you get into having multiple options for asset replacement.

For Codeless Config mods, the base <code>system</code> (<code>gd_PC</code> in SA2), <code>textures</code>, and <code>replacetex</code> folders are always loaded first if they exist ('''They are not required, just generated by default when making a mod with the Mod Manager'''). The Mod Loader will then load from any of the alternative directories (if valid) second. This allows users the option of having an "invalid" folder name as their default to only load from their base folders.

==== Real World Example ====
The Sprite Rings mod for SADX is a good example of a real mod making use of this system. Below is a screenshot of that mod's folder:
[[File:Codeless Config Example 3.png|center]]
In this example, every folder (excluding <code>system</code> and <code>textures</code>) contains a variation of sprite assets inside their own <code>system</code> and <code>textures</code> folders.

The Sprite Rings mod for SADX also makes use of the "invalid" folder setup by labeling its default as <code>classic</code> but no folder with that name actually exists.

=== Creating the Config Schema ===
Creating a config schema to include the directory options is relatively straight forward. Properties can be stored inside of any <code>Group</code> within the Config Schema files as the Mod Loader will search through all <code>Groups</code> looking for a matching property to the expected <code>Property</code> name.

The expected <code>Property</code> names should match the variables setup in the mod's Config section of its <code>mod.ini</code> file, ie <code>IncludeDirX</code> where X is the corresponding index. In our example, <code>sonic_sword</code> is the default option for <code>IncludeDir0</code> while <code>altmusica</code> is the default option for <code>IncludeDir1</code>.

Making use of <code>Enums</code> is the best way to setup the <code>Property</code> types as it controls what the folder names are without the user needing to do anything further. The <code>name</code> field in an <code>EnumMember</code> needs to match the folder name to work properly.

<syntaxhighlight lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<ConfigSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sonicretro.org">
<Groups>
<Group name="options" display="Example Options">
<Property name="IncludeDir0" type="model" display="Sonic Outfit" defaultvalue="sonic_sword">
<HelpText>Select the outfit you want Sonic to use.</HelpText>
</Property>
<Property name="IncludeDir1" type="music" display="Sonic Theme" defaultvalue="altmusica">
<HelpText>Select the theme you want to be used for Sonic.</HelpText>
</Property>
</Group>
</Groups>
<Enums>
<Enum name="model">
<EnumMember name="sonic_sword" display="Sonic with Gauntlet (from SatBK)" />
<EnumMember name="sonic_ring" display="Sonic with Ring (from SatSR)" />
</Enum>

<Enum name="music">
<EnumMember name="altmusica" display="Knight of the Wind" />
<EnumMember name="altmusicb" display="Seven Rings in Hand" />
</Enum>
</Enums>
</ConfigSchema>
</syntaxhighlight>

In the end, this is how the overall folder looks after creating the Config Schema, adding the additional folder options, and removing the <code>system</code> folder as it was not needed:
[[File:Codeless Config Example 4.png|center]]

=== Best Practices ===
Default options inside the Config Schema should match the defaults within your mod's INI file. Failing to due so may result in unintended behavior where the Mod Loader will continue to load whatever the option set in the mod's INI is set to. This is because the Mod Loader checks for a <code>config.ini</code> file and loads info from there. If it is not located, it sets the default directory to load as the one found in <code>mod.ini</code> as that is the fallback.

----

== Code based Configuration Setup ==

{{Note|text=This section will be added at a later date|type=info}}

File:Codeless Config Example 4.png

2026-08-21T02:54:17Z

ItsEasyActually:

Example of the final folder setup for the example mod for Codeless Config once all of the work has been done to set it up.

File:Codeless Config Example 3.png

2026-08-21T02:53:25Z

ItsEasyActually:

Real World example of Codeless Config taken from the Sprite Rings mod for SADX.

File:Codeless Config Example 2.png

2026-08-21T02:52:30Z

ItsEasyActually:

Example of the mod folder immediately after creating it from the Mod Manager.

File:Example 1 for Codeless Configuration.png

2026-08-21T02:49:09Z

ItsEasyActually:

Displays the Mod Manager Mod Editor window with Include Directories.

Creating Mods/Mod Configuration

2026-08-21T02:46:49Z

ItsEasyActually: Initial publishing of this page.

The Mod Manager is capable of creating configuration files, saved as <code>config.ini</code> in a mod folder, through a Mod Config system it has built in. This requires mods to supply a <code>configschema.xml</code> within their mod folders. This is what defines the Groups, Properties, and custom Enumerations that can be used for creating a configuration file for a mod to make use of.

If you're looking to create a codeless configuration system (it uses an in-built system in the mod loader for redirecting the system folders for loading), you can head over to the Codeless Configuration Setup section.

If you want a more advanced system for Configuration that requires code, please check out the Code Configuration Setup section.

== Config Schema ==
The Config Schema is an XML file that the Mod Manager will read from to generate the various elements used for a config file. Below is an example Config Schema followed by a break down on each element within a schema file.
<syntaxhighlight lang="xml">


<?xml version="1.0"?>
<ConfigSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sonicretro.org">
<Groups>
<Group name="config" display="Configuration">
<Property name="speed" display="Speed Value" type="float" defaultvalue="10">
<HelpText>Sets the speed for a custom object.</HelpText>
</Property>
<Property name="object" display="Object Type" type="ObjectType" defaultvalue="cub">
<HelpText>Sets the object model that is used.</HelpText>
</Property>
</Group>
</Groups>
<Enums>
<Enum name = "ObjectType">
<EnumMember name="cub" display="Cube" />
<EnumMember name="sph" display="Sphere" />
<EnumMember name="cyl" display="Cylinder" />
</Enum>
</Enums>
</ConfigSchema>
</syntaxhighlight>

=== Groups ===
Groups are groupings of properties that will be saved to a configuration file. They are wrapped inside of a base <code>Groups</code> element. All <code>Group</code> elements must be placed inside of the <code>Groups</code> element, just like how it is displayed in the example above.

* <code>name</code>: This is the name that is written as the Group's name within the config file. '''This is required.'''
* <code>display</code>: Optional name that will overwrite the displayed name in the Editor within the Mod Manager which can make it easier for users to read.

==== Properties ====
Properties are the actual variables written to a config file. These will always be wrapped inside of a <code>Group</code> element.

* <code>name</code>: The name of the property that will be written to the config file. '''This is required.'''
* <code>display</code>: Optional name that will overwrite the name when displaying the property in the Mod Manager if it's included.
* <code>type</code>: The type of property this is. Below is a list of currently valid types supported by the Mod Manager and Mod Loaders. '''This is required.'''
** <code>bool</code>: A boolean value. Valid values are <code>true</code> or <code>false</code>.
** <code>int</code>: An integer value. Valid values are any integer value.
** <code>float</code>: A floating point value. Valid values are any floating point value.
** <code>string</code>: A text value. Valid values are a string.
** <code>"enum"</code>: Enum types need to match the name of the <code>Enum</code> they correspond to. These are also the only supported type for Codeless Configuration. Valid values are the list of members of the specified <code>Enum</code> type.
* <code>defaultvalue</code>: This is the default value used by the property. It must be a valid value type for the supplied type. '''It is required.'''
* <code>min</code>: Optional value setting the minimum value. This is only used for <code>int</code> and <code>float</code> types.
* <code>max</code>: Optional value setting the maximum value. This is only used for <code>int</code> and <code>float</code> types.
* <code>alwaysinclude</code>: Optional boolean that, when set to true, forces the Manager to always write the property to the config file regardless of if it matches the default value or not.

===== HelpText =====
The <code>HelpText</code> element is used by a <code>Property</code> to supply a description or "helper" text to the user within the Mod Manager's editor. These are handled by doing.
<syntaxhighlight lang="xml">
<HelpText>This is how the helper text should be written.</HelpText>
</syntaxhighlight>
Please see the full Config Schema example above to see how these should be written within a <code>Property</code>.

=== Enums ===
Just like with <code>Group</code> elements being wrapped in a <code>Groups</code> element, <code>Enum</code> elements are wrapped inside of an <code>Enums</code> element.

* <code>name</code>: This sets the reference name to the <code>Enum</code> within the Mod Manager's editor. This has no impact on the written config file, but '''it is still required.'''

==== EnumMembers ====
These are the entries, or options, within an <code>Enum</code> that are utilized in the editor and are what get written to the config file when the <code>Enum</code> type is used in a property. Despite being sharing a name with enums, these are actually more like preset lists of strings that can be used.

* <code>name</code>: This is what is written as the value for a <code>Property</code> making use of an <code>Enum</code> type. '''This is required.'''
* <code>display</code>: Optional name that will be displayed in the editor when supplied.

----
Note: While any text editor can be used for writing a Config Schema file, it's recommended to use one that supports writing XML, such as Notepad++ or VSCodium.

== Codeless Configuration Setup ==
Codeless Configuration is an option for mod developers that want to include customizable asset replacement without needing to use code. As such, these are limited to ''solely'' asset replacement and have specific formatting that needs to be followed for the Mod Loader to correctly handle the asset loading redirection. They '''can''' be used in tandem with code mods that include other configuration options without the mod needing to implement its own custom asset redirection however.

=== Getting Started ===
There are two ways to setup the prerequisites needed for Codeless Configuration; using the Mod Manager or editing <code>mod.ini</code> manually. Please follow the directions for the method you wish to use.

==== Using the Mod Manager ====
In the Mod Manager, either create a new mod, use the Edit Mod option on an existing mod. This will open the Edit Mod window. In this window, locate the Include Directories entry. This is where you create the initial defaults and create the fallback folder IDs that will be stored inside the mod's <code>mod.ini</code> file. You can create multiple options for modifying different assets at the same time by separating each entry with a comma.

''PICTURE''

In this example, the <code>sonic_sword</code> option is for editing Sonic's model while the <code>altmusica</code> would be for editing music files.

==== Manually Adding Defaults ====
If you want to edit <code>mod.ini</code> manually so you can create the sub folders as you need them, simply open your mod's folder and open <code>mod.ini</code> in a text editor of your choice. You will then need to add a new Section named "Config." Under this Section, you can create as many "Include Directories" as you need. These are formatted as <code>IncludeDirX</code> where X is the ID number. These begin as index 0. You will also need to include an <code>IncludeDirCount</code> which is the total number of directories you have setup. In our example, the following is how <code>mod.ini</code> looks:

<syntaxhighlight lang="ini">
Name=Example Codeless Config
Author=ItsEasyActually
Version=0.1
ModID=sadx.ExampleCodelessConfig
[Config]
IncludeDir0=sonic_sword
IncludeDir1=altmusica
IncludeDirCount=2
</syntaxhighlight>

=== Folder Structure ===
In your mod's folder, the default folders you just added should now be visible in the mod folder unless you modified <code>mod.ini</code> manually. This example will continue with the expectation that you have folders matching those examples.

''PICTURE''

These sub folders act like a base mod folder which means they can contain any of the same folders a mod can contain, including the following:
* <code>system</code> (SADX only)
* <code>gd_PC</code> (SA2 only)
* <code>textures</code>
* <code>replacetex</code>

They can also contain any of the exported INI files from the SA Tools, such as <code>sonic_data.ini</code> or <code>sonic2app_data.ini</code>.

The folders that were created are just the default folders as well. You can create additional folders to be used for these options which are how you get into having multiple options for asset replacement.

For Codeless Config mods, the base <code>system</code> (<code>gd_PC</code> in SA2), <code>textures</code>, and <code>replacetex</code> folders are always loaded first if they exist ('''They are not required, just generated by default when making a mod with the Mod Manager'''). The Mod Loader will then load from any of the alternative directories (if valid) second. This allows users the option of having an "invalid" folder name as their default to only load from their base folders.

==== Real World Example ====
The Sprite Rings mod for SADX is a good example of a real mod making use of this system. Below is a screenshot of that mod's folder:

''PICTURE''

In this example, every folder (excluding <code>system</code> and <code>textures</code>) contains a variation of sprite assets inside their own <code>system</code> and <code>textures</code> folders.

The Sprite Rings mod for SADX also makes use of the "invalid" folder setup by labeling its default as <code>classic</code> but no folder with that name actually exists.

=== Creating the Config Schema ===
Creating a config schema to include the directory options is relatively straight forward. Properties can be stored inside of any <code>Group</code> within the Config Schema files as the Mod Loader will search through all <code>Groups</code> looking for a matching property to the expected <code>Property</code> name.

The expected <code>Property</code> names should match the variables setup in the mod's Config section of its <code>mod.ini</code> file, ie <code>IncludeDirX</code> where X is the corresponding index. In our example, <code>sonic_sword</code> is the default option for <code>IncludeDir0</code> while <code>altmusica</code> is the default option for <code>IncludeDir1</code>.

Making use of <code>Enums</code> is the best way to setup the <code>Property</code> types as it controls what the folder names are without the user needing to do anything further. The <code>name</code> field in an <code>EnumMember</code> needs to match the folder name to work properly.

<syntaxhighlight lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<ConfigSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.sonicretro.org">
<Groups>
<Group name="options" display="Example Options">
<Property name="IncludeDir0" type="model" display="Sonic Outfit" defaultvalue="sonic_sword">
<HelpText>Select the outfit you want Sonic to use.</HelpText>
</Property>
<Property name="IncludeDir1" type="music" display="Sonic Theme" defaultvalue="altmusica">
<HelpText>Select the theme you want to be used for Sonic.</HelpText>
</Property>
</Group>
</Groups>
<Enums>
<Enum name="model">
<EnumMember name="sonic_sword" display="Sonic with Gauntlet (from SatBK)" />
<EnumMember name="sonic_ring" display="Sonic with Ring (from SatSR)" />
</Enum>

<Enum name="music">
<EnumMember name="altmusica" display="Knight of the Wind" />
<EnumMember name="altmusicb" display="Seven Rings in Hand" />
</Enum>
</Enums>
</ConfigSchema>
</syntaxhighlight>

In the end, this is how the overall folder looks after creating the Config Schema, adding the additional folder options, and removing the <code>system</code> folder as it was not needed:

''PICTURE''

=== Best Practices ===
Default options inside the Config Schema should match the defaults within your mod's INI file. Failing to due so may result in unintended behavior where the Mod Loader will continue to load whatever the option set in the mod's INI is set to. This is because the Mod Loader checks for a <code>config.ini</code> file and loads info from there. If it is not located, it sets the default directory to load as the one found in <code>mod.ini</code> as that is the fallback.

----

== Code based Configuration Setup ==

{{Note|text=This section will be added at a later date|type=info}}