This project is a Blender addon that provides various helper functions to assist working with Meddle exports.
- In Blender, go to
Edit->Preferences->Get Extensions - Select
Repositoriesdrop-down and clickAdd Remote Repository - Enter the following URL:
https://raw.githubusercontent.com/PassiveModding/MeddleTools/refs/heads/main/repo.json
- Click
Check for Updates on Startup - Click
Create - Search for
Meddle Toolsin and clickInstall
After installing the addon, you can find the Meddle Tools panel in the 3D Viewport under the Meddle Tools tab. You can display all panels by clicking the arrow icon on the right side of the viewport or pressing N on your keyboard.
Simply click Import .gltf/.glb and navigate to the same folder you exported from meddle and select the .gltf or .glb file, you can select multiple files from the same folder if you need.
If you need help using Meddle Tools, please join our Discord server and ask in the #meddletools-support-blender channel.
Any models/meshes exported by the Meddle XIV plugin will have the relevant keys and values supplied by the in-game shaders attached under Custom Properties of the material once imported into Blender.
In general, Meddle will spawn textures for all cached textures by referencing the /cache folder in your export directory. It will then make use of the other properties and hand crafted shaders imported from MeddleTools/shaders.blend to set up each material.
A lot of properties of in-game lights do not translate well to blender, I have listed them below
In-game Lights have properties such as ShadowNear and ShadowFar, some lights are placed within meshes which would typically occlude them, but if the ShadowNear value exceeds the distance from the source of the light to the mesh, it would not be occluded (this is an assumption but from testing appears true). There does not appear to be a blender supported method of handling this.
These lights can affect characters and objects differently, and have toggles which indicate whether or not to cast shadows for Characters/Objects independently. This doesn't appear achievable in blender without significantly more complex setup and light linking.
- Area: Supported in blender but does not translate to KHR_lights_punctual (glTF)
- Capsule: Generally equivalent to Area light but with an ellipse shape, does not translate to KHR_lights_punctual (glTF)
- Point: Supported
- Spotlight: Supported
- Directional: Supported
Light color/intensity is represented as a HDR, i.e. values could be RGB (0.5, 1.0, 23.5), this does not translate well to Blender despite it supporting HDR under the hood. Current approximations use reinhardt tone mapping (L / (1+L)) to convert the HDR light to RGB. This works to a degree but is far from accurate to in-game.
Lower lods are not exported by Meddle and as such filling a scene with lower poly models is not achievable. Meddle exported PNG files are exported using the Highest Mip level for the texture, therefore dynamic mip levels are not achievable.
Lightshaft and bguvscroll materials can be animated in-game. This is not fully supported as it is rather difficult to animate these for rendering. It is technically feasable but would require significantly more reverse engineering of these shaders to get something accurate which can be translated to frame-based instead of time-based in blender.
Some shaders are not yet supported. If you wish to get support them, please attempt to recreate them yourself and make a pull request or submit an issue with your research. It is extremely time consuming to reverse engineer in-game shaders and any support is welcome.
Initial Character Shaders and logic for character shaders + starting point for embedded blender file, shader node setups for skin, face, hair and variants.
