Skip to content

lisongmechlab/lsml

Repository files navigation

Li Song Mechlab (LSML)

Overview

Li Song Mechlab (LSML) is an open-source 'Mech loadout creation and analysis tool designed to empower MechWarrior: Online players with accurate and comprehensive data for optimal loadout configurations. The tool focuses on providing essential numbers and statistics, allowing you to make informed decisions about your BattleMech loadouts.

Key Features

  • Always Up-to-Date: LSML reads data directly from your MechWarrior: Online game install, ensuring real-time updates with each patch. Even unreleased mechs are available in the data files.

  • Accurate Metrics: Benefit from precise calculations for expected average damage and heat, including considerations for ghost heat, quirks, weapon jams, spread, spin-up, double fire, and other weapon properties.

  • Critical Hit Simulations: Evaluate the survivability of components in combat through critical hit simulations.

  • Advanced Search: Easily find mechs based on specific criteria, such as weapon loadouts, tonnage, speed, weapon quirks, and special equipment like jump-jets or ECM.

  • Compelling Graphs: Visualize damage and alpha strike capabilities over range, with the ability to examine individual weapon groups.

  • Efficient Mech Building: Utilize tools like Smart Place and Auto Armour to build mechs quickly.

  • Comprehensive Mech Statistics: Access detailed information on turning rate, max angles, total damage capacity of ammo, and more.

  • Export/Import Loadouts: Seamlessly transfer loadouts between LSML and the in-game Mechlab, avoiding the need to use PGI's Mechlab.

  • No Downtime: LSML runs locally on your computer, eliminating dependency on remote servers and ensuring uninterrupted access.

Screenshots

Main Window - Garage Mechlab Main 2
Main Window - Search Mechlab Main 4
Main Window - Payload Mechlab Weaponlab

Installation

To get started with LSML, follow these steps:

  1. Download the latest release and run the installer.
  2. Upon first start-up, the program will ask for your MWO install directory if it didn't find it automatically. Browse to where you installed MWO to get automatic updates to the game data.
  3. Enjoy the benefits of accurate, real-time data for optimal 'Mech loadouts.

Contributing

We welcome contributions! If you find bugs, have feature requests, or want to contribute to the project, please check our contribution guidelines.

License

LSML is released under the GPL 3.0 License. Feel free to use, modify, and distribute the tool according to the terms outlined in the license.

Libraries

LSML uses the following libraries with their respective licenses:

The terms "Mech Warrior" and "Mech Warrior: Online" are copyright/trademark of their respective owners.

Contact

For questions, support, or feedback, reach out to the discussions tab.

Be prepared. Optimize your loadouts with Li Song Mechlab.

#nobullshitjustrawdata