Skip to content

MegaMek Project Summary

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 Wiki


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.

MegaMek Issues

MegaMek Pull Requests

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.

MegaMekLab Issues

MegaMekLab Pull Requests

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.

MekHQ Issues

MekHQ Pull Requests

Development and Community

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.

Status and Support

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.

License

MegaMek programs are distributed under the GNU General Public License. See the GNU GPL for more details.

Our Online Presence

Current Project Status

Type MM Status MML Status MHQ Status
Latest Release Release Release Release
Javadocs javadoc javadoc javadoc
License GPLv3 license GPLv3 license GPLv3 license
Build (CI) MM Nightly CI MML Nightly CI MHQ Nightly CI
Issues GitHub Issues GitHub Issues GitHub Issues
PRs GitHub Open Pull Requests GitHub Open Pull Requests GitHub Open Pull Requests
Code Coverage MegaMek codecov.io MegaMekLab codecov.io MekHQ codecov.io

Pinned Loading

  1. megamek megamek Public

    MegaMek is a networked Java clone of BattleTech, a turn-based sci-fi boardgame for 2+ players. Fight using giant robots, tanks, and/or infantry on a hex-based map.

    Java 303 291

  2. megameklab megameklab Public

    MegaMekLab is a BattleTech unit modification program. It allows creating and modifying all unit types available in MegaMek from Support Vehicles up to WarShips. It also allows printing record sheet…

    Java 87 135

  3. mekhq mekhq Public

    MekHQ is a java helper program for the MegaMek game that allows users to load a list of entities from an XML file, perform repairs and customizations, and then save the new entities to another XML …

    Java 134 175

  4. IDEASettings IDEASettings Public

    IDEASettings

    1 2

  5. mavenrepo mavenrepo Public

    Custom maven repository for intra-project dependency artifacts

    3 3

  6. MekWars MekWars Public

    MekWars is a chat and campaign engine for MegaMek. Players join MekWars servers to find opponents for MegaMek games. MekWars servers can be configured to run campaigns and scenarios - tracking play…

    Java 4 2

Repositories

Showing 10 of 12 repositories
  • mekhq Public

    MekHQ is a java helper program for the MegaMek game that allows users to load a list of entities from an XML file, perform repairs and customizations, and then save the new entities to another XML file that can be loaded into MegaMek.

    MegaMek/mekhq’s past year of commit activity
    Java 134 175 721 (37 issues need help) 5 Updated Dec 27, 2024
  • megamek Public

    MegaMek is a networked Java clone of BattleTech, a turn-based sci-fi boardgame for 2+ players. Fight using giant robots, tanks, and/or infantry on a hex-based map.

    MegaMek/megamek’s past year of commit activity
    Java 303 GPL-2.0 291 935 (5 issues need help) 7 Updated Dec 27, 2024
  • megameklab Public

    MegaMekLab is a BattleTech unit modification program. It allows creating and modifying all unit types available in MegaMek from Support Vehicles up to WarShips. It also allows printing record sheets for single or multiple units.

    MegaMek/megameklab’s past year of commit activity
    Java 87 135 96 (3 issues need help) 2 Updated Dec 15, 2024
  • megamek-extras Public

    Extra resources (camos, portraits, etc.) for MegaMek that are not included in the base releases

    MegaMek/megamek-extras’s past year of commit activity
    6 2 1 0 Updated Nov 23, 2024
  • megamek.github.io Public

    The jekyll set-up for the MegaMek Github front page at https://megamek.github.io

    MegaMek/megamek.github.io’s past year of commit activity
    HTML 6 GPL-3.0 7 1 0 Updated Nov 11, 2024
  • .github Public

    Project Summary

    MegaMek/.github’s past year of commit activity
    0 0 0 0 Updated Sep 8, 2024
  • IDEASettings Public

    IDEASettings

    MegaMek/IDEASettings’s past year of commit activity
    1 2 0 0 Updated Sep 6, 2024
  • mavenrepo Public

    Custom maven repository for intra-project dependency artifacts

    MegaMek/mavenrepo’s past year of commit activity
    3 3 0 0 Updated Jun 29, 2024
  • bv-analysis Public

    Statistical analysis of BV by weight for constructing generic BV

    MegaMek/bv-analysis’s past year of commit activity
    R 0 0 0 0 Updated Apr 28, 2024
  • mekhq-extras Public

    Extra resources specifically for for MekHQ not included in the base releases

    MegaMek/mekhq-extras’s past year of commit activity
    2 3 0 0 Updated Sep 27, 2023

Top languages

Java R HTML

Most used topics

Loading…