/WWMI

Primary LanguageHLSLGNU General Public License v3.0GPL-3.0

Wuthering Waves Model Importer

Custom 3d models loader for Wuthering Waves

Disclaimers • Known Issues • Features • WWMI Installation • Mod Installation • Mod Hot Load • Mod User Hotkeys • Mod Development • Mod Developer Hotkeys • Resources • License

Disclaimers

  • Alpha-2 Warning — WWMI is in second alpha testing phase. Feature set and formats are more or less set in stone, but you still can expect some issues here and there.

  • Compatibility Warning — WWMI doesn't load non-WWMI mods for performance reasons, but if you're okay with up to 50% FPS hit, you can follow this guide (not recommended).

Known Issues

  • Glitch with duplicate modded objects on screen (Merged Skeleton hard limitation, won't be fixed)

Features

  • Highly Optimized — Built with minimization of performance footprint in mind
  • Cross-Platform — Works with NVidia and AMD GPUs
  • Modder Friendly — Enables fully automatic model re-import mod creation with WWMI Tools
  • No Vertex Limit — Removes all limitations caused by component layout of original models
  • Shape Keys Support — Handles original shape keys overrides and enables creation of custom ones
  • Bone Merging — Dynamically merges skeleton data to allow modders work with unified VG list

WWMI Installation

  1. Download and install the latest Microsoft Visual C++ Redistributable
  2. Force Wuthering Waves to load in DX11 mode:
    • Locate and open following folder: \Wuthering Waves Game\Engine\Plugins\Runtime\Nvidia\
    • Remove Streamline folder
  3. Change Character LOD settings in Engine.ini:
    • Open \Wuthering Waves\Wuthering Waves Game\Client\Saved\Config\WindowsNoEditor\Engine.ini
    • Add following lines to the bottom of the file:
    [ConsoleVariables]
r.Kuro.SkeletalMesh.LODDistanceScale=25
r.Streaming.FullyLoadUsedTextures=1
  4. Download WWMI-vX.X.X.zip from the latest release
  5. Extract WWMI archive to any convenient location
  6. Open d3dx.ini in WWMI folder with text editor of your choise
  7. Locate [Loader] section in the top of the file
  8. Change launch = according to location of your Wuthering Waves folder, for example: 
    launch = C:\Games\WutheringWavesj3oFh\Wuthering Waves Game\Client\Binaries\Win64\Client-Win64-Shipping.exe
  9. Double-click WWMI Loader.exe to start the game with WWMI

Mod Installation

  1. Extract mod's archive
  2. Put extracted folder into the Mods folder

Mod Hot Load

To properly load newly installed mod without restarting the game:

  1. Install mod
  2. Hide modded character from screen (switch to another)
  3. Press [F10] to reload WWMI

Mod User Hotkeys

  • [F12]: Toggle User Guide
  • [F6]: Toggle WWMI dependant mods
  • [F10]: Reload WWMI and save mods settings
  • [Alt]+[F12]: Toggle 0.6.X Compatibility Mode

Mod Development

To get into mod creation refer to the WWMI Tools and its Modder Guide:

  1. GitHub
  2. Gamebanana

Mod Developer Hotkeys

  • [F9]: Disable WWMI while held
  • [Ctrl]+[F9]: Toggle Perfomance Monitor
  • [Ctrl]+[F12]: Toggle Hunting Mode Guide
  • Numpad [0]: Toggle Hunting Mode (green text)

Resources

Credits

Chiri, Bo3b, DarkStarSword - creators of original 3dmigoto, huge thanks to those guys! SilentNightSound - custom 3dmigoto fork, initial WuWa research, AGMG legend (ary Sucrose enjoyer) SpectrumQT, SinsOfSeven - WWMI Development Leotorrez, Petrascyll, Zlevir, Caverabbit - WWMI Contribution

License

WWMI is licensed under the GPLv3 License.