DS ROM Patcher 3DS

From GameBrew

DS ROM Patcher
Dsrompatcher3ds2.png
General
Authorevandixon
Last Updated2018/01/14
TypeROM Managers and Patchers
Version1.2.0
LicenseMixed
Links
Download
Website
Source

Normaly, distributing ROM hacks for NDS ROMs involves an XDelta patch applied to the entire ROM. 3DS hacks usually involves tedious ROM extraction and file replacement. Patches applied to the ROM as a whole do not support multiple regions of games, and tedious ROM extraction and file replacement is a chore.

DS ROM Patcher is a program that aims to fix that: a single easily-distributable zip file contains everything that's needed to apply a hack to a ROM. The supported input and output formats are the same as in the author's .Net 3DS Toolkit: 3DS, CIA, Hans, and Luma Layered FS.

User guide

System requirements

  • .Net Framework 4.6.2

What is Patch, Mod and Modpack

A patch is the data needed to alter a file without distributing the altered version in its entirety. Certain kinds of patches might be merge-safe, meaning that multiple patches from multiple mods can be applied to the same file.

A mod is a group of file patches that intend to change something about a game. Examples of mods:

  • Removing the border lines in Pokemon games.
  • Changing the moves TMs teach in Pokemon games.
  • Altering Pokemon spawns.
  • Altering Pokemon level progression and other balance concerns.

A modpack is a collection of mods for a particular game, in addition to the tools required to apply them.

Applying a Modpack (GUI)

Applying a modpack is designed to be as user-friendly as possible. Following these steps will result in a modified ROM being created.

  • Extract the distribution zip file.
  • Open DSPatcher.exe.
  • For "Input", choose a ROM compatible with the modpack.
  • Compatible mods will be listed and can be checked or unchecked as desired.
  • Click "Patch" and respond to any prompts.

Applying a Modpack (Automatic)

Modpacks are designed to be applied using automated tools. Using DSPatcher.exe as a code library for applying modpacks is semi-supported, but the general process for calling it is as follows:

  • Extract the distribution zip file.
  • Execute the process DSPatcher.exe <Source ROM> <Output ROM> [-hans]
  • Wait for the process to complete, and <Output ROM> will be the altered version of <Source ROM>

Creating a Modpack

Modpack creation is still under construction, but can be done, albeit more manual steps than ideal. Following these steps will result in a zip file that contains everything needed to apply your ROM hack, with the exception of the .Net Framework 4.6.

Extract the zip file from the latest Github release.

  • (Optional) Use the Patchers > Import Patcher Pack to import any patching tools specific to the game you're modding:
  • XDelta will be used for any file formats without patchers, and these patches will not be merge safe.
  • Take care to ensure the mods in your mod pack do not conflict with each other.
  • Instructions for creating such a patcher pack will be released at a later date

Use the Modpack > Edit Metadata menu option to edit the metadata for your modpack. Click Save when finished.

  • Name is the user-friendly name of your mod.
  • Short name is needed for 3DS games to generate filenames for HANS. The exact requirements are unknown (try to avoid special characters or too lengthy).
  • Author is whomever is responsible for the modpack.
  • Version is a string differentiating this build of the modpack from any others you may have made (no rules, just try to ensure it makes logical sense).
  • System is the system on which the game you're modding runs. Supported values are 3DS and NDS.
  • Game code is a regular expression that matches the game code of any supported game.
    • For 3DS games, this is the 16 digit title ID.
    • For NDS games, this is the 4 letter game code.
    • If the modpack can be safely applied to games from different regions, construct the regular expression to match all supported regions.

Use Modpack > Create Mod. Follow the below steps and repeat for every mod you wish to create.

  • Browse to the original ROM.
  • Browse to the modified ROM.
  • Fill in metadata.
    • ID is any arbitrary string that can differentiate this mod from any others for a particular game (try to make it user-friendly for users and other mod creaters).
    • Friendly name is the name of the mod users will see when applying the modpack.
    • Author is whomever made the changes to the ROM.
    • Description is exactly what it says on the tin: Describe how the ROM will be different after applying this mod.
    • Version is a string differentiating this build of the mod that may have been made (no rules, just try to ensure it makes logical sense).
    • Dependencies are a semi-colon separated list of the IDs of mods that need to be applied before or after this one. Unless you're making a mod of another mod (and the mod was applied to the source ROM to which you've browsed), leave these blank.
    • Game code is a regular expression that matches the game code of any supported game. For 3DS games, this is the 16 digit title ID. For NDS games, this is the 4 letter game code. If the modpack can be safely applied to games from different regions, construct the regular expression to match all supported regions.
  • Choose additional mod creation options.
    • Enable Adds will add any file that's in the modified ROM but not the source ROM to the mod in its entirety. Leave this checked if you want to add files to the ROM.
    • Enable Deletes will delete any file from a ROM if it's in the source ROM but not the modified ROM. Leave this unchecked unless you really want to delete files from the ROM.
  • Click Create, and wait for the dialog to go away.

Use Modpack > Export to create a redistributable zip file that can be used to apply your ROM hack.

Screenshots

dsrompatcher3ds3.png

Changelog

v1.2.0 (Build 111)

  • Add Luma 3DS Layered FS output support.

External links