Skip to content
@MegaMek

MegaMek

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.

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

  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 274 272

  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 82 117

  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 124 157

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

  • 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 82 117 62 2 Updated Apr 19, 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.

    Java 274 GPL-2.0 272 843 (6 issues need help) 17 Updated Apr 19, 2024
  • mavenrepo Public

    Custom maven repository for intra-project dependency artifacts

    3 3 0 0 Updated Apr 19, 2024
  • megamek.github.io Public

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

    HTML 6 GPL-3.0 9 1 0 Updated Apr 8, 2024
  • IDEASettings Public

    IDEASettings

    1 2 0 0 Updated Apr 7, 2024
  • .github Public

    Project Summary

    0 0 0 0 Updated Apr 5, 2024
  • mekhq-extras Public

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

    2 3 0 0 Updated Sep 27, 2023
  • 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 player's units, experience and funds.

    Java 4 GPL-3.0 2 0 0 Updated Aug 26, 2023
  • megamek-extras Public

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

    6 2 0 0 Updated Jun 1, 2023

Top languages

Java HTML

Most used topics

Loading…