MechWarrior 5: Mercenaries

File information

Last updated

Original upload

Created by

sicsix

Uploaded by

sic8

Virus scan

Some files not scanned

Tags for this mod

About this mod

This mod introduces VR support with features including a brand-new UI, customised cockpits with built-in screens, performance fixes, head-aim, and much, much more.

Requirements
Permissions and credits
Changelogs
This mod completely overhauls the in-Mech experience with a fully custom user interface, remodelled cockpits with physical screens, extensive optimisations, and many tweaks and improvements. This mod supports all base game and DLC Mechs.

Join us on Discord for support, mod compatibility, mod recommendations, and pre-release updates here: MechWarriorVR Discord

If you'd like a more tactical and challenging gameplay experience that complements MWVR check out BattleTech 3015 - A YAML based lore friendly balance overhaul, and for those with bass shakers such as Buttkickers or Daytons check out my other mod MechShaker.


FEATURES
  • 62 customised cockpits with built-in screens, covering all base game and DLC Mechs
  • Head aim feature - aim arm mounted weapons using your head (toggle using the Arm Lock and Toggle Arm Lock bindings)
  • New Heads-Up-Display that includes speed, jump-jets, temperature, torso-twist state, and more, in a compact VR friendly layout
  • New HUD weapon cooldown pips that show an animated cooldown progress
  • Custom thermal imaging and zoom camera capable of 1x/2.5x/5x zoom levels (toggle thermals with the Toggle Night Vision binding)
  • All cockpit screen UIs built from scratch for VR to be easy to read and optimised for performance
  • Minimap rendering rebuilt for performance and on-screen clarity (toggle zoom level with the Show Battlegrid binding)
  • Additional minimap indicator that highlights the currently selected target
  • A new 3D target box with added lancemate names, replacing the 2D screen-space target box that doesn't work correctly in VR
  • Removal of 2D screen-space markers and other screen-space elements that render incorrectly
  • New bindings to Target Previous Lancemate, Target Next Lancemate, and Order Targeted Lancemate - can now quickly cycle through lancemates, check their status, and issue orders
  • Order lancemates to move to location using head aim
  • New in-cockpit damage particle effects written in Niagara to use GPU only, fixing poor performance and stuttering issues when taking damage
  • Hundreds of recompiled shaders and modified assets to remove distracting dithering patterns and fix VR rendering issues
  • In-cockpit Ares System Menu (Ares System Menu binding) which allows for customising the HUD, screen, and team colour themes, as well as adjusting screen brightness and HUD scale
  • Much more, including additional graphics settings, performance options, UI improvements, rendering bug fixes, and many QoL changes


IMPORTANT KEYBINDS
F9: Recentre VR view
F10: Toggle VR - you will want to toggle VR off while in the Leopard
Home: Toggle VR mouse cursor
Ins: Open UEVR menu
F8: Toggle Ares system menu for customising the Mech interface - use your weapon selection bindings to navigate the menu, this defaults to the arrow keys and Right Ctrl for select



QUICK START GUIDE
This quick guide will take you through getting the mod set up and working
  • Download the latest release from the Nexus including the UEVR Config file
  • Rename the UEVR config file to MechWarrior-Win64-Shipping
  • Download the MW5 Mod Compatibility Pack 5.1
  • Download praydog's Universal Unreal Engine VR Mod from here UEVR Nightly Release, you'll need the UEVR.zip file NOTE: You will need this release for the mod to function correctly
  • Extract the UEVR zip file somewhere, you may need to add an exception to your antivirus software for this folder
  • Install and activate all four MechWarriorVR mods included in the zip file along with the MW5 Mod Compatibility Pack in MW5 using the in-game mod manager or whatever method you prefer
  • Connect your headset and launch your headset software: SteamVR, Oculus, or Virtual Desktop
  • Launch MW5 however you wish NOTE: You do NOT want to launch MW5 with any command line parameters eg. -allowhmd and -d3d12
  • Open Settings, go to Graphics, and set everything to LOW except textures which can remain MAXIMUM. You will likely be able to increase these settings later if you have performance to spare.
  • Ensure that Ray Tracing is disabled, this provides zero visual benefit and may cause crashes
  • Go to Display and ensure DLSS Quality is set to OFF otherwise you will get ghosting
  • Launch UEVR with MW5 still running, it might be easier putting MW5 in windowed mode with ALT+ENTER
  • In UEVR ensure OpenXR is selected and Nullify VR Plugins is enabled
  • Click Import Config and navigate to the UEVR config file you renamed earlier NOTE: The config zip file must be renamed to MechWarrior-Win64-Shipping before import (leave it zipped up). After import an Explorer window will open and it now should contain a folder named MechWarrior-Win64-Shipping
  • Above the Inject button, open the dropdown box and find MechWarrior-Win64-Shipping from the list and select it
  • UEVR will warn you that it has detected VR plugins in MW5, click Yes to go to the plugins directory and delete or move the Oculus and OpenVR folders (you will need to close MW5 in order to do this, restart it once deleted)
  • Once this is done hit the Inject button
  • Inside MW5 you should now be able to press Ins to toggle the UEVR menu on and off. You can change keybinds in here later if desired
  • Start an instant action game, pick a mech with VR in the top left corner and put on your head set, you should be in VR at this point
  • Press the F9 key to reset headset position, and if you want to see your mouse cursor while in VR hit the Home key
  • In mech you can also press F8 by default to open the settings menu for the mech displays and HUD, use your weapon selection bindings to navigate the menu, this defaults to the arrow keys and Right Ctrl for select


COCKPIT MODELLING CREDITS:
  • Annihilator - Perq
  • Assassin - Perq
  • Atlas - Perq
  • Archer - Perq
  • Awesome - Perq
  • Banshee - sic*
  • BattleMaster - Stumblingdrunk
  • Blackjack - sic*
  • Black Knight - sic*
  • Catapult - Perq
  • Cataphract - Stumblingdrunk
  • Centurion - Perq
  • Champion - Perq
  • Charger - Stumblingdrunk
  • Cicada - sic*
  • Commando - sic*
  • Corsair - Perq
  • Crab - Perq
  • Crusader - Stumblingdrunk
  • Cyclops - Perq
  • Dervish - Perq
  • Dragon - Perq
  • Enforcer - sic*
  • Firestarter - Stumblingdrunk
  • Grasshopper - sic*
  • Griffin - Stumblingdrunk
  • Hatamoto-Chi - Stumblingdrunk
  • Hatchetman - sic*
  • Flea - Perq
  • Highlander - Stumblingdrunk
  • Hunchback - sic*
  • JagerMech - Perq
  • Javelin - sic*
  • Jenner - sic*
  • King Crab - Perq
  • Kintaro - Perq
  • Loader King - sic*
  • Locust - sic*
  • Longbow - Stumblingdrunk
  • Marauder - Perq
  • Marauder II - Perq
  • Mauler -sic*
  • Nightstart - Stumblingdrunk
  • Orion - Stumblingdrunk
  • Panther - sic*
  • Phoenixhawk - sic*
  • Quickdraw - sic*
  • Raven - sic*
  • Rifleman - Perq
  • Shadow Hawk - Perq
  • Spider - sic*
  • Stalker - sic*
  • Thunderbolt - Stumblingdrunk
  • Trebuchet - Stumblingdrunk
  • UrbanMech - sic*
  • Victor - Perq
  • Vindicator - sic*
  • Vulcan - sic*
  • Warhammer - Perq
  • Wolfhound - sic*
  • Wolverine - Perq
  • Zeus - sic*
62 / 62 cockpits modelled


CREDITS
Stumblingdrunk and Perq for their playtesting and cockpit modelling
KITT for his VRWARRIOR mod that inspired this, tips on how to overcome early VR obstacles, and letting us spam his Discord channel while working on this
praydog for his work on UEVR that allows us to bypass the buggy VR rendering plugins bundled with MW5 and get much better performance to boot
MagnumGB for his work on the MW5 Compatability mod