The MegaMek organization maintains a series of programs that strive to implement the published rules for the tabletop BattleTech game published by Catalyst Game Lab as faithfully as possible. These programs are designed to be accessible across various operating systems and hardware configurations. These programs REQUIRE a minimum of Java 17 to run. See this post for install directions.
MegaMek is an open-source implementation of the BattleTech board game, enabling players to engage in tactical battles with various unit types including mechs, vehicles, and aerospace units. It recreates the rules from the Total Warfare manual, with additions from Tactical Operations and Strategic Operations. The game supports single-player and multiplayer modes, and allows the creation of custom units, maps, and scenarios.
MegaMekLab is a tool used alongside MegaMek for designing and customizing mechs and other combat units. It offers an in-depth customization interface that adheres to the BattleTech game rules, enabling players to modify their units' weaponry, armor, and equipment specifications.
MekHQ is a campaign management tool that provides an immersive experience in managing a BattleTech mercenary unit. It integrates with MegaMek for battles and MegaMekLab for unit customization, covering personnel, finances, and logistics.
The MegaMek suite is developed in Java and is supported by a robust community of developers and players. We are an open-source project, so anyone is welcome to help. Consider what you can offer, and make sure you join our Discord for easy communication and collaboration. Here’s how you can contribute:
-
I know how to code: Familiarize yourself with our Coding Style Guide. Start small, like fixing a bug or addressing an RFE from our tracker, and submit a PR.
-
I'm an Artist: While we have a precise plan for ground units, we need aerospace sprites. Submit your art in .png format, following the guidelines and discussions for consistency and technical compatibility.
-
I'm a data guy: Accuracy and canon adherence are critical. Join our community to align with our data standards and contribute meaningfully.
-
I know how to document: Help expand our documentation to assist users and contributors. Start with the basics and grow the content over time.
-
General support: Play the games, find bugs, and suggest enhancements. Your gameplay feedback is invaluable.
Find the latest releases, documentation, and support for MegaMek, MegaMekLab, and MekHQ on their GitHub pages. These projects are licensed under GPLv2 and GPLv3, ensuring free and open access to the community.
MegaMek programs are distributed under the GNU General Public License. See the GNU GPL for more details.
- Main website: MegaMek
- GitHub Wiki: MegaMek GitHub Wiki
- BattleTech Forum: Official BattleTech Forum
- Discord: Join our Discord
- Facebook: MegaMek Facebook, BattleTech International Group
- Email: [email protected]
| Type | MM Status | MML Status | MHQ Status |
|---|---|---|---|
| Latest Release |  |
 |
 |
| Javadocs |  |
 |
 |
| License |  |
|
 |
| Build (CI) |  |
 |
 |
| Issues | |||
| PRs | |||
| Code Coverage |  |
 |
 |
