Skip to content

Generates AMV files for use with custom RedM models. Uses Godot Engine (.NET version) 4.2.1.

License

Notifications You must be signed in to change notification settings

WildRP/WildRP-AMV-tool

Repository files navigation

WildRP AMV Tool

This tool was created to help bake Ambient Mask Volumes and Deferred Probes (aka Reflection Probes) for use in Red Dead Redemption 2 modding. AMVs are used by the game to create ambient lighting - they are essentially 3D textures with baked ambient occlusion.

The tool has been written using the Godot engine, which uses a different coordinate system from Red Dead Redemption 2 - where RDR2 is using Z as up, Godot uses a Y-up coordinate system. Thus, the tool internally uses Godot's coordinates, but presents the coordinates to the end user as Z-up.

License

This repo is licensed under Creative Commons 4.0 BY-NC-SA - the TL;DR is that you can make derivative works or use this in other works, as long as you:

  • Credit WildRP and me (Andicraft / Andrea Jörgensen)
  • Don't sell what you make based on this - this repo is for non-commercial use only.
    • That doesn't mean you can't sell content that uses AMVs that were generated with this program. It just means you can't use the code from this program in commercial applications.

Dependencies

To compile this project you will need:

Contributing

  • There are many bugs at the moment! Pull requests that fix anything are very welcome.
  • If you find a bug that isn't listed in the Issues page, feel free to add a new issue.

Map Tiles

If you want a proper background for the AMV map and you are building this yourself, you will need to download a set of map tiles and extract them to the maptiles folder. These are expected to be in the format of XPosition_YPosition.webp. The exported program uses the tiles helpfully provided by this repo.

Acknowledgements

  • Uses Markdown Label for the help page, to convert markdown files into BBCode.
  • Uses Async Resource Loader C# for map tile loading
  • Thanks to dexyfex, Któs, and CP on the CodeWalker discord for their prior research into AMVs.
  • Huge thanks to alexguirre, Tafé, and SevenLife on the same discord, who finally figured out the reflection probe texture naming.

This project uses the Godot Jolt addon for improved physics performance. It includes version 0.12.0.