AMV TOOLS (Ambient Mask Volume) - Blender Addon

Introduction

This addon is specifically designed to assist in creating ambient mask volumes within the Blender environment

If support needed join discord and ask on #fix-my-mod

Features

• Efficient Volume Creation: Easily create ambient mask volumes for environments directly within Blender.
• Customization Options: Adjust various parameters to fine-tune the appearance and behavior of ambient mask volumes.

Installation

1. Download the addon ZIP file from the releases section.
2. Open Blender and navigate to Edit > Preferences > Add-ons.
3. Click "Install" and select the downloaded ZIP file.
4. Enable the addon by checking the box next to "AMV TOOLS" in the Add-ons list.

Usage

1. After installation, you can find the addon's features within the Blender interface.
2. Refer to the documentation or tooltips provided within Blender for detailed instructions on each feature.
3. Once you've created your AMV and saved it as a JSON file (e.g., AMVJSON.json), drag and drop this file onto the JSON_TO_AMV.bat file to convert it to the DDS format with the appropriate settings.

Credits

This addon utilizes the texconv tool developed by Microsoft. Special thanks to Microsoft for providing this invaluable tool for texture conversion.

License

This addon is distributed under the GNU General Public License v3.0. See the LICENSE file for details.

Detailed Usage

1. Install AMV Tools plugin to Blender. If you're getting an error "No module named 'tifffile'", restart Blender.

2. Choose your output directory, where generated XML and .DDS files will be saved.

3. Open a scene with your model or import it.

4. Click on the + icon to create a new AMV entry.

5. Go to Edit mode, select all vertices and click Set Bounds From Selection.

6. Return to Object mode, fill interior location using your ymap placement data (Position XYZ, Rotation XYZW).

7. Click on Calculate Position and Generate UUID buttons. Your AMV position and unique name will be generated.

8. Next, click on Setup Light button, this is going to enable world's lighting in Blender scene.

9. Feel free to rearrange the probes to suit your interior design. Simply click on the 'Display Probes' button to preview how many pixels your AMV texture will encompass. If you're satisfied with the adjustments, you can save and reset the probe positions.

10. Now, click Bake AMV. Script will bake two textures and save it to .DDS files. This step may take a shorter or longer while, patience is the key.

11. Open the folder selected in Output Directory. You'll notice a folder with a hexadecimal name.

12. Open CodeX Explorer and type amv_zone_0.ymt in the search bar. Click on the second .YMT file, which is located in RDR2\update4.rpf.

13. Head down to the end of the file, click at the last entry.

14. Open generated .XML file, copy the whole content except first line and paste it in .YMT file.

15. Save the file by choosing Save As.

16. Now, return to CodeX Explorer and type amv_zone_0.ytd in the search bar. Click on the second .YTD file, which is located in RDR2\update4.rpf.

17. In the Texture Editor, click on the + icon to add two .DDS files.

18. After adding your textures, find them on the list, click on Details tab, find Dimension column and change Texture2D to Texture3D. Do the same thing for the second texture.

19. Save your .YTD file by choosing Save As.

20. Now move your .YMT and .YTD file to RedM resource and that's all!