ht_mlotool

A framework-independent dev resource for FiveM that helps to customize and generate files necessary for the game to interpret and handle audio occlusion for MLOs.

Documentation

Preview

General Tab

Rooms Tab

Portals Tab

Release Notes

• You can review release notes here

Installation

Download Release

Get the latest version of the tool from the releases section.

Build Source

# clone this repository
$ git clone https://github.com/hedgehog-technologies/ht_mlotool

# Navigate to the repo directory
$ cd ht_mlotool

# Install the project dependencies
$ pnpm i

# Build the resource
$ pnpm build

Further build / development guidance can be viewed here.

Usage

Dependencies

• ox_lib
• CodeWalker

Quick Start Usage Guide

1. Launch into your FiveM server
   • preferably a dev environment, but you do you
2. Place your player ped inside of the MLO that you want to work with
3. Use the /openmlo command
   • Note that by default this requires being a part of group.admin
4. Go room by room through the MLO setting values as you see fit
   • Closing the UI will cache your changes locally automatically, no need to generate the files everytime you close it
   • The resource should detect which room you are currently in and default to that room when you open the UI
   • Note - You can press and hold right mouse button with the UI open to be able to move around
     • Try your best to not leave the MLO while doing so as this can lead to unaccounted for issues during file saving / generation
5. Press the Generate Audio Occlusion Files and wait for confirmation of generated XML file(s)
6. Use CodeWalker to convert the XML files to the proper GTAV format
7. Move the converted XML files to a FiveM map resource
8. Restart your FiveM server and enjoy occluded audio goodness

In Depth Usage Guide

• You can view a more in depth guide here

Acknowledgements

• You can view Acknowledgements here

Support

• Join the HedgeTech Discord for support