MTM2 VectorSlope 1.0.0 - tester build
=====================================

Thanks for helping test! This is the first release of MTM2 VectorSlope, a normal-map
tool for Monster Truck Madness 2 modding. It is offline and needs no install.

What's in the zip
-----------------
  VectorSlope.exe      the program
  VectorSlopeCLI.exe   the command-line tool, for batch exports (run it from a terminal)
  README.md            how everything works
  NOTICE.md, LICENSES  credits and third-party licences

Requirements
------------
  - Windows 10 or 11, 64-bit
  - A graphics card with OpenGL 3.3 (any card from the last ~12 years)
  - MTM2 is OPTIONAL. The tool also works on any texture and model without the game.

Getting started
---------------
  1. Unzip anywhere, e.g. a folder on your desktop, and run VectorSlope.exe.
  2. Optional: click "Choose game folder..." and pick your MTM2 folder (the one with
     Monster.exe). That unlocks the game's textures, models and trucks.
  3. Open a texture (from the list, or with Open), adjust the sliders, and look at
     the 3D preview: Prop, Terrain or Truck.
  4. Export saves <name>_N.png (plus _AO if you tick it). With "MTM2 style" on, the
     default folder is where your texture came from.

Settings and presets are saved next to VectorSlope.exe (VectorSlope_settings.json and
a presets folder), so keep the tool in a folder you can write to.

Please try
----------
  - Your own work-in-progress textures, through a Work folder or the Folder... list.
  - Exporting into a COPY of your game folder first, then into the real one once you
    trust it. The tool always asks before overwriting.
  - A truck you know well in Truck mode. Does it look like the game?
  - Models with missing textures: try Locate... and Search a folder...
  - The command line: open a terminal in the tool's folder and run
        VectorSlopeCLI --help
        VectorSlopeCLI --in <your textures folder> --out <a test folder> --dry-run
  - The program without MTM2 installed, if you can.

Known limits
------------
  - The truck reflection uses a simple sky/ground stand-in, not the game's real
    surroundings.
  - The game always loads a POD's copy before a loose file with the same name. The
    preview does too, unless you tick "Prefer loose files" to see your loose work.
    Exporting warns when a POD copy would override your file.
  - Normal -> Height (rebuilding a height map from a finished normal map) is not
    included.

Reporting a problem
-------------------
Send these to whoever shared this build with you:
  - what you did, step by step, and what you expected
  - a screenshot
  - the texture or model involved, if you can share it
  - your VectorSlope_settings.json (it sits next to the exe)
  - for a crash or a start-up failure: the message the tool showed
