Graphics Mods: Difference between revisions

Jump to navigation Jump to search
No edit summary
Line 3: Line 3:
Graphics Mods are an exciting new feature that allows users to modify games through a method of defining targets and then applying actions to those targets.  Currently, Dolphin supports three actions: Skip, Move, and Scale.  These are modifications to the target groups.  In addition to this, Dolphin has some built-in Graphics Mods that apply to certain target groups.  These include "Native Bloom" - scaling the "Bloom" target group down to the correct resolution, "No Bloom" - skipping any texture labeled in the "Bloom" target group, and "No HUD" - skipping any textures under the target group of "HUD".  You can define these or your own Target Groups in any game through using Dolphin's Texture Dumping tool or EFB dumping tools.
Graphics Mods are an exciting new feature that allows users to modify games through a method of defining targets and then applying actions to those targets.  Currently, Dolphin supports three actions: Skip, Move, and Scale.  These are modifications to the target groups.  In addition to this, Dolphin has some built-in Graphics Mods that apply to certain target groups.  These include "Native Bloom" - scaling the "Bloom" target group down to the correct resolution, "No Bloom" - skipping any texture labeled in the "Bloom" target group, and "No HUD" - skipping any textures under the target group of "HUD".  You can define these or your own Target Groups in any game through using Dolphin's Texture Dumping tool or EFB dumping tools.


==== Loading a Graphics Mod ====
==== Enabling Graphics Mods ====


Graphics Mods are loaded similarly to Texture Packs and Riivolution mods. Graphics Mods are loaded from a user's "Load" directory. On Windows, this directory will be located in "My Documents/Dolphin Emulator/Load/Graphics Mods" by default.  A graphics mod will then be located in a subfolder, for instance "My Documents/Dolphin Emulator/Load/Graphics Mods/Wind Waker" could be the folder where you place a Wind Waker oriented Graphics Mod.  In order to make the Graphics mod valid, two files will be located in that folder: a blank txt file with the target GameIDs (GZL.txt for Wind Waker), and a file named metadata.json containing the actual Graphics Mod script.  If your script applies to multiple games, you can include multiple GameID files or an "all.txt" to make your Graphics Mod apply to any title that has compatible target groups defined.
Before being able to use any Graphics Mods, you must enable them!  This can be done by going to the "Graphics" configuration and then choosing the "Advanced" tab.  You may check the "Enable Graphics Mods" to turn them on.  Graphics Mods have some overhead even if not enabled, so it might be wise to turn the feature off when not in use if you have a weaker machine.
 
==== Enabling a Game Graphics Mod ====
 
After enabling the Graphics Mods feature, you may enable any Graphics Mods you have available.  You can see what is available for a game by right clicking on it in the game list and going to "Properties".  Then clicking on the "Graphics Mods" tab.
 
==== Loading a Custom Graphics Mod ====
 
While Dolphin ships with some Graphics Mods as of {{revision|5.0-16786}}, they can also be shared amongst the community similarly to Texture Packs and Riivolution mods. Graphics Mods are loaded from a user's "Load" directory.
 
On Windows, this directory will be located in "My Documents/Dolphin Emulator/Load/Graphics Mods" by default.  A graphics mod will then be located in a subfolder, for instance "My Documents/Dolphin Emulator/Load/Graphics Mods/Wind Waker" could be the folder where you place a Wind Waker oriented Graphics Mod.  In order to make the Graphics mod valid, two files will be located in that folder: a blank txt file with the target GameIDs (GZL.txt for Wind Waker), and a file named metadata.json containing the actual Graphics Mod script.  If your script applies to multiple games, you can include multiple GameID files or an "all.txt" to make your Graphics Mod apply to any title that has compatible target groups defined.
 
=== Creating a Graphics Mod ===


==== Defining a Target Group for an Existing Graphics Mod ====
==== Defining a Target Group for an Existing Graphics Mod ====