Jump to content

Dreamcast Image Builder/Modding Games: Difference between revisions

From SA Docs
mNo edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
This guide explains how to use Dreamcast Image Builder to apply mods and create modified GDI or CDI images of Dreamcast games.
This guide explains how to use Dreamcast Image Builder to apply mods and create modified GDI or CDI images of Dreamcast games.


== Building a Modified Game Image ==
== Selecting the Game and Output Path ==
 
=== Selecting the Game ===
Switch to the <code>Games</code> tab and select the game you would like to mod in the games list.
Switch to the <code>Games</code> tab and select the game you would like to mod in the games list.


Line 11: Line 9:


If the GDI is the correct version, you will see a confirmation below saying this is the correct version.
If the GDI is the correct version, you will see a confirmation below saying this is the correct version.
 
[[File:Dreamcast Image Builder 1760355682738.png|none|thumb|Correct game version selected]]
=== Selecting the Output Path and the Emulator ===
In <code>Select the output path for the patched image</code>, locate the folder where you would like the patched game to be built. It can be any folder that can be written to without admin rights (not in <code>C:\Program Files</code>) on a drive that has enough space for the GDI and temporary files (about 3.2GB for Sonic Adventure).
In <code>Select the output path for the patched image</code>, locate the folder where you would like the patched game to be built. It can be any folder that can be written to without admin rights (not in <code>C:\Program Files</code>) on a drive that has enough space for the GDI and temporary files (about 3.2GB for Sonic Adventure).


(Optional) Switch to the <code>Options</code> tab and in <code>Location</code> under <code>Emulator Settings</code> select the path to <code>demul.exe</code>, <code>redream.exe</code> or <code>flycast.exe</code>. <br />'''Depending on the game and mod, some mods may only work on specific emulators, and/or not work on hardware.'''
== Selecting the Emulator (Optional) ==
Switch to the <code>Options</code> tab and in <code>Location</code> under <code>Emulator Settings</code> select the path to <code>demul.exe</code>, <code>redream.exe</code> or <code>flycast.exe</code>.
[[File:Dreamcast Image Builder 1760355847185.png|none|thumb|Selecting the emulator]]
'''Depending on the game and mod, some mods may only work on specific emulators, and/or not work on hardware.'''


=== Selecting the Mods ===
== Selecting Mods ==
Switch to the <code>Mods</code> tab and check the mods you would like to apply.  <br />'''Dreamcast Image Builder comes with some built-in mods. See Adding Mods on how to add mods made by other people.'''  '''If a <code>...</code> button appears on the right when a mod is selected, it means this mod has configurable options (submods). Click the <code>...</code> button to toggle submods.'''
Switch to the <code>Mods</code> tab and check the mods you would like to apply.  <br />'''Dreamcast Image Builder comes with some built-in mods. See Adding Mods on how to add mods made by other people.'''  '''If a <code>...</code> button appears on the right when a mod is selected, it means this mod has configurable options (submods). Click the <code>...</code> button to toggle submods.'''
[[File:Dreamcast Image Builder 1760355558635.png|none|thumb|Selecting mods]]


=== Selecting the Codes ===
== Selecting Codes ==
Switch to the <code>Codes</code> tab (if applicable) and select the codes you would like to apply.  <br />'''Codes are only available for the flycast emulator.'''  '''If the <code>Codes</code> tab does not appear, it means the game doesn't have a codes file at the moment.'''
Switch to the <code>Codes</code> tab (if applicable) and select the codes you would like to apply.   
[[File:Dreamcast Image Builder 1760355601652.png|none|thumb|Selecting codes]]
'''Codes are only available for the flycast emulator.'''  '''If the <code>Codes</code> tab does not appear, it means the game doesn't have a codes file at the moment.'''


=== Building the Image ===
== Building the Image ==
Switch to the <code>Build Image</code> tab. Check the <code>CDI</code> checkbox at the bottom (if applicable) if you want a CDI file, or leave it unchecked if you want a GDI file.  '''If the <code>CDI</code> checkbox is greyed out, CDI support is not implemented for this game at the moment.'''
Switch to the <code>Build Image</code> tab. Check the <code>CDI</code> checkbox at the bottom (if applicable) if you want a CDI file, or leave it unchecked if you want a GDI file.  '''If the <code>CDI</code> checkbox is greyed out, CDI support is not implemented for this game at the moment.'''


Line 29: Line 32:
* You can click the <code>Stop</code> button to abort the build process.
* You can click the <code>Stop</code> button to abort the build process.
If you clicked <code>Build & Run</code>, the emulator will run automatically. If you have located the emulator in the <code>Options</code> tab, you can also use the <code>Run</code> and <code>Stop</code> buttons to run and terminate the emulator at any time.
If you clicked <code>Build & Run</code>, the emulator will run automatically. If you have located the emulator in the <code>Options</code> tab, you can also use the <code>Run</code> and <code>Stop</code> buttons to run and terminate the emulator at any time.
[[File:Dreamcast Image Builder 1760355893536.png|none|thumb|Building an image]]

Latest revision as of 12:46, 13 October 2025

This guide explains how to use Dreamcast Image Builder to apply mods and create modified GDI or CDI images of Dreamcast games.

Selecting the Game and Output Path

Switch to the Games tab and select the game you would like to mod in the games list.

In Select the input path to the original GDI, locate the folder containing the original GDI file.

Only TOSEC GDI and Redump CUE dumps are supported at the moment.

If the GDI is the correct version, you will see a confirmation below saying this is the correct version.

Correct game version selected

In Select the output path for the patched image, locate the folder where you would like the patched game to be built. It can be any folder that can be written to without admin rights (not in C:\Program Files) on a drive that has enough space for the GDI and temporary files (about 3.2GB for Sonic Adventure).

Selecting the Emulator (Optional)

Switch to the Options tab and in Location under Emulator Settings select the path to demul.exe, redream.exe or flycast.exe.

Selecting the emulator

Depending on the game and mod, some mods may only work on specific emulators, and/or not work on hardware.

Selecting Mods

Switch to the Mods tab and check the mods you would like to apply.
Dreamcast Image Builder comes with some built-in mods. See Adding Mods on how to add mods made by other people. If a ... button appears on the right when a mod is selected, it means this mod has configurable options (submods). Click the ... button to toggle submods.

Selecting mods

Selecting Codes

Switch to the Codes tab (if applicable) and select the codes you would like to apply.

Selecting codes

Codes are only available for the flycast emulator. If the Codes tab does not appear, it means the game doesn't have a codes file at the moment.

Building the Image

Switch to the Build Image tab. Check the CDI checkbox at the bottom (if applicable) if you want a CDI file, or leave it unchecked if you want a GDI file. If the CDI checkbox is greyed out, CDI support is not implemented for this game at the moment.

Click Save Settings at the bottom. Then click Build or Build & Run. Wait for the process to finish.

  • You can click the Stop button to abort the build process.

If you clicked Build & Run, the emulator will run automatically. If you have located the emulator in the Options tab, you can also use the Run and Stop buttons to run and terminate the emulator at any time.

Building an image