Skip to content

MDF‐XL Wiki

Jump to bottom
SilverEzredes edited this page May 17, 2024 · 8 revisions

1. Introduction

1.1 - Overview

MDF-XL is a runtime material editor with a preset system that allows for a high level of customization with excellent compatibility. MDF-XL consists of three main components: MDF-XL, MDF-XL Editor, and the MDF-XL Outfit Manager.

  • [MDF-XL] This is the menu under Script Generated UI in the REF UI, where you can change the preset of your armor and change some of the tool settings.

  • [MDF-XL Editor] This is where you can access the Material and Mesh Editors. The Material Editor allows you to modify the material parameters, such as color, of your currently equipped armor. The Mesh Editor allows you to hide or unhide parts of your armor, and this is where you can save presets.

  • [MDF-XL Outfit Manager] This is where you can save all your currently applied presets to an outfit preset, allowing you to load multiple presets at once.

1.2 - Reporting a bug

If you're experiencing crashes or technical difficulties, please upload a screenshot of the error under 'ScriptRunner' along with your re2_framework_log.txt file from the game's root folder.

Please also enable Debug Mode in the MDF-XL settings before uploading your re2_framework_log.txt. Debug Mode is disabled by default.

1.3 - Troubleshooting

I'm getting a ScriptRunner Error Message when I boot up the game. It mentions something about hotkeys.

  • You're either missing one of the requirements, which is _ScriptCore, or your version of _ScriptCore is outdated. MDF-XL requires _ScriptCore version 1.1.3 or newer.

MDF-XL used to work, but now I'm getting 2 FPS, and ScriptRunner mentions something about a nil value.

  • MDF-XL encountered an issue it couldn't handle. If restarting the game doesn't resolve the problem, navigate to

[YourSteamLibrary/steamapps/common/Dragons Dogma 2/reframework/data/MDF-XL/] and delete the __Holders folder.

If none of the above, then contact me on the Modding Haven discord server, or submit a bug report.

1.4 - FAQ

Q: Will this affect random NPCs in the game world?

  • A: No, it won't. Everything is only applied to the player.

Q: How can I edit my main pawn's outfit?

  • A: You can't at the moment.

Q: Will you add support for X?

  • A: I won't promise anything, but I'd like to add support for weapons.

Q: Will this mod affect performance?

  • A: The only noticeable performance impact is during loading screens when everything must be applied.

1.5 - Credits

praydog for creating REFramework.

alphaZomega for his work on EMV, which heavily inspired this tool, and for his guidance.

koune_samson, baronbeefbowl, b00marrows, Dimpleboob, mellamocarlos, hakz01, darckray, jenya66, lupercal2024, tempjen_90619 and others for testing.

2. Usage

2.1 - Installation

Install Order:

  1. REFramework
  2. _ScriptCore
  3. MDF-XL
  4. Any mod utilizing MDF-XL

2.2 - MDF-XL

As mentioned in 1.1, this is the menu accessible under Script Generated UI in the REF UI. Most mod users will only need to use this interface.

Starting from the top:

  • 'Update Preset Lists' allows you to manually refresh the currently cached presets for your equipment by pressing the button.
  • 'Open MDF-XL - Outfit Manager', opens the Outfit Manager.
  • 'Open MDF-XL - Editor', opens the Editor.
  • "The search bar allows you to search for presets or outfit presets, it's case-sensitive.
  • '[Armor Type]' the dropdown menus for the different types of armor presets, select a file from the dropdown menu to load the settings from that file. The presets displayed in these menus are always the ones that can be applied to your currently equipped gear.
  • 'Default Presets' are generated during the initial loading screen and remain unchanged unless you manually 'Reset Scripts' in the ScriptRunner.
  • 'Current Presets' are generated when you exit the inventory or pause menu, and they are updated each time you leave those menus.
  • 'MDF-XL User Manual' opens this wiki but in-game.
  • 'MDF-XL Settings' various options for the tool, with tooltips available for some of them.

2.3 - MDF-XL - Editor

As mentioned in 1.1, this is the menu where you can access the Material and Mesh Editors.

Starting from the top:

  • 'Update Preset Lists' allows you to manually refresh the currently cached presets for your equipment by pressing the button.
  • 'Mesh Name' displays the mesh name of the currently equipped armor type. Can be toggled in the settings.
  • 'Material Count' displays the number of materials used by currently equipped armor type. Can be toggled in the settings.
  • 'Preset' the currently active preset for that armor type. Functions the same way as in the MDF-XL menu.
  • '[Enter Preset Name Here]' is where you can input the name of your preset. It's recommended to avoid using special characters.
  • 'Save Preset' saves the current preset to [PresetName].json found in:

[Dragons Dogma 2/reframework/data/MDF-XL/[ArmorType]/[SubArmorType]/[MeshName]/[PresetName].json] The tooltip will tell you the exact path.

  • 'Mesh Path' displays the mesh path of the currently equipped armor in the game files. Can be toggled in the settings.
  • 'MDF Path' displays the mdf path of the currently equipped armor in the game files. Can be toggled in the settings.

Mesh Editor

Allows you to hide or unhide parts of the currently equipped armor. If changed, an asterisk(*) will appear next to the submesh name. If Emissive Highlighting is enabled in the settings hovering over a submesh will highlight it in white.

Material Editor

Allows you to adjust the parameters of the materials for the currently equipped armor. If changed, an asterisk(*) will appear next to the material parameter name and the parameter will be offset to the side. The search bar lets you quickly search for material parameters by their name, it's case-sensitive.

  • When the dropdown menu for the material name is open, right-clicking it brings up a context menu that allows you to copy/paste all material parameters, or to reset all material parameters.

  • Right-clicking the [Material Parameter Name] button will bring up a context menu that lets you copy/paste the selected material parameter, or to reset the material parameter. You can also reset the material parameter by left-clicking the [Material Parameter Name] button.

2.4 - MDF-XL - Outfit Manager

Similar to the MDF-XL window, but unlike that window, changing a preset here does not apply immediately. This is intentional to allow for quickly building outfit presets.

  • [Save Outfit Preset] saves the current preset to [OutfitPresetName].json found in:

[Dragons Dogma 2/reframework/data/MDF-XL/_Outfits/[OutfitPresetName].json

2.5 - Packing an MDF-XL Mod

You only need to pack your presets, you can include multiple presets in the same archive.

Presets can be found in:

[Dragons Dogma 2/reframework/data/MDF-XL/[ArmorType]/[SubArmorType]/[MeshName]/[PresetName].json]

Outfit Presets can be found in:

[Dragons Dogma 2/reframework/data/MDF-XL/_Outfits/[OutfitPresetName].json]

Example mod can be found on the mod's Nexus Page.

3. Material Parameters

[AlphaTestRef]

  • ATOC R channel balance. | Float 0.0 - 1.0

[BaseColor]

  • ALBD tint. | Vec4 RGBA

[BaseDetail_TilingScale]

  • Detail map tiling scale. | Float

[BrainwashRate]

  • Dragonsplague overlay toggle. | Float 0.0 - 1.0

[Brainwash_Color]

  • Dragonsplague overlay color. | Vec4 RGBA

[Brainwash_LightInfulence]

  • ATOC B channel strength on Dragonsplague overlay. | Float 0.0 - 1.0

[DragonGrade_Enable]

  • Wyrmfire overlay toggle. | Float 0.0 - 1.0

[Emissive_Enable]

  • Emissive toggle. | Float 0.0 - 1.0

[EmissiveColor1]

  • Primary emissive color. | Vec4 RGBA

[EmissiveColor2]

  • Secondary emissive color. | Vec4 RGBA

[Enable_ExtraPatternMap]

  • True color replacer toggle. | Float 0.0 - 1.0

[ExtraPatternMap_Color]

  • The color of true color replacer. | Vec4 RGBA
Clone this wiki locally