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 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 315 329

  2. 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 90 144

  3. mekhq Public

    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, cove…

    Java 139 184

  4. 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

  5. mm-data Public

    MegaMek Data Repository

    Module Management System

Repositories

Showing 10 of 19 repositories
  • mekhq Public

    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.

    Java 139 GPL-3.0 184 587 (27 issues need help) 19 Updated Apr 23, 2025
  • 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 315 GPL-2.0 329 956 (5 issues need help) 16 Updated Apr 23, 2025
  • 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.

    Java 90 144 70 (3 issues need help) 7 Updated Apr 23, 2025
  • megamek.github.io Public

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

    HTML 6 GPL-3.0 7 0 0 Updated Apr 22, 2025
  • qcs Public

    Quartermaster Command Services

    Ruby 0 0 0 0 Updated Apr 22, 2025
  • megamek-games Public

    MegaMek Games Web site

    HTML 3 3 0 1 Updated Apr 22, 2025
  • api-data Public

    API Access to MM Data

    Swift 0 0 0 1 Updated Apr 21, 2025
  • mm-caspar-trainer Public

    MegaMek CASPAR Trainer

    Python 0 GPL-3.0 1 0 0 Updated Apr 7, 2025
  • mm-data Public

    MegaMek Data Repository

    Module Management System 0 0 0 0 Updated Mar 30, 2025
  • megamekR Public

    R Package for working with MegaMek universe data

    R 0 GPL-3.0 0 0 0 Updated Mar 22, 2025

Top languages

Loading…

Most used topics

Loading…