Jump to content

Creating Mods/Mod Testing: Difference between revisions

From SA Docs
mNo edit summary
mNo edit summary
Line 10: Line 10:
* <code>--level <name/ID></code> or <code>-l <name/ID></code> to launch the game directly into a level. Click [[Sonic Adventure/Level List|here]] for a list of all levels.
* <code>--level <name/ID></code> or <code>-l <name/ID></code> to launch the game directly into a level. Click [[Sonic Adventure/Level List|here]] for a list of all levels.
* <code>--act <ID></code> or <code>-a <ID></code> to start the level into a specific act.
* <code>--act <ID></code> or <code>-a <ID></code> to start the level into a specific act.
* <code>--time <nowiki><time></nowiki></code> or <code>-t <nowiki><time></nowiki></code> to start the game on a specific time of day (Adventure Fields). The value can be <code>day</code> or <code>0</code>, <code>evening</code> or <code>1</code>, or <code>night</code> or <code>2</code>.
* <code>--gamemode <mode></code> or <code>-g <mode></code> to start the game in a specific mode. The mode can be as follows: <code>adventure</code> (<code>5</code>), <code>trial</code> (<code>9</code>), <code>stage</code> (<code>4</code>), <code>mission</code> (<code>10</code>).
* <code>--character <name/ID></code> or <code>-c <name/ID></code> to change the default character. Click [[Sonic Adventure/Character List|here]] for a list of all characters.
* <code>--character <name/ID></code> or <code>-c <name/ID></code> to change the default character. Click [[Sonic Adventure/Character List|here]] for a list of all characters.
* <code>--position <x> <y> <z></code> or <code>-p <x> <y> <z></code> to spawn at a specific position.
* <code>--position <x> <y> <z></code> or <code>-p <x> <y> <z></code> to spawn at a specific position.
* <code>--rotation <r></code> or <code>-r <r></code> to rotate the character along the Y axis. The value is the BAMS rotation (decimal).
* <code>--event <ev></code> or <code>-e <ev></code> to play a specific cutscene. See [[Sonic Adventure/List of Events|List of Cutscenes]] for usable IDs.
* <code>--save <name/ID></code> or <code>-s <name/ID></code> to launch the game with a specific savefile. The ID is the number after "SonicDX" in the savefile name. You can also put the name of the save file (e.g. "mysave" from <code>mysave.snc</code>) in quotation marks instead of the ID.
* <code>--save <name/ID></code> or <code>-s <name/ID></code> to launch the game with a specific savefile. The ID is the number after "SonicDX" in the savefile name. You can also put the name of the save file (e.g. "mysave" from <code>mysave.snc</code>) in quotation marks instead of the ID.
* <code>--movie <ID></code> or <code>-m <ID></code> to play a specific FMV cutscene. The value can range from <code>0</code> to <code>8</code>.


=== Option commands ===
=== Option commands ===


* <code>--no-audio</code> to disable musics, voices and sound effects.
* <code>--no-audio</code> to disable music, voices and sound effects.
* <code>--no-music</code> to disable musics.
* <code>--no-music</code> to disable music.
* <code>--no-voice</code> to disable voices.
* <code>--no-voice</code> to disable voices.
* <code>--no-sound</code> to disable sound effects.
* <code>--no-sound</code> to disable sound effects.

Revision as of 08:02, 13 October 2025

Using Test Spawn

To test your mod, you can use the Mod Manager's Test Spawn tab (make sure developer settings are enabled in the Manager Config tab) to bypass all menus and put a specific character in any stage or cutscene. You can also specify a save file override or set up a specific position in the stage.

SA Mod Manager's Test Spawn Tab

Using Command Line Parameters

You can also you can launch sonic.exe with the following command line parameters.

Level commands

  • --level <name/ID> or -l <name/ID> to launch the game directly into a level. Click here for a list of all levels.
  • --act <ID> or -a <ID> to start the level into a specific act.
  • --time <time> or -t <time> to start the game on a specific time of day (Adventure Fields). The value can be day or 0, evening or 1, or night or 2.
  • --gamemode <mode> or -g <mode> to start the game in a specific mode. The mode can be as follows: adventure (5), trial (9), stage (4), mission (10).
  • --character <name/ID> or -c <name/ID> to change the default character. Click here for a list of all characters.
  • --position <x> <y> <z> or -p <x> <y> <z> to spawn at a specific position.
  • --rotation <r> or -r <r> to rotate the character along the Y axis. The value is the BAMS rotation (decimal).
  • --event <ev> or -e <ev> to play a specific cutscene. See List of Cutscenes for usable IDs.
  • --save <name/ID> or -s <name/ID> to launch the game with a specific savefile. The ID is the number after "SonicDX" in the savefile name. You can also put the name of the save file (e.g. "mysave" from mysave.snc) in quotation marks instead of the ID.
  • --movie <ID> or -m <ID> to play a specific FMV cutscene. The value can range from 0 to 8.

Option commands

  • --no-audio to disable music, voices and sound effects.
  • --no-music to disable music.
  • --no-voice to disable voices.
  • --no-sound to disable sound effects.