r Mars Simulation Project

(Image showing how buildings are interconnected in mars-sim)


The Mars Simulation Project (mars-sim) is an open source Java project aiming at building computer models that characterize important aspects of establishing human settlements on Mars.

Have you ever been fascinated by reality TV shows in which how contestants survive each test? Some are natural-born team players but they are put to test by having to compete against one another instead of teamworking. Some are loners by traits and have to work pass suspicion and mistrust to collaborate with others to accomplish some mutual goals.

(Image from MarsOne)

First and foremost, what mars-sim attempts to model is the professional relationship of the early settlers. There are jobs to get done in developing the settlement. Therefore, we model each settler with personalities, a list of natural attributes and job skills, and a set of preferences (likes-and-dislikes on a bunch of task). We define an assigned role and a job position for each settler with a myriad of tasks to perform. While most tasks are done independently by an individual. Some require teaming up with others to get done for the settlement. There is also description indicator showing the level of relationship (how close or how adversarial) between any two individuals.

With private ventures such as SpaceX offering new vision of going to Mars and the Mars One Foundation seeking to recruit future settlers on a one-way ticket to Mars, mars-sim is giving the audience a preview of the coming attractions in unraveling the intricate innerworking of establishing a human foothold on Mars.

Your Face Here
(Image credit: Mashable.com, 2013)

The good news is that, unlike in a TV soap opera in that the relationship dynamics of the characters are scripted to appeal to a qualified audience, actions and reactions of each settler in mars-sim are emergent and non-linear. They interact with the environmental conditions and with one another as they develop their settlement. Their personality and natural attributes can positively or negatively affect the social networking. Just like in real life, the bonding between any two individuals gets strengthened with positive exchange or degraded over time when less contact is made.

(Cutaway of a proposed 4-person Habitat Module. Image: Ian Warpole, Scientific American)

Below are the type of questions you may ask yourself if you are a mission planner for a human-rated Mars mission:

a. What types of psychological profile of the team should I select for each mission going to Mars to jump-start a colony vs. sustain the settlement?

b. How many of them should I send on each mission, accompanied with what resources, parts, equipment, vehicles, and building modules?

c. How often should I send these resupply missions to seed each existing settlement or to start a new outpost nearby?

d. What interventions do I need to do to ensure these settlers balance between their own personal needs and the collective needs? In mars-sim, you will have an opportunity to flesh out your own ideas and hypotheses.

(Image from Outerplaces.com and Mars-One.com )


Screenshots from Mars Simulation Project Version 3.1.0

Settlement Map and Mars Navigator Mini-map
Mining Outpost
Monitor Tool
Help Browser
Info Windows: Vehicle/Settlement/Bots
Info Window: Person


Robert Zubrin once proposed four phases in the economics of Mars colonization. Each represents a new progressive stage of increased human activities toward building a human civilization on Mars.

(Image based on Mars Direct, Robert Zubrin, The Mars Society)

(1). EXPLORATION : orbital survey of Mars, telescopic and robotic survey, precursor sample return, scientific investigations, human flyby/EVA/landing/return;

(How soon before humans trek across the landscape of Mars? Artist's concept depicts crew members involved in sample analysis on Mars. Image from NASA)

(2). BASE BUILDING : semi-permanent laboratory/habitat modules, crew rotations, water/ice recovery, in-situ fuel production, outpost maintenance/sustainment;

(Cutout of a Multi-purpose Habitat. Image from MarsOne)

(3). SETTLEMENT : colony expansion, food and resources supply chain, terrestrial exploitation, economic viability, industrial production, infrastructure redundancy;

(Mars Under Construction. Image: Bryan Versteeg/Spacehabs.com)

(4). TERRAFORMING : altering global climate, large scale geo-engineering, permanently transforming human surface activities.

Currently, mars-sim focuses primarily in offering a simulation engine showcasing human activities in the aforementioned Phase 1 and 2 and a little bit of Phase 3. Below are the five core features of mars-sim:

(Terraforming Mars is not for faint of heart. Image credit: Stefan Morrell. Sources: Christopher McKay, NASA Ames Research Center; James Graham, University of Wisconsin–Madison; Robert Zubrin, Mars Society; Margarita Marinova, California Institute of Technology)

I. Mission Scenarios

mars-sim borrows from a variant form of the Mars Direct plan proposed by Zubrin and Baker in 1990s. Select 'New Sim' in the Main Menu will take you to the Simulation Configuration Editor. By default, you are presented with two settlements, namely a Mars Direct Base (Phase 1) with 4 settlers and an Alpha Base (Phase 4) with 24 settlers. You are free to reconfigure this template.

In version 3.1.0, users may designate a space agency to sponsor each settlement. The names of the settler will be auto-generated to suit his/her national origin, based on the space agency chosen.

In terms of resupply mission, for a Mars Direct Base Phase 1, the built-in resupply schedule will send one new mission each Martian year (668 or 669 sols) for the next 3 years to replenish existing settlements. Using Resupply Tool, users can tweak the launch/arrival date, the number of settlers and the type/ quantity of supplies (including buildings, equipment, vehicles, resources, and parts).

Simulation Configuration Editor
(Image from Simulation Configuration Editor in mars-sim)

Crew Editor
(Image from Crew Editor in mars-sim)

II. Profile of Settlers

Each settler is assigned with a Job which will determine a list of relevant tasks and missions at a given Work Shift. There are a variety of Job in mars-sim: Architect, Areologist, Astronomer, Biologist, Botanist, Chef, Chemist, Doctor, Driver, Engineer, Manager, Mathematician, Meterologist, Physicist, Technician, and Trader. Users can change a person's Job in the Activity Tab.

In version 3.1.0, each settlement will have a leadership structure. For a settlement with less than 47 settlers, the hierachy comprises a commander, and sub-commander and a list of chiefs and a list of specialists. FOr a settlement with 48 people, a mayor will be elected. Each settler will have a given Role based on his/her natural attributes and skills. The roles are not fixed and can change over time.

A person's Skills Tab will show his current level of achievement on each skill subject. Each individual has a blend of academic skills (such as Aerology, Astronomy, Biology, Chemistry, Mathematics, Meteorology, Physics, etc.) and survival skills (such as Botany, Cooking, Construction, Driving, EVA Operations, Material Science, Mechanics, Medicine, Trading, etc.) that will contribute to the survival and sustainment of the settlement. When a settler takes up the role of a chef, the corresponding skill--namely cooking-- will improve. The one whose skill is higher level may mentor one whose skill is lower. Over time, settlers may cross train among themselves to improve skills or acquire new skills. With overlapping skills, settlers depend on one another to get through disasters and catastrophes.

Settlers perform tasks and activities according to their personal needs and the collective needs of the settlement. There are a myriad of tasks such as Growing crops, Sleeping, Cooking, Relaxing, Exercising, Doing Yoga, Eating a Meal, Performing Maintenance, Performing Experiments, Manufacturing, Tending Greenhouse, Entering/Exiting EVA, Driving Vehicle, Collecting Resources, Perform Study, and Teaching, etc.. Some tasks are more career-oriented than others. As you can imagine, chefs prepare meals, botanists tend greenhouses, technicians perform maintenance, engineers manufacture needed parts and equipment from local resources, etc..

Settlers also form tag teams to explore treacherous terrains, prospect rock samples and mine minerals. Based on supply and demand, they will set out excursions to trade with neighboring settlements as there are hundreds of items called "Trade Goods". Some of these items may be in surplus on one settlement but are in wants by another settlement. On the other hand, some settlers may have overwhelming scientific ambitions to just stay put and write proposals and conduct scientific study. Their goals would be earning Scientific Achievement Credits. As the primary researchers, they recruit collaborators on their projects. Without a doubt, settlers of Mars are pioneers of the next human frontier.

(A Mars Expedition. Image credit: Douglas Shrock- the Artist Shrox)

III. Health and Radiation Modeling

mars-sim simulates realistic scenarios in which settler will cope with accidents of all kinds, illnesses, injuries and even death. Each settler has 4 critical health attributes reflecting the person's current physical conditions: Hunger, Fatigue, Stress and Performance level. A person's overall health status may be reported as being well or being sick (such as Suffocating, Recovering from Anxiety Attack/Flu/Pulled Muscle, and Death, etc..)

In version 3.1.0, a radiation exposure modeling based on NASA's studies has been partially implemented to make it realistic. There are 3 possible type of radiation events : (A). The Baseline (B).the Galactic Cosmic Radiation (GCR) (C). Solar Energetic Event (SEP). Each with different level of radiation with SEP the highest level of exposure. The 3 body regions where the exposure are to be tracked are (1) Blood Forming Organ (BFO) (2) Ocular (3) Skin. In our modeling, there are 3 intervals (or counters) for the exposure: (1) 30 days (2) Annual (3) Career. e.g. for BFO, the max limits are set to be 250 mSV for 30 days, 500 mSV for Annual and 1000 mSV for Career.

As a side note here, the Mars rover Curiosity received an average dose of 300 milli-sieverts (mSv) over the 180-day journey. Note that 300 mSv is equivalent to 24 CAT scans, or more than 15x the annual radiation limit for a worker in a nuclear power plant.

One must be reminded that in the forseeable future, Mars is a by-and-large dangerous and unforgiving world. Survival hinges upon how well each settler responds to situations and how well they pull together as a team. Equipment can malfunction and building break down and require maintenance. There are times when one has to go out on a rescue mission to tow a stranded vehicle back to the base.

(Working Inside Greenhouse. Image credit: Douglas Shrock- the Artist Shrox)

IV. Social/Professional Interactions and Achievements

mars-sim simulates the overall professional relationship for the future settlers on Mars. Each settler bears an imprint of one's gender, date of birth, weight, height, BMI, age, blood type, a personality profile based on Myers-Briggs Type Indicators (MBTI) and Five Factor Model (FFM), and a set of natural attributes (such as Agility, Academic Aptitude, Attractiveness, Conversation, Endurance, Experience Aptitude, Leadership, Strength, Stress Resilience, and Teaching). These characteristics set in motion on how well a person interact with his/her team and others socially and professionally.

One can track how a person relate with another with the Relationship Tab. Suffice to say that each settler with one's personality types, coupling with his unique set of natural attributes and professional skills, create the destiny of his/her own.

A person's Science Tab lists the ongoing and finished scientific studies with others and the scientific achievement in his/her areas of endeavour.

Your Face Here
(Image credit: pioneer-city.com)

V. Interconnectiveness

The Settlement Map provides each settlement a visual overview of the whereabout of each building, settler, bot and vehicles. You can see how buildings are seamlessly interconnected via hallways or tunnels. The Settlement Info Window provides clues on how well each system is functioning behind the scene. No two settlements are alike. You can make each settlement unique by having distinguishable mission footprints and infrastructures and by ways of how settlers behaves.

Beginning version 3.1.0, each settlement has an objective-- the overall development objective that certain activities such as manufacturing and food production processes tend to gear toward.

The 6 possible objectives :
(1). Crop Farm
(2). Manufacturing
(3). Research Center
(4). Transportation Hub
(5). Trade Town
(6). Tourism

(2-D blueprint of a Mars outpost with connected modules. Image courtesy of Georgi Petrov and Mars Foundation.)

As settlements grow and more buildings are shipped in or being constructed on site according to the needs, diversity of specialty function results. It's not difficult to imagine a settlement would become an university town housing numerous laboratories attracting academically driven settlers to perform research studies on various disciplines. A green haven may have a large number of interonnected greenhouses experimenting with crop genetic that gives better crop yield having a company of biologists/botanists. A makers town is one that consists of a lot of workshops/manufacturing shed providing high industrial throughput and attracting influx of creative individuals to tinker with tools to produce new parts and equipment. Also, mining outposts will be sprouted up everywhere along a resource-rich basin/region that provides a continuous supply of minerals.


mars-sim is available for free in 4 binary editions, either Jar and Debian Editions, and either Swing or Headless. Download the latest build or release today at:

  • A. Go to Sourceforge's repo to start the download automatically based on your machine OS : Download Mars Simulation Project

  • B. Click on the following link to manually choose a particular edition :
  • C. Alternatively, check out the latest build at the GitHub release tab

  • D. Also, you may download this old v3.06 User Guide as a reference.

Minimum Requirements :
a. Dual Core Pentium/Celeron 1.5GHz or above
b. 1.5 GB free RAM dedicated for running mars-sim
c. 64-bit Oracle Java 14 (Oracle JDK 14 or OpenJDK 14)


A. Changes/Improvements in v3.1.1

i. Fixes :

 1. Correct startup issues.

ii. Changes :

 1. Switch to supporting Java 14 and above.

B. Changes/Improvements in v3.1.0

i. New Core Features :

 1. Add robots (Chef bots, Handyman bots, Garden bots, Medic bots, etc..) to lighten the load of the daily tasks in the settlement.
 2. Add new battery charging/discharging model for the power grid batteries that store unused/excess power for future use.
 3. Add wash water rationing. Activate rationing if water stored at a settlement is less than 10% of their yearly drinking water needs.
 4. Add the ability to tweak how much fuel and life support consumable to bring for each mission via an element/attribute in xml.
 5. Refactored the meteorite impact calculation in MeteoriteImpactImpl.java and completed Part I and II below. Note: any observable impact will increase the stress level of the settlers on that building if his/her natural attribute of courage and emotional stability are not high enough.
  a. Calculate the probability of impact per square meter per sol on the settlement, assuming the meteorite has an average impact velocity of 1km/s, critical diameter of .0016 cm and average density of 1 g/cm^3, per NASA study.
  b. Calculate how far the incoming meteorite may penetrate the wall of a building
 6. Added radiation exposure tracking for each settler (in the existing "Health" tab).
  a. Minimized or prevented EVA operations during intense Galactic Cosmic Rays (GCR) and Solar Energetic Particles (SEP) events for reducing radiation exposure. Refactored probability of exposure to conform better to NASA study.
 7. Apply LZMA2 compression and reduced the size of saved sim by 5-10 times.

ii. New UI elements :

  a. Add a tab bar on top and segregate most Tools into their own tabs.
  b. Add Earth and Mars Date/Time bar anchored near top center.
  c. The 'Mars Navigator Tool' is renamed 'Navigator Minimap' and now has two maps stacked up on top of each other.
  d. Both the Settlement Map and the Navigator Minimap are now displayed inside Map tab. They can be turned on at the click of their buttons on top right.
  e. Add bullet bar and gauges for displaying a person's personalities (for both MBTI and Big Five Models)
  f. Add the use of keyboard shortcuts (see /docs/help/shortcuts.html at Help Browser's User Guide under User Interface).
  g. Rework Simulation Configuration Editor for choosing one sponsoring space agency for each settlement.

iii. Improvements/Changes:

 1. Fix bugs in water/waste water consumption and production and use of fertilizer for improving crop yield.
 2. Improve the outside temperature variation based on latitude and longitude/day and night/location elevation/season of the year.
 3. Modify the initial requirement of starting a construction project (putting together foundation and framing of a building). A lot easier for settler's to get projects going.
 4. Improve the overall simulation of greenhouse operation by the followings:
  a. Add user select size of growing area for each crop. Number of crops no longer limited to 5 or 15.
  b. Add bee growing and pollination requirement on crop yield.
  c. Add fungi/algae growing and the use of containment kits.
  d. Improve simulation of crop's gas exchange when in the presence and absence of photosynthesis and sunlight and water consumption that will affect a crop's harvest modifier.
 5. Multi-threading improvements on CPU with less threads and slower speed.
 6. Improve the depth of personality modeling by implementing the Five Factor Model, alongside with the existing Myer-Brigg Type Indicator (MBTI). Display personality using bullet charts and gauges
 7. Designate specific bed/quarters for each settler.
 8. Implement sleep hour habit/pattern for each settler.
 9. Improve Alpha Crew Editor by adding the choice of the country of origin and sponsorship.

C. Changes/Improvements in v3.07

i. New features:

 1. Added new attributes (edible and inedible biomass, crop category, and water content) for crops.
 2. Added meals and dessert preparation for facilities having a kitchen such as in Outpost Hub, Lander Hab and Lounge.
 3. Added a variety of food production processes to keep your Chef busy :) e.g. soybean from a crop can be made into soymilk and tofu, etc.
 4. Added 60+ edible food items (including the crops), a majority of which (some must be imported) come from harvesting the food crops grown in the greenhouse and processing them into a diverse number of food items.
 5. Added heating system to Lander Hab, Outpost Hub and Greenhouses. It requires power to maintain the optimal room temperature.
 6. Added outside temperature and air pressure display on the settlement unit window.
 7. Added Transport Wizard in the Resupply Tool that allows custom location of placement of each newly arrived building.
 8. Added Alpha Crew Editor that allows users to config the Alpha Crew-- a team of four with customized name, gender, personality, and job when starting the first settlement (Note: other characteristics may be edited in people.xml).
 9. Added new activity spots in buildings and vehicles.
 10. Added new event notification popup display.
 11. Coded the display of the level of a person's health, hunger, fatigue, stress, and performance into 5 levels of description. The numeric values of these metrics are still available in the Health tab of the Person Unit Window .
 12. Added a status bar to both the Main Window and Settlement Window. Added Martian time, Earth Time and Memory Usage to the status bar.
 13. More internationalization, some UI improvements and bug fixes.

For more details on mars-sim development, go to SourceFoge's project website or GitHub project page.


We would like to invite you to discuss mars-sim and topics relating to human settlement on Mars in our facebook group. Please click the button below.