What software do I need to run MegaMek?
MegaMek will run on any operating system that can run Java 8 including Windows, macOS, and Linux. Although it will run on later versions of Java, your experience will vary.
On a Mac, How do I open up multiple instances of MegaMek?
By default, OSX applications will only open a single instance. To open up a second instance of MegaMek, you will have to use the Terminal application (in Application/Utilities). Navigate to your MegaMek directory and type:
open -n MegaMek.app &
-n argument tells OSX to open up a new instance of the application.
I am on a Mac, and MegaMek will not open up up properly when I click on it. What should I do?
Apple has increased security measures that you will have to override in order to open up any of the programs that have been packaged for a Mac. You can follow these instructions to get things working on a Mac. Alternatively, you can just download the Unix/Linux distribution which will run perfectly fine on a Mac.
How do I use more, or less, memory?
By default, MegaMek uses up to 1024 megabytes (1 gigabyte) of memory. This amount of memory is sufficient for most games, but when playing large games against the bot, higher amounts of memory can boost performance. How you change the maximum memory allowed varies by operating system.
On Windows, open up the MegaMek.l4j.ini file and change the line that says
-Xmx1024m to the amount of memory you want. For example, if you want 512 megabytes of memory, you would change this line to
On macOS, you want to right-click on the MegaMek icon and choose “Show Package Contents.” Then open up Contents/Info.plist. Look for the line that says
-Xmx1024m and edit this as above.
On a Linux/Unix system, you will need to edit the startup.sh file’s last line, or just add the memory argument directly to your java command if launching manually. For example:
java -Xmx512m -jar MegaMek.jar &
Why can’t I host a game?
If you are hosting a game over the internet, and other people cannot connect to your address, then you probably have port forwarding disabled in your router. You will need to allow port forwarding from the router to your computer on the port that MegaMek is using (2346, by default). How to do this will vary depending upon what type of set up you have for connecting with the internet. Check the instructions for your router. You can also try portforward.com, which has instructions on how to forward ports for many routers.
How do I start a dedicated server?
Follow our detailed instructions for setting up a dedicated server.
My MHQ campaign is failing to because it cannot find some of my units. What should I do?
What is Variable Tech Level?
Why can't I find a particular unit?
There are three possibilities:
- Check in the Allowed units sections and make sure the year the game takes place is set, and the tech level is set to the correct level.
- We forgot to add it. Please report it either to the bug tracker or the forums.
- The unit has not yet passed the two months moratorium period since its official Record Sheet got released. You will have to wait until that happens.
Why is a particular unit marked as illegal when it fits the official Record Sheet?
How do I get fluff images to show up?
data/images/fluffdirectory. The name of the image must exactly match the name in the unit selector. So, if you wanted to add a fluff image for the "Sunder SD1-0G", you would need to name the image "Sunder SD1-0G.xxx" where xxx is the image extension.