Sledge2NeosVR

A NeosModLoader mod for Neos VR
Enables users to import their own sledge file format based assets.

Only parcial support of *.vmt and *.vtf files for now

Self compile

1. Install NeosModLoader.
2. Clone this Repository
3. Implement the methods you need to for your project. Said methods are outlined in the comments.
4. Build and place your DLL's under "nml_mods". This folder should be at C:\Program Files (x86)\Steam\steamapps\common\NeosVR\nml_mods for a default install. You can create it if it's missing, or if you launch the game once with NeosModLoader.
5. Start the game!

Install prebuild

1. Install NeosModLoader.
2. Get prebuild *.dlls from release page
3. Place the DLL's under "nml_mods". This folder should be at C:\Program Files (x86)\Steam\steamapps\common\NeosVR\nml_mods for a default install. You can create it if it's missing, or if you launch the game once with NeosModLoader.
4. Start the game!

Usage

Drag and drop the file you want to import onto the NeosVR window. The mod will try to do an in place conversion and spawn the result in front of you.

Supported files

1. *.vtf - Valve Texture Format https://developer.valvesoftware.com/wiki/Valve_Texture_Format
2. *.vmt - Valve Material Type https://developer.valvesoftware.com/wiki/Material
3. *.raw - color correction LUT's https://developer.valvesoftware.com/wiki/Color_Correction

Settings

• tintSpecular
  • Applies the $color values as tint directly to the specular texture rgb pixels
• importTextureRow
  • Defines the number of texture quads on batch import per row
• generateTextureAtlas
  • Checks if a *.vtf file contains multiple frames and tries to generate a single line sprite sheet
  • If disabled, only the first frame will be imported
• SSBumpAutoConvert
  • Checks the image flags for "SSBump" and applies a conversion (see "Borrowed Code")

Notes

• Materials
  • Currently all materials will be imported as pbs specular and specific shaders are not taken into account
• Textures
  • Image flags inside the header are partially ignored
    • We encountered a lot of texture files, with "broken" flags (e.g. albedo textures been flagged as normal map)

Known issues

• Not all material settings are been utilized
• 2 and 4 way blend materials (e.g. terrain) will only import the first layer textures
  • color splat material conversion is not implemented at this stage
• Specular color tints look weird
  • This is a NeosVR specific issue, since the tint doesn't only affect the reflective parts.
  • Instead the rgb part of the specular is applied like a detail texture and will just be overlaid on top the albedo

Contributors

Thanks go to these wonderful people

dfgHiatus

ukilop

marsmaantje

Borrowed Code

• ssbumpToNormal-Win
  • SSBumpmap to NormalMap conversion
  • https://github.com/rob5300/ssbumpToNormal-Win