Roblox to Source Engine map converter

Converts Roblox XML-format maps (.rbxlx) to source engine (.vmf) maps.

Web App version found here
Note: The web-app runs entirely in your local browser, performance is dependant on your device.

Feel free to open issues/discussions for feature requests or other improvements.

Recommended process

1. Design or open Roblox map
2. Add StringValue with name or value 'func_detail' to detail models, or set the name of the model itself to 'func_detail' (Note: Nested models are also marked detail)
   (This step may also be done after conversion, in hammer)
3. Save map in XML (*.rbxlx) format
4. Run conversion tool
5. Move VTF and VMT texture files to game material folder (E.g. 'Map.zip/rbx' -> 'Team Fortress 2\tf\materials\rbx')
6. Open VMF File in hammer or hammer++

What you get:

• Part geometry converted to brushes.
• Basic support for func_detail
• Textures (VMT + VTF)
• (Optional) Basic optimization by joining adjacent parts
• (Optional) bounding box skybox

(Note: No support for Meshes or terrain. Cylindrical and truss parts get converted into cuboid brushes. Spherical parts get converted into displacements)

Command-line options

Option	Explanation
-i --input	Input RBXLX file to convert
-o --output	(optional) Output file, default: "./rbxlx_out.vmf"
--texture-output	(optional) Texture output folder, default: "./textures-out/"
--dev-textures	(optional) Use source engine developer textures instead of generating map textures
--map-scale	(optional) Scale conversion from Roblox studs to Source Engine Hammer Units, default: 15.0 HU/stud
--no-textures	Disables texture generation & output
--auto-skybox	Include automatically generated skybox
--skybox-height	Adds margin space between the top of the map and the skybox, height in Roblox studs
--optimize	Enables part-count optimization by joining identical adjecent parts into a single map brush WARNING: This may take a very long time on large maps
-g --game	Selects which version of source engine to generate map for

Building

CLI Version

• Run cargo build --release in top level project directory

Webassembly Version

• Run build.bat or build.sh shell script with 'rbxlx2vmf-web' as current-directory.

Or manually, in 'rbxlx2vmf-web' directory:

1. Run cargo build --target wasm32-unknown-unknown --release
2. Run wasm-bindgen --target web --no-typescript --out-dir . "./target/wasm32-unknown-unknown/release/rbxlx2vmf_web.wasm"
3. Run wasm-gc "./rbxlx2vmf_web_bg.wasm"
4. Move "./rbxlx2vmf_web_bg.wasm" to "./html/rbxlx2vmf_web_bg.wasm"
5. Move "./rbxlx2vmf_web.js" to "./html/rbxlx2vmf_web.js"