seiyria / Types-of-Mania

A mod for Trials of Mana that allows users to create their own difficulty settings and more.

Trials of Mania

A difficulty modifier tool for Trials of Mana. This tool lets you edit stats for any creature in a convenient way with a convenient UI.

Party Builder

Interested in building a party to go with your higher difficulty? Check out this handy tool!

Features

• Allows for changing of the following stats via a multiplier: hp, mp, atk, def, agi, int, spr, luck, offMag, defMag, exp, lucre, drop1, drop2, drop3.
• Allows for global changes, or specific boss, monster, or shinju enemies.
• Allows for specific enemy changes for fine-tuning specific enemies using specific creature names or level ranges.
• Has a very simple build process, which allows for automatic installation to your mod directory.
• Supports a config file for easy sharing of configs.
• Supports CLI arguments for easy copy/paste setups.

Usage

CLI

The CLI allows you to specify custom overrides without messing with config.yml. It is very flexible, and lets you specify any key/subkey as follows:

• --version will just print the current version of the app.
• --dumpData will dump monster names and item names.
• --dumpStats will dump all monster stats in CSV format with the pak file.
• --config <config.yml> will load a config from a specified path. Default: config/config.yml.
• --configJson <json> will load a config from a stringifed JSON object. Mutually exclusive with loading a config.yml file.
• --pakName <pakName> will designate the output .pak file name. Default: TypesOfMania_P.
• --unrealPak <UnrealPak.exe> will search for UnrealPak.exe in the specified path. Default: buildtools/UnrealPak.exe or UnrealPak.exe.
• --seed <num> will set the RNG seed for randomizing. Default: completely random.
• --installTo <path> will automatically move the completed pak to your ~mod folder. Default: C:\Program Files (x86)\Steam\steamapps\common\Trials of Mana.
• --base.<stat> <multiplier> will set the base stat multiplier to multiplier.
• --boss.<stat> <multiplier> will set the boss stat multiplier to multiplier.
• --monster.<stat> <multiplier> will set the monster stat multiplier to multiplier.
• --shinju.<stat> <multiplier> will set the shinju stat multiplier to multiplier.
• --part.<stat> <multiplier> will set the part stat multiplier to multiplier.

The valid stat keys you can set can be found in config.yml.

To pass these in to npm start, do this (for example): npm start -- --base.xp 1 --base.hp 3 (notice the first set of -- before the args are passed in).

config.yml

The config/config.yml file can be modified to add any of the keys you would normally pass via the CLI. It also features the ability to single out specific monsters for scaling. For example, you could do this:

specific:
  MAGICIAN_LV16:
    exp: 10

This would make monsters that are MAGICIAN_LV16 give 10x their normal exp. The name for the creature comes out of the JSON files in the gamedata folder.

You can also do this:

specific:
  lv[0-9][^0-9]:
    hp: 0.8
  
  lv[1][0-9]:
    hp: 3

This uses the enhanced feature for specifics that allows you to use regex to filter out a creature name and apply stats - it's somewhat like a filter. In this case, this would set the HP value to creatures that have Lv0 through Lv9 in their internal name to 80% of their max, and creatures that have Lv10 through Lv19 in their internal name to 3x their max HP. This can be used to better fine-tune the stats for different level ranges.

This will apply to all enemies that have Lv10 through Lv19 in their internal name, and make their HP 300%.

Please note that not all enemies have Lv in their internal name, so this method captures a lot of creatures, but isn't fool-proof.

You can also capture enemies by their internal id. Here are some examples:

specific:
  ENEMYBOSS_01_01: # first FullmetalHugger fight
    hp: 3
  
  ENEMYBOSS_01_02: # second FullmetalHugger fight
    hp: 4
  
  ENEMYBOSS_01_03: # third FullmetalHugger fight
    hp: 5

This would scale the FullmetalHugger creatures HP progressively with each fight.

Using a different syntax, instead of multiplying the creatures stat, you can instead set it to a specific value. As an example:

specific:
  MAGICIAN_LV16:
    exp: @1000

This would set the MAGICIAN_LV16 creature to always give exactly 1000 experience on kill.

Shinju

We don't know entirely what Shinju relates to, but it seems like Shinju might relate specifically to Benevedons. If your Benevedons are not taking boss multiplier boosts, try modifying the Shinju area. If this is confirmed to be only Benevedons, the UI will be updated to clarify.

Finished Pak Files

Copy the built TypesOfMania_P.pak file from the build folder into the Trials of Mana/Content/Paks/~mod folder. If the ~mod folder does not already exist, you'll have to make it. Alternatively, to do this automatically, you can use the --installTo option.

Development

You need to install NodeJS. The latest version is always recommended.

Setup

• npm i

Commands

• npm start (runs the configurator with default config)

Building

• npm run build:js (only compiles the TS to JS)
• npm run build:cli (only compiles the JS to a CLI package for all platforms)
• npm run release:all (runs the configurator with default config and builds release files for all platforms)
• npm run release:nexus (runs the configurator with default config and builds a zip for updating the nexus mod)

Included JSON Files

The JSON files included in this repo are built from a Serializer from this project tailored towards Bloodstained. They're included because it's much easier than having to extract them.

UnrealPak

We can't bundle UnrealPak with this repo, but you can get it from here (link courtesy of the Bloodstained discord).

Unzip the file and grab Tools/UnrealPak/UnrealPak.exe folder and put it in buildtools (the directory may have to be created). The final folder structure should be buildtools/UnrealPak.exe.

Future Features

• Verbose stat edit logs
• Edit healing item potency
• Item shop randomizer (w/ seeds)
• Item randomization (w/ seeds)
• Item drop randomization (w/ seeds)
• Monster randomization (w/ seeds)
• Monster ability randomization (w/ seeds)
• Item-specific drop rate multiplier boosts
• Tests

If you or someone you know can help get the Bloodstained Serializer working in reverse to turn these json files back into uexp files, that would be immensely helpful.

Warning

This tool modifies your games data, and while the mod can be reversed, if it does damage to your save file, this tool is not responsible for that.

Credits

Credits to pyroll for the original Python scripts that got this going.