KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

terraforming-mars

★ 941 Open GitHub ↗

Terraforming Mars Boardgame

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# <a name="README"> Terraforming Mars Open-source

This is an open-source online implementation of the great board game Terraforming mars. **It is not affiliated
with FryxGames, Asmodee Digital or Steam in any way.**

**Note**: This project has no affiliation with "Rebalanced Mars", whose authors have refused to open-source their code.
We believe this is both a violation of our GPL3 license, and also of the spirit of collaboration that this project tries
to foster. Note that any new features you see on this repo made available on that server are without our permission.

**Buy The Board Game**

The board game is great and this repository highly recommends [purchasing it](https://www.amazon.com/Stronghold-Games-6005SG-Terraforming-Board/dp/B01GSYA4K2) for personal use.

## ⬤ I want to join the community!
[Join us over on Discord!](https://discord.gg/afeyggbN6Y).

## ⬤ I want to play!
There's a instance available at https://terraforming-mars.herokuapp.com/. It's generally reliable, but read more below.

There's also this excellent
[YouTube playlist](https://youtube.com/playlist?list=PLCGE78n9vCqhhmRe9YCrRh2GLNMPB_3j1) focused on tutorials custom for this app.

NOTE: This site is restarted daily. A multiplayer game will remain available for 15 days, after which it will be flushed from the database.
Unfinished solo games are flushed after one day. We continue to make stability and scalability improvements in step with growth and popularity,
but to make sure your game remains, we highly recommended to host your own web server.

## ⬤ I want to learn how to play
There are far too many good tutorials online. [Here are the rulebooks, though.](https://github.com/terraforming-mars/terraforming-mars/wiki/Rulebooks)

## ⬤ I want to run a copy of the server locally
Check out our [Local setup wiki page](https://github.com/bafolts/terraforming-mars/wiki/Local-Setup)

Honestly, it's really simple.

## ⬤ I want to run a copy of the server on Heroku
Check out our [Heroku setup wiki page](https://github.com/bafolts/terraforming-mars/wiki/Heroku-Setup)

(As of 2022-11-28, Heroku no longer has a free tier. However, it is still our recommended way to deploy,
as they're the clearest instructions.)

## ⬤ I want to run a copy of the server on Docker
Check out our [Docker setup wiki page](https://github.com/bafolts/terraforming-mars/wiki/Docker-Setup)

(Warning, this is not aggressively supported, though some people are on the Discord.)

## ⬤ I want to run a copy on a YunoHost server
[![Install Terraforming Mars with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=terraforming-mars)

The code for the Yunohost Terraforming-Mars package is in this [GitHub repo](https://github.com/YunoHost-Apps/terraforming-mars_ynh)

(Warning, this is not specifically supported.)

## ⬤ I want to report a bug or feature request
Add it to our [issues tab](https://github.com/bafolts/terraforming-mars/issues/new).

## ⬤ I want to contribute to development
See [contribution guide](https://github.com/terraforming-mars/terraforming-mars/blob/main/CONTRIBUTING.md) and [local development setup](https://github.com/terraforming-mars/terraforming-mars/wiki/Local-Setup).

## ⬤ I want to win!
Me too, pal. Me too.

## ✨ Contributors ✨

Thanks goes to these wonderful people:

<table border="0">
 <tdata>
 <tr>
 <td><img src="https://avatars1.githubusercontent.com/u/2707843?v=3" width="50px;" alt=""/></td>
 <td><a href="https://github.com/bafolts">Brian Folts</a>: All the things</td>
 </tr>
 <tr>
 <td><img src="https://avatars1.githubusercontent.com/u/56086992?v=3" width="50px;" alt=""/></td>
 <td><a href="https://github.com/vincentneko">Vincent Moreau</a>: Venus, Prelude, Hellas & Elysium, Colonies, Turmoil</td>
 </tr>
 <tr>
 <td><img src="https://avatars2.githubusercontent.com/u/394311?v=3" width="50px;" alt=""/></td>
 <td><a href="https://github.com/alrusdi">alrusdi</a>: Front End, internationalization</td>
 </tr>
 <tr>
 <td><img src="https://avatars3.githubusercontent.com/u/6917565?s=460&v=4" width="50px;" alt=""/></td>
 <td><a href="https://github.com/ssimeonoff">Simeon Simeonov</a>: UX, cards and Colonies design</td>
 </tr>
 <tr>
 <td><img src="https://avatars0.githubusercontent.com/u/806950?v=3" width="50px;" alt=""/></td>
 <td><a href="https://github.com/pierrehilbert">Pierre Hilbert</a>: Turmoil and helps with the things</td>
 </tr>
 <tr>
 <td><img src="https://avatars1.githubusercontent.com/u/2408094?s=460&v=4" width="50px;" alt=""/></td>
 <td><a href="https://github.com/nwai90">nwai90</a>: Community and Political Agendas fan-made expansions, and helps with the things</td>
 </tr>
 <tr>
 <td><img src="https://avatars1.githubusercontent.com/u/10995145?s=460&v=4" width="50px;" alt=""/></td>
 <td><a href="https://github.com/pocc">Pocc</a>: He did that one thing one time</td>
 </tr>
 <tr>
 <td><img src="https://avatars1.githubusercontent.com/u/413481?s=460&v=4" width="50px;" alt=""/></td>
 <td><a href="https://github.com/kberg">Robert Konigsberg</a>: Fan expansions: Ares, The Moon, Pathfinders, Underworld. Prelude 2. Infrastructure cleanup, code reviews, two opinions too many.</a> </td>
 </tr>
 <tr>
 <td><img src="https://avatars.githubusercontent.com/u/836179?s=460&v=4" width="50px;" alt=""/></td>
 <td><a href="https://github.com/chosta">chosta</a>: Front end and back end</a> </td>
 </tr>
 <tr>
 <td><img src="https://avatars.githubusercontent.com/u/5318258?s=460&v=4" width="50px;" alt=""/> 
 <td><a href="https://github.com/Lynesth">Lynesth</a>: Help with the things</a> </td>
 </tr>
 <tr>
 <td><img src="https://avatars.githubusercontent.com/u/15874357?s=460&v=4" width="50px;" alt=""/> 
 <td><a href="https://github.com/derornos">푸른이(derornos)</a>: 한국어화 옮긴이(Korean translator) &emsp;<a href="mailto:derornos@gmail.com">메일(email): derornos@gmail.com</a> / <a href="https://open.kakao.com/me/derornos">카카오톡(KakaoTalk, Messenger): link</a></td>
 </tr>
 <tr>
 <td><img src="https://avatars.githubusercontent.com/u/105346182?s=460&v=4" width="50px;" alt=""/> 
 <td><a href="https://github.com/Borbarad2">Borbarad</a>: Translation</a> </td>
 </tr>
 <tr>
 <td><img src="https://avatars.githubusercontent.com/u/2050250?s=460&v=4" width="50px;" alt=""/> 
 <td><a href="https://github.com/d-little">d-little</a>: CEOs</a> </td>
 </tr>
 </tdata>
</table>

## LICENSE

GPLv3

Russian Prototype font: https://fonts-online.ru/fonts/prototype-rus-daymarius (copyright 2001, free for personal use)
Polish Prototype font: https://www.gry-planszowe.pl/viewtopic.php?p=1489006#p1489006 (copyright 2001, free for personal use)
Baord Game Icons: http://www.kenney.nl/  (Creative Commons Zero, CC0)

terraforming-mars

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README