Module talk:Terraforming Mars

Difference between FR and EN versions
The reason why there is a difference in versions is because there is still a functionality not present in the english version. In the FR version, the tiles are sent either directly to reserved City areas, or to Player Next Tile area, for each project (standard or card) that says you place a tile, or when converting plants, or when passing 0°C, with prelude cards and corpos as well, and for special Tiles (volcano, capital, mines ...) too. This took a long time to have this working on FR version. Maybe someone wants to check the FR code and adapt the EN code.

Modules FR
French dialogs and images only in these versions

A-3.0 FR
3.0.4 Fr
 * [080] Astéroide de Glace Géant - ne donnait pas 2 tuiles océans à placer
 * Ecoline - Corpo ne donnait pas de tuile forêt à placer
 * La limite du nombre de tuiles cité et forêt a été augmentée, suite à un remplissage total du plateau de jeu

3.0.2 Fr
 * Player on Seat2 had a bad experience with triggered cards going back to hand after asking a question - solved, from a bad sequence in the Automat (always on Seat2)
 * [256] Magnétisation de Vénus - Now considering Energy Prod to push Venus +1

3.0.1 Fr
 * The Martian - The Automat is ready
 * A 2 players game where Seat1 is occupied by a human, and Seat2 by The Martian
 * The Martian will play 1 action card from his own deck ... then every 3 Generations, 1 more action card
 * At upper levels of difficulties, The Martian will pick 1 more action cards every 2 Generations, but may gain more points also
 * The Martian does not have Credits, Steel nor Titanium units, but Plants, Energy and Heat units
 * The Martian will nee your help to place Oceans, Greeneries (from Plants or Actions), cities for the best possible location each time
 * Without any money income, the martian will focus on gettings Plants and Cards and VP's from the surface of the planet, but does not care about touching a Lake tile
 * The actions will also allow The Martian to claim a Milestone, as soon as the conditions are met, and can also fund an Award
 * For these conditions, you'll need some help, as there is no need for Credits to fund the Awards, but some badges requirements may be considered differently
 * As soon as The Martian gains a card from an action, the Project is computed for Tags and VP (Terraforming Points positive and negative) and sent to the player 2's hand
 * These cards can then be discarded or stay there for ever, it's not important
 * Thre is no research phase for the Martian, but if a cards has to be drawed from a position bonus on the planet, you'll need to draw from the deck, and place the card on the Pink Martian board - It will then be computed and immediately stored on Hand. Don't do it twice ! Or you would count the Tags and VP a 2nd time !
 * There is no World Gov Effort, even if you play with venus Next
 * There is no Blue Action Unit cards for The Martian, unless you want to do that manually as an advanced level of difficulty - The Help will tell you how to count these units
 * At the end, the player with the most points wins tha game ! There is no limitation in 12 or 14 Gen, but you'd better hurry against the Martian
 * BTW, if you play with Prelude, just pick 2 cards for the Martian and play them normally for her - The Tags will then be counted
 * Have Fun

3.0.0 Fr
 * After vassal engine upgrades, TM module dev is back on track, this time starting with the Automat dev.
 * Automat The Martian has to be used as a 2nd player, hot seat - Not in solo game !
 * Automat automation will come with the development, and cards will be more and more automatic

Automat The Martian - Rules
 * The ideas and rules for The Martian come from BGG Khyinn Khong
 * English Rules [[Media: Variante_Martian_v1.6.0-EN.pdf]]
 * French Rules [[Media: Variante_Martian_v1.6.0-FR.pdf]]
 * They will be adapted to Vassal, and some points may be details for this to be compatible with automation

A-2.8 FR
2.8.3a Fr
 * VASSAL v3.3.3-beta1 uncovered a bug in the coding which was masked by previous VASSAL versions, making the module unplayable. This is a quick fix to make the module playable again, and has NOT been thoroughly tested.
 * Details of the bug: Properties in Beanshell expressions (curly braces, '{}') should not be enclosed in dollar signs. Previous versions of VASSAL just ignored the dollar signs, but 3.3.3-beta1 interprets them, replacing the property with its value before evaluating the Beanshell expression, causing the expression to fail (or always return zero, depending on the context).  This broke many Restriction traits, making most cards with any pre-req's unplayable.
 * This was repaired with a global search-and-replace using a regular expression. It is possible this removed dollar signs that should have remained (for example, if there were any literal '$' in any strings).

2.8.3 Fr
 * Previous was bugged for Milestones and Awards : would not pay

2.8.2 Fr - removed 'cause bugged
 * [187] Pompade de l'aquifere, image en français
 * Fleuves de lave : Bolcano remplace en Volcan
 * Les rapports en couleurs n'étant pas probants, voici un cadre coloré de 5 cases de la couleur du joueur au début de chaque rapport (ou presque). Ca passe mieux pour les yeux.
 * Cubes créés sur les awards et objectifs : on n'a plus besoin de les cloner

2.8.1 Fr
 * Utilisation des couleurs dans les rapports pour 90% des actions, spécifiques aux joueurs, Bleu Noir, Vert et Rouge ont leurs textes dans leurs couleurs respectives
 * Yellow/Jaune a une option dans les settings pour choisir la couleur de son texte entre 5, parce que le jaune se voit peu sur fond blanc. La couleur par défaut est orange !
 * Corpo Ecoline marche bien, et s'arrête comme il faut après 14% d'Oxygène

A-2.7 FR

 * Les noms des joueurs sont affichés sur chaque fenêtre des cartes jouées
 * Icones plus petites et plus sympa pour Joueur Suivant et Passer
 * Retour de ces 2 icones sur le plateau principal des joueurs
 * Sur Venus, les 4 cités sont maintenant correctement alignées avec leur cube de couleur au centre. C'était à cause du deck initialement caché sur cette map si on ne l'utilisait pas. Les cartes projets et corpo de Venus sont cachées ailleurs maintenant.
 * Des cartes manquantes ajoutées et des images corrigées
 * Plein de boutons dans les menus
 * Les projest standards Aquifère, Foret, Cité envoient une tuile correspondante sur la zone Tuile Suivante du joueur en cours
 * Les cartes qui posent des villes quelconques envoient une tuile cité vers la zone Tuile Suivante du joueur en cours
 * Les cartes qui posent des villes spécifiques envoient directement une tuile cité vers la zone correspondante : refuge de phobos, ganymède, et les 4 cités de Vénus
 * Les cartes qui posent des tuiles spéciales envoient la tuile en question sur la zone Tuile Suivante du joueur en cours
 * Les cartes prélude et corpo qui posent des cités ou des forêts envoient la tuile correspondante dans la zone Tuile Suivante du joueur en cours
 * Les cartes préludes et projets qui posent des océans envoient une tuile océan vers la zone Tuile Suivante du joueur en cours
 * Mode SOLO - Passer lance bien la nouvelle génération en enlevant le mot PASSER de la corpo
 * L'autofocus sur les actions en cours est supprimé
 * Les plateaux HAND de tous les joueurs ont l'espace entre les cartes réduit à 15 au lieu de 50 pixels. Les cartes étaient auparavant trop éloignées
 * Chaque couleur dispose d'un bouton pour alterner l'ouverture et la fermeture des 4 fenêtres à sa couleur
 * La temperature max à 8° indique de nouveau un cube rouge
 * La temparature à 0° envoie une tuile Océan vers la zone Tuile Suivante du joueur en cours

Interface
 * Les maps Hand et Cards de chaque joueur proposent les boutons joueur suivant et passer
 * La map Recherche de chaque joueur propose un bouton Recherche Terminée pour envoyer un rapport dans la log
 * Next Generation ne lance plus de son - essai pour accélérer le traitement en multijoueurs
 * Règles au format texte plus lisible (UTF-8 ???)
 * La pioche de recherche à 10 ou 4 cartes pour la génération est explicite, avec un bouton
 * Les menus d'interface ont été remplacés par des boutons: actions/recherche Paramètres Inventaire Main et Recherche / masquer Tempo ....
 * Les gros boutons de modificateurs d'objectifs et Next Gen ont été envoyés dans le menu des paramètres, car utilisés rarement (effort du gouvernement mondial sur terre avec Vénus), sauf en cas de problème
 * Les niveaux 8 et 16 de Vénus donnent respectivement et automatiquement 1 carte et 1 TM quand on les joue à son tour (cf. Effort Terrestre de Venus)
 * Les niveaux -24 et -22 de la température ne donneront plus de prod de chaleur si jouées avec les gros bouton, hors de son tour (Effort Terrestre avec Venus)
 * Plus de cartes avec leur texte personnalisé en français
 * Le projet standard de purification de l'air de Vénus fait maintenant monter le TM de 1 point. C'était oublié.
 * De nombreuses cartes vont continuer de mettre un texte d'ambiance en anglais ... ca avait pris du temps de tout faire en anglais. Ca en prendra autant de tout traduire.
 * No modification in the code from 2.6.1 but all texts and images are in french and french only. This makes a smaller file, and no issue with he text in logs
 * Pour jouer en français et en français uniquement, tous les textes des logs sont en français et les images en anglais ont été supprimées

Expansions and Module EN
These versions contain both english and french cards as far as these were available. No more development for this version from kerkael. Bugs will still be adressed ! Please mention them. If you can scan vertical images with 280x395 in .jpg, that's always better to match existing images, or an extra treatment is required. kerkael

For new English versions of the module, see Module talk:Terraforming Mars. jrwatts

A-2.6
2.6.7c
 * VASSAL v3.3.3-beta1 uncovered a bug in the coding which was masked by previous VASSAL versions, making the module unplayable. This is a quick fix to make the module playable again, and has NOT been thoroughly tested.
 * Details of the bug: Properties in Beanshell expressions (curly braces, '{}') should not be enclosed in dollar signs. Previous versions of VASSAL just ignored the dollar signs, but 3.3.3-beta1 interprets them, replacing the property with its value before evaluating the Beanshell expression, causing the expression to fail (or always return zero, depending on the context).  This broke many Restriction traits, making most cards with any pre-req's unplayable.
 * This was repaired with a global search-and-replace using a regular expression. It is possible this removed dollar signs that should have remained (for example, if there were any literal '$' in any strings).

2.6.7b
 * [P25] Orbital Construction Yard & [P35] Acquired Space Agency still had an ugly left edge on the English images
 * Forbidden Area special tile - renamed to Restricted Area.
 * Volcan special tile - renamed to Lava Flows.
 * [052] Fish - changed report to mention the Plant production reduction.
 * [055] Kelp Farming - report said "Prod prod levels" instead of "Plant prod levels".
 * [089] Peroxyde Power - renamed to "Peroxide Power".
 * [147] Herbivores - wasn't prompting to remove Plant production from a player. Typo in "Report - play" ("Mard" for "Mars").
 * [200] Immigrant City - report said to manually increase Banker level for playing the card, but it occurs automatically (for this card only).
 * Tharsis Republic corp - wasn't increasing city count
 * Point Luna corp - wasn't drawing initial card.
 * Morning Star Inc. corp - added missing Permanent Effect.
 * Viral Enhancers Permanent Effect - was labeled as "Virus" instead of "Viral".
 * Mass Converter Permanent Effect - had 2 different effects listed. Deleted the first, incorrect, one.
 * card prototype - changed Scientific discount to apply multiple times if multiple Science tags are present (e.g., Valley Trust should get a discount of 4 on card [090] Research, with 2 Scientific tags).
 * Relay 8 Heats prototype - reworded to sound better in English.

Note: the Scientific discount change is a bit of a kludge, and may have possibly broken other cards; we probably actually need 2 sets of discounts, one per card and one per tag, as some other discounts only apply once per card no matter how many tags they have.

Further note: 2.6.7b was created using a development build of VASSAL 3.3.0. It *should* be playable with 3.2.17 if you manually change the VASSAL version number in the buildFile and moduledata files within the .vmod archive, but I make no promises.

2.6.7 New icons : Next Player, Pass, Research Phase Prelude Cards in english still had issues with images. Should be fine ...
 * [008] Capitale - would not check for Power Prod before letting pay with steel
 * [029] Cupola City - would not check for Power Prod before letting play the card
 * [110] Business Network, [111] Business Contacts, [192] Invention Contest ... and all cards allowing for searching cards would not work since the new Draw 4 button for research phase.

2.6.6 All missing English images are in now ! Many contributors for this ! Thank them !
 * [002] Asteroid Mining Consortium !!!!! Not Steroid, of course :)
 * [012] Water Import from Europa : proposes to pay in Titanium with credits. Can't consume more than 4. Is restricted when 9 oceans already in.
 * [187] Aquifer Pumping : proposes to pay in Steels with credits. Can't consume more than 4. Is restricted when 9 oceans already in.
 * [176] Noctis Farming : Added missing VP.
 * [215] Air-Scrapping Expedition : had Space tag, should have Venus tag instead
 * [256] Venus Magnetizer was not increasing scores or Venus% all fine now
 * Also, the claimable effects are back, after a few versions. I didn't think they were so popular :)
 * Some images were tested with transparency, with round corners. Requiring .png they were 3.5 times biggers, and would add 10MB to the module. I made them jpg. Sorry for the corners and transparency.
 * I made this compatible with official version, instead of the 3.3 beta I received from the new contributors (with the images)

2.6.5
 * Draw 10/4 cards is now a button below research deck projects (Stil right clic on the deck to draw 1 out of research phase)
 * Show ALL is a button for reorganing windows for each color - il like it, as it switches between closed/opened windows
 * Solo game is now ok to pass -> Next Gen
 * Button for Objectives shows a target (that's the icon) to play woth World Gov Effort with Venus Next ! They were hidden in 2.6.4, sorry.
 * Thorgate corpo was not working, plus it was not moving - it is now
 * A few prelude images are still not in english (or badly trimed)
 * vmod zip file was cleaned from useless images
 * Missing english basic projects images for :
 * [002] Steroid Mining Consortium
 * [013] Space Elevator
 * [014] Development Center
 * [025] Space Station
 * [046] Lightning Harvest
 * [057] Vesta Shipyard
 * [061] Great Escarpment Consortium
 * [065] Building Industries
 * [066] Land Claim
 * [108] Open City
 * [153] Adaptation Technology

2.6.4
 * Next Player and pass are back on all individual players Hands and Cards boards
 * Research done is present on Research board for a nice report
 * [195] Indentured Workers - discount should not be reactivated if the card is flipped again
 * Big buttons/new icons
 * NEW REAL ENGLISH IMAGES for Prelude, Corpose, Venus (thanks to Furrball)
 * Playing without Prelude keeps the 7 Prelude Projects cards out of main deck
 * still some delays ... probably improvable code
 * still misses a few cards in english

World Governement on Earth Effort modifications:  (this is an option when you play with Venus Next, to play shorter game, the current First Player before Next Gen will increase 1 of the 4 major objectives, with no personal benefit. Due to the auto-NextGen when all players have passed, you will need to do this after Next Gen has been sent, and before any card is drawed)
 * Oxygen +2% big button does not give any TM (but placing a forest, or +Oxy from a card does)
 * Oxygen 8% reached will always push Temp (but does not give TM if coming from big Oxygen button)
 * Temperature +2° Temp big button not give any TM, nor -24 and -22 steps any extra heat prod (but std project Asteroid, or +Temp from a card does)
 * Temperature 0°C reached will always add an extra Ocean( but does not give TM if coming from big temp button, or +8%Oxygen))
 * Venus steps 8 and 16 will generate card pickup and extra TM (but not if coming from big button)
 * City tiles were turned in Greeny ... Now it says Greenery !
 * delays in NextGen were caused by many cards with ALL PIECES option. This is now ok. Always use NO PIECES when you create a module ! Please report if the issue is still there (precise which color generates the problem).
 * Next Gen + 1st Player Token moved Automatic after Last Pass
 * Playability
 * Big Image below the current player's corp shows who's turn it is
 * Current player AND 1st player markers move with Next Player / Next Gen
 * When a player Passes, it's written PASSED on their corpo in big characters
 * With 3 players and more, the pass/next may not always work this requires extra testing
 * But as the actions are not blocked even if it's not your turn, this can be worked around, in case there is a problem
 * Playability
 * Added many Alerts/Message for placement restrictions
 * Added a message for South Pole on Hellas Board
 * Alert Message for Cost Preview (with discounts) in research and hand
 * Extra zoom level for minimum
 * 2 Texts available in research window to help playing 1st turn sequence


 * Player Attributes
 * Other Cubes update : Green says Blue ???? - sorted out
 * All Special cards count as Other cubes for the landlord (but the Capital)
 * Inventrix Corpo : Gives Option to Draw 3 cards during 1st Generation only, once on the board

Design
 * Players Maps renamed Boards in each menu
 * Background Red Board back in red (was missing in previous version)
 * Next Player / Pass buttons : generic on main board (works for the current player); individual on each Player Board (can be clicked by another player)
 * Game Setup
 * Proposes a Close button for all players (as Ready is removed after clic)
 * In a backup/restore situation, all the joining players would see the Game Options again - no longer, after Gen 1

To-do list Gameplay
 * Players Turn will move Active/Pass around the table when buttons are clicked
 * Next Gen should be automatically launched when all the players have passed
 * 1st Player token will move too !
 * Menu and behaviour
 * Game is launched with a setup menu : Main Map hiddent untill selection is made
 * Users have to click on their chosen color so they're counted as "in the game"
 * Options for Prelude, Venus Next, and also Xeno Corps is proposed
 * If only 1 player in, the game is automatically set as solo game with start at 14 and all other color cubes removed
 * player colors are placed around the table based on seat : 1,2,3,4,5 - First Player token set accordingly

Design
 * Main Map has a button to show/hide. This will not end the game.
 * New Startup Key Command: bing ... which can be used for startup options/windows/selections

Future options
 * Players icons to explicitely show : pass/still in/ Active player
 * Draft

A-2.4
2.4.1
 * Bug with multiple automatic pick up cards is solved.

2.4
 * Project cards that would pick up cards are automatic ... with a bug. It looks like they pick the cards twice.

A-2.3
The 2.3.x versions are being updated for bugs and incomplete development.

2.3.8:
 * Almost all cards with choice propose it when played.
 * Venus cards still not all set with all prerequisites.
 * Next step is to have all Venus cards done.
 * Also, possibility in the future to get a random distribution for awards and objectives instead of fixed 5 or 6 by map (with Venus)
 * Standard projects are working with special cards and discounts now
 * Cards with points depending on tags (Jovian tags for Jupiter) or cities or nearby oceans (like capital) now treated as units cards. Add a unit for the matching property, and the points are automatically counted (easier that way)
 * standard projects cities and greeneries are now counted in Player Attributes, so it's easier or points AND for cards using these properties
 * No card that would allow to draw additional cards is handled at this time ! This requires advanced coding and searching for de the developer :)

2.3.7: For example, some Blue unit cards propose an Action to remove a unit, when it's not compatible with the game play. As it's still possible to destroy, steal or remove units from some other card action, I made this possible with multiple choice :
 * Add 1 Unit hidden once the card has been tapped, or if there is no action on the card
 * Remove 1 Unit visible only if there is more than 0 unit AND if the game play authorize to use a local action to remove
 * Add 1 Unit (no action) visible for all cards that can store units
 * Remove 1 Unit (no action) visible only if stock > 0

Color Cubes used as markers are not removed from all cards when moving to next generation.

Global requirement modifiers: +/-2 permanent or temporary are working even with corpos like Venus Morning Star Inc

Text should be hidden when card is marked. Just a question of trait position, but many cards to edit now :( (as there are too many prototypes to find where to do that correctly)

Still no "This is Player Blue Turn" nor preset game for solo, nor tuto to start with. I will do one, some day.

version beta Fusion with Venus Next Expansion - self sufficient module Many automatisms (not finished yet) Still testing some cards. They will be ready in GA.
 * Milestones and Awards playable onboard by clicking on the cost button (8,14,20)
 * Pre-pay with Steel for Building cards
 * Pre-pay with Titanium for Space cards
 * Major prerequisites prevent from playing cards if not met
 * +/- 2 for major prerequisites working as well
 * Color cubes easy to play on tiles by a simple clic (each tile can only be activated once, with the 1st color cube it receives)

A-2.1
New sounds for : New Automatisms for:
 * Onboard actions
 * Score+1 for each user (Monty Python Holy Grail reference)
 * Premium Objectives
 * Corpos when played : revenues and immédiate actions
 * Onboard actions (Asteroid, city, greenery ...) - Available ON THE BOARD, by clicking on arrows
 * Individual 8 plants conversion and 8 heats conversion

Next step :
 * Automatisms for all project cards to pay/receive money and resources

A-2.0
This new module includes Hellas and Elysium so they are easier to maintain. Also included, prelude, as a permanent option to choose in multiplayer or solo. Rules are included as text files in the help menu for Hellas and Elysium maps, as well as for Prelude, as well as for Solo game new rules.

2.0e A new Era of Automatics

 * Automatic corpos for corpo era, prelude, xenos
 * means money and startup productions are automatic
 * New sounds
 * previous HotDog temperature was too high
 * New buttons in player maps :
 * Convert 8 plants checks the number of plants, consume 8, and raise the oxygen immediately
 * Convert 8 heats checks the number of heat units, consume 8, and raise the temperature immediately
 * automatic -20 and -24 degrees raise Heat Prod

Details
 * Venus Next.
 * Works with and without Hellas & Elysium. If you want to use both, Hellas & Elysium must be in 1.0b
 * Only French cards were available to me when I developed this expansion. If you have English cards, scan them, and send them to me :)
 * You need to send projects, corpos and award and milestones tiles manually to the main board if you want to play with Venus Next
 * Read the rules : you still play with 3 premiums objectives that define the end of the game, but Venus is another premium objective to earn TM points
 * Rules are different for solo game : 14 generation to reach the 4 premium objectives !!!!
 * Read the rules !!!

Obsolete

 * Hellas & Elysium 1.0b expansion is now obsolete and should not be added to version 2.0.
 * It can only be used with version 1.5b and 1.6.
 * There is no compatibility with previous saved games and the version 2.0
 * Help is available in help menu to explain the awards and milestones specific to these 2 maps
 * Pre-setups : It becomes to long to handle pre-setup for all the boards, so only solo games are available in pre-setup Venus Next remains available, without a presetup.
 * Solo : available on each of the 3 boards, with all Score Cubes at 14, and all Corpos and Project cards mixed up with the decks.
 * Multiplayer : Era Corpo - Start with a No Setup, then send the Corpos Discard pile to mix with all ; you send all the projects to the deck as well, with a click on it.
 * Multiplayer : Standard - Start with a No Setup, and don't send Corpos and Projects from the additional piles. Then add +1 to each user productions !
 * To play on the Original Board game, you don't need to deactivate the extension - just chose the board after a No Setup.

Best Practices in Multiplayer by log

 * If you can, Start the game online with all the players, this will accelerate the process, Corpos selection, and 1st 10 cards research
 * When you save an online game, You can use the .vsav to continue the game by turn, but there are no logs in it. So you really start where the game was saved.
 * Suggestion of log naming, for a 3 players game, Red, Green and Blue playing : 3P - log 004 - gen1 - RGB - blue - green next.vlog
 * - 3P : Using a first ID to distinct from other games
 * - log004 : increment after each player's turn
 * - gen1 : keep the number of the active generation visible in each log name
 * - RGB : very important, this will change at each generation, indicating that Red is the first player in that generation, and players will cycle RGB RGB RGB until next gen - GBR GBR GBR ... and so
 * - blue : this is the blue player turn - the log was created by blue
 * - green next : also quite important, especially if red has passed, blue will mention immediately that green is the next player, as in RGB it should be red
 * Click on Pass if you're certain not to do anything else during this generation - especially if you have a very low level of money/steel/titanium/plants/heat, no action card, no cards in hand. This will accelerate next turn
 * Click on 1st Action, then 2nd Action to log what you have done in a standard report
 * Play your turn immediately during research phase, if you're 1st player, and don't care about what other players would do in their research
 * - wait for other players research if you think they could pick up some cards with prerequisites you could blast of during this turn ! You may give them too much info too early by playing to fast
 * Report in plain text when what you do is not explicit from the logs !
 * - The game reports are more and more complete so you don't need to talk in the logs, but it may be useful to remind when : you fulfil the prerequisites, you pay with titanium, your titanium or steel is worth +1, you use your corpo specific powers (there is no such thing as Action / Unit on the corpo cards, so this is to be done manually !!!)
 * - log, log, log and report
 * Use Saved Game Folder in the Module Library
 * - so you see in which version the log was saved, as well as the description the last player mentioned
 * - We are still improving the module development, and sometimes the saved game have to be updated - can be done from the module editor but not everyone may want to do this :)
 * Don't use a synchronized folder (dropbox, googledrive, Box ...) as the Saved Game Folder
 * - You may be creating a log, while still playing, that starts to be synchronized as an incomplete file ... and the next player picks it up before it's complete !
 * Don't open 2 instances of the game at once (like one online real time and the other as a turn by log) - You may completely mess the logs your are playing and both games would be ruined !
 * Have fun

How to play (V1.5)

 * Corpos with an effect will automatically have this effect claimed when kept to hand.
 * Blue Project cards with an effect will report : User should claim the permanent effect ... from the Effect Inventory list.
 * Inventory will easily show you which effects a user can invoke (so no need to repeat each time you have a reduced cost ...).
 * Each user will have their own claimed effects visible in their hand, making it easy to remember what to apply. (But the effects images don't stack, so organise them as you wish.)

Modification : During research phase, you can't send/keep a Corpo to hand ! You need to wait for the actions phase. This to prevent report log showing that you may claim an effect, thus giving too much info to your opponents !

How to play (V1.4a)

 * Menu : On Board Actions (nothing automatic, but normalised reports to help the game)
 * Standard Projects
 * Menu for Milestones and Awards
 * Menu for plants and heat conversion
 * 1st player token placed on top left position on the map, and 5 color cubes ready
 * Pre-defined setups :
 * Multiplayer
 * - Era Corpo - All corpos available And cube colors ready on the board)
 * - Normal - additional corpos are in the corpo discard - can still be added by right clic on the discard, as well as the era projects, not shuffled yet with all the other cards. You would still need to increase all prods to +1 if playing standard game
 * Solo
 * - All colors set on position 14 - All corpos available with all the cards, as the solo game must be played in Era Corpo
 * Actions and Research Phase buttons
 * - These should prevent from doing things during incorrect phase (not perfect yet, like calling Research in Next Generation not working)
 * Translation
 * - Some reports - in french
 * - Only report should be translated to avoid issues with the code
 * 1st action, Next Player, 2nd Action, Pass
 * - Buttons options available to normalise report to make the game clear
 * 1d36 - 36 faces die to decide who starts :)

Known bugs :
 * Blue Cards action cubes not removed anymore during next generation - you will reset them manually, like on the board game, until fixed
 * Next Generation should reset phase to "research" but it does not work
 * Prevent all unwanted actions during research, and vice versa

Next improvements :
 * prerequisite shown for on-board actions (if possible)
 * reports should be able to display some calculated properties ...
 * Venus Next ??? As an extension ? Not that difficult to implement, but I only have French Cards !

How to play (V1.1.2)

 * Standard Projects available from a menu
 * They don't automatically check for prerequisites, nor do they consume resources
 * too many specific situations where you could pay less or get reimbursed, depending on some corpo so they just report actions
 * French cards available along with the english cards.
 * No more french version of the game interface and reports - this would make the game bug.

In multiplayer game, after each player has set his color, the Game Master will roll the dice to define the order of players. Then the Game Master will place a colored cube in each of the 1-5 location on the main map, and wait for each player's corporation Card. The Game starts on Generation 1, Research Phase. That phase blocks any activity not related to research.
 * Generation 1, Research Phase

Players will draw 2 Corpos Card and 10 Project cards directly sent to their research.

With or without a draft, the unwanted project cards will be either passed to next player's color, or discarded. The unwanted corpo will be discarded.

Once everybody agrees and has discarded their cards, it's the end of Research Phase : Players will keep their corpo AND their projects.

Kept projects are automatically paid 3M€ when sent to hand.

Both research and Hand are hidden from other players. This 1st Actions Phase of the game should start by each player revealing their Corpo, claming for their starting credit, and placing that corpo on the Main Map.
 * Generation 1, Actions Phase

Only after they chose for their corpo and received their initial money should the players clic on Keep Cards from their research, so the money is correctly calculated from the beginning. As the hands are hidden, we can only rely on the log messages to count the number of kept cards for each player.

Each player plays 1 or 2 actions then ask for next turn.

After a complete round, players can play another set of 1 or 2 actions. This is repeated as many times as wanted until all players have passed.

A player who has passed is not supposed to play again during the generation, but this is not enforced.

Game Master then pushes on Next Generation AND must set phase to Research manually. The Corpos are locked and can't be drawn anymore.
 * Next Generations, research Phase

The Projects can be sent to research 4 by 4, for each player. If a player can draw 1 or more cards, they will be sent directly to hand, and not in research. They don't cost anything, unless said so by the triggering action (like the Inventors Guild). It's then up to the player to pay 3M€ or discard the card.
 * Actions Phase

Discarding a card is not possible from the hand ! It's called Selling Pattent, giving 1 M€ per card. It may be necessary to reimburse that credit if the triggering action is the Inventors Guild and the card should be discarded.

Eeach player has now a 4th board (v 1.0.8 and after)

Research Hidden from other players, used during each research phase at each new generation.

During 1st Generation, the research phase allows to draw corpo sent directly to the research board. They can be flipped, but I see no reason to do so. Suggestion is to place the corpo on the main board after this initial research phase.

Players should not clic and keep any of the research cards before they have shown their chosen corpo and set their initial amount of MegaCredit on their Map. That will ensure the cards paid 3 MegaCredits will find funds in the player's account. As there are some Corpos starting with less than 30 M€, it could cause a problem if they decided to keep the 10 cards ... Better to have the money, no ?

If draft was decided as an option, then the Game Master will mention the direction of the draft in the log (Black --> Blue --> Red --> Black, for example) at each Generation (even and odd turns use a different direction). Players should not pay to keep their cards until the end of the Research phase, so they can decide once they have all the researched cards available. So that's on the research board where the players can place some cards in a corner, and pass the others.

It's useless to flip a card before it's passed, as any card landing on the research board will be faced up. So this option has been removed. Only red cards can be flipped, and this should only be done on the cards board, once they are played.

''' Log Log Log what you do ! '''
 * As some cards won't be visible after they have been played, players are invited to comment their actions.
 * As some cards will be paid with steel and/or platinium, players are invited to comment their values and costs.
 * Players should only use the Play Card action from hand when they want to pay in Mega Credits ! This will be taken from their account, even if they don't have enough money ! Money can't drop below zero, so you need to comment your buys.
 * If you are certain you won't play another turn but you played an action, especially on a turn by turn game, clic on the Pass button after your action(s). So next Generation will be started sooner. (The Pass button does nothing but logging your choice to pass.)

Try to respect order when you play a card. (This is just a recommendation)
 * Mention the prerequisites, and how you fulfil them
 * Mention the price and how you pay
 * Mention the reductions and why you pay the whole price then got reimbursed
 * Get the reimbursed money immediately on your account
 * Then apply the one-shot effects mentioned on the bottom of the card
 * Apply effects from left to right
 * Immediately apply the global objectives on the main map if the card has an effect on this
 * immediately increase your score (TM+1) after any move on the global objectives
 * remember : a forest does not give you an additional point during the game : it increases Oxygen level. Only if you can still increase the Oxygen level will you earn a point after placing a forest ! Once 14% has been reached, don't take any TM when placing a forest.
 * log you actions one by one !
 * If you play a standard project, say so ! And consume resources before applying the effect
 * If you play an action from a blue card, say so ! And click on the Action option on the card. This will both log the action and place a coloured cube on it.
 * If an action has a cost to be executed, you will mention the action you're about to play, then pay the cost, then play the action, then gain the revenue it provides.

How to play (V1.0.6 and later)
Each player's map has a Universal Modifier button in the middle, associated with 4 buttons : The modifier can take any value between 1 and 99 (99 is quite big)
 * -- takes 10 from the modifier
 * - takes 1
 * + adds 1
 * ++ adds 10

Each player's map also has a + and - button associated to each production and stock. These buttons will add or remove the value of the universal modifier from the item. It's still possible to edit the value of each of these elements from the toolbar buttons, but faster to use +/- when you want to add/remove 1 or 2 units.

How to play (V1.0.5 and later)
No rules enforcement in this module. You play as if you were in front of the board game.

Just a few securized/automized elements, though :


 * Cards from corpo era can be sent in one click to the main projects cards deck.


 * Right click on the projects card deck allows for multi-pick : chose 10 for the 1st research, then 4 for each future generation. The number only applies for the next pick-up, afterward it's going back to default 1 by 1. Additionally, it has Draw 1 Card and Draw 4 Cards that directly moves the cards to the hand and flips them


 * each player has 3 boards (v 1.1 and after) :

Map Visible by all, indicates production and resource levels. There are toolbar buttons to change each of them. On Generation advance (through the main map) all resources are updated accordingly.

Hand Hidden from other players. Cards MUST be placed here from the main board projects Deck, so their name is hidden from each player. During research phase, if you want to buy the cards, you have a reminder of 3M to pay for each. If discarded, they will go to discard pile as hidden from other players.

Cards Visible by other players, but private. This means one can't move cards on another player's board. This to avoid looking at the red cards after they are played. On this map, blue cards may have resources and/or ACTION action. The resources increases or decreases a counter that is shown with the card; the ACTION is a reminder that the cards has been activated, and should receive a coloured cube until next generation. On next Generation this cube goes away. Play by the rules, and all is fine.

Other Features


 * Bonus TR: when increasing Temp or Oxy, the player gets the TR and any bonuses in production, as well as advancing Temp on Oxy 8%.
 * Game Piece Inventory counts cards in hand, to see if the player claiming the milestone has 16 cards or more.
 * Counters on map (TR, Oxy, Temp tracks; Oceans, Greenery and Cities in map; milestones and awards locations) snap to location.

Solo Game * Choose a color * Change the Score counter for this color to 14 * Move the colored cube on the track from 20 to 14 * You have 14 generation to fulfill the 3 objectives ! This is the rule ! * Don't cheat, there is no draft : you start with 10 cards and pay for the ones you want to keep. At each new generation you draw 4 more cards, and you pay for the ones you want to keep. * You only count your point if you finish the game in 14 generations. There are no Milestones or Awards to be dealt with. * If you must reduce some production for a card to be played, this is always possible by considering a ghost player who always have something to lose. Good Luck.

Module 1.0.2 - en & fr
Sorry for the size of the module, but with both english and french cards, this makes more than 20 MB. Unfortunately this can't be done with an extension.

More Counters Added as global properties There are 13 counters for each player. Player Black (and any other color) has a button to increase his TM level by 1. On the Player Black Map, there are 6 boxes with the level of each of the 6 production : Income, Steel, Titanium, Plants, Energy, Heat On the Player Black Map, there are 6 boxes with the amount of : Money, Steel, titanium, Plant, Energy, Heat Below the TM Level and Banker Level, there is a vox for Total Income in M€.

Automatic Counters - Next Generation When the Next generation button is pressed, all Prod will increase the amount of all of the 6 productions level (including the Total Income calculated from the TM Level and the Banker Level) When a Player TM+1 button is pressed, the TM Level increases for this player, plus of course the total income, and the colored cube will move on the track around the main board.

Score Cubes Moves on the track 5 cubes (1 per color) are placed at start on the level 20 on the main board. No need to delete/remove them (anyway, it's not possible) even if less than 5 players are playing. These will move around the board, and shoudl correctly handle the curves at 25, 50, 75 and 100. Still, the +1 at 100 may generate a problem and be counted twice. Don't worry, just replace the cube on the board. Each cube can be manually moved on the track ... this allows for the colored cubes not to be always hidden by another player's :) As the text window tell you at which level a player's score cube should be placed, you can correct this manually if you want. Counters Each player has a counter that can be manually edited from the Dice & Counters menu ... so you can add 10 points by hand if you want, usefull at the end of the game.

Sounds

A sound has been added for each of the 4 major counters : lake, generation, temperature and oxygen. Just reduce the sound if you don't like them.

Next Steps


 * Buttons on the board for the Standard projects to be paid automatically from the user's money.
 * Buttons/counter/property to pay for the cards ... this is NOT automatic at this time.
 * Buttons to revendicate the milestones and bet on the awards, placing a cube on them, and paying from the bank

Module 1.0.1 - en & fr
Localization

English and French available Translated Cards Translated Logs Module size
 * Translated logs and cards are independent
 * Even if you don't want to play in french, the module has a lot of new fatures
 * All the cards have been scanned in both english and french - players can swap from en to fr from the menu (2 flags shown)
 * The logs have been duplicated in french too - this requires to change the Vassal preferences and restart the engine to have the game in french
 * With twice as many scanned cards, the en & fr module is 22,2 MB - Hey, what did you expect ?

Added Features

Counters Set Up Maps Blue Cards
 * Counters are used for the 3 major objectives and the generation
 * Pushing the objective button moves the White cube on the track (except for the lakes, as there is no track), and gives info in the log that the player should also move their TM marker
 * Oxygen 8% pushes Temp +2° ; Temp 0° tells to add a lake and increase player counters
 * If you don't rely on a saved setup game, you must place the correct White Cube on the main board : the 3 cubes are distinct, as they move with the counters push buttons
 * Suggestion is to use a 5 players saved setup game, and not opening the non-played colors - probably remove their TM counter from the track as well
 * Each color/player has 3 maps : hand, cards, map
 * The hand is invisible from other players and raises warning about the price of cards brought to it ... from the research phase
 * When a card is moved from hand to cards, it raises a warning about the card cost that should be paid by the player
 * On the cards board, blue cards can have action and/or color cubes + unit cubes placed. These may need to be moved manually instead of stacked, as they would not be easy to see at the end

Version C
Version C of Terraforming Mars is an English-only fork of version A, 2.6.7c (English & French).

(Versions 1.0.x were assorted incomplete test versions, playtested with a local group.)

Version 1.1.0 changes (from version A-2.6.7c EN)
Maps/Tiles --


 * Added 2 player-made maps: Arabia Terra and Vastitas Borealis.
 * Updated 3 original maps with space for Stanford Torus and future Colonies expansion.


 * Added buttons to the maps to claim placement bonuses (each hex with a placement bonus now has a button which can be clicked to claim the bonus; right-click menu allows for removing the button without claiming the bonus, e.g., if tile was placed by World Government during Solar Phase).


 * South Pole (Hellas) and North Pole (Vastitas Borealis) hexes have buttons with a large exclamation which can be clicked to claim their special placement bonuses, or right-clicked to read their special restrictions.


 * Also added right-click menu option to Ocean tiles to claim the 2 M€ bonus for placing a tile adjacent.


 * Special tiles now have correct images for each tile, instead of mostly cities. They should now be listed in alphabetical order when you are selecting a specific tile. Their names now all match their respective Project cards (e.g., "Nuclear Zone" rather than "Nuke Zone").

Miscellaneous -


 * Replaced all $ $ occurences within Beanshell expressions (curly braces '{}') with just . The former was an error which Beanshell ignored with VASSAL 3.3.2 and before (due to a VASSAL bug), but causes the module to fail with VASSAL 3.3.3-beta1!


 * Modified the "unit" prototype, making the right-click menu options trigger separate commands to adjust the qty of units, then report, so cards can suppress the reports if they want to do their own reporting, or still trigger the "Plus 1", etc. actions after disabling their menu options.


 * Removed all French images to save space.


 * Added descriptive reports to all cards that didn't already have them, when played or activated. Also added the card flavor text.


 * Color-coded the player boards so it's easier to tell them apart when they fill their windows.


 * Per the Comprehensive FAQ (downloadable from BGG here: https://boardgamegeek.com/filepage/199985/comprehensive-faq-and-card-clarification-reference), all discounts are now applied per tag instead of per card, even if the text on the discount says otherwise:  i.e., cards with two of the same tag will get the discount applied twice.


 * Added display of number of Project cards remaining in deck and discarded.


 * Game will auto-advance to the Actions phase after all players click "Research Done" buttons.


 * Moved Permanent Effects menu item to the main toolbar.


 * Updated hex grid location/size on all main maps (Tharsis, Hellas, Elysium)--Elysium in particular was noticeably off. Note that the hex sizes vary slightly from map to map, so on some maps there are noticeable gaps between the tiles when played.  Decided that was preferable to having the tiles getting farther off-center the further you went from the center of the map....


 * Updated Venus Next board positions (English board image is positioned/scaled slightly differently from the old French board image).


 * Added more City/Greenery tiles (to a total of 60, to match the physical game)--yes, we actually ran out of them in a 4-player game!


 * Added Ctrl-Z hotkey for Undo.


 * Removed extra buttons from "Help" window (only zoom buttons are useful).


 * Minor typos on multiple cards fixed. Lots of weird phrasings changed to something clearer.  Terminology standardized to match the board game (e.g, "M€ production" instead of "Banker Level" or "income", "Power" tags and "Energy" resources [the two were used somewhat interchangeably before], etc.  Note that a lot of the internal property and trait names were not changed, but all text visible to the players should have been [exception:  Player Boards still show “Money” and “Banker Level”]).


 * Removed reference to French from module description. Various files, properties, and traits translated from French to English (not complete).


 * Removed wording about "checking total hand count" from the report for the "Draw 1 card to hand" action of the Project deck.


 * Moved Promo Projects and Corps to separate decks with startup button to add them (or not).

Projects & Preludes ---
 * [001] Colonizer Training Camp - prePayWithSteel option enabled (but didn't actually do anything) when requirements not met.
 * [006] Inventor's Guild - added missing card
 * [023] Arctic Algae - Didn't say to claim Permanent Effect.
 * [044] Natural Preserve - tile was listed as "Nature Preserve" in tile selection window.
 * [095] Physics Complex failed to change the player's "UnitsVP" total if the "No Action" options were used to change the quantity.
 * [097] Nuclear Zone - tile was listed as "Nuke Zone" in tile selection window.
 * [140] Lava Flows - Corrected Alert to say the Tile has to go on one of the 4 Bold text Volcanic Areas, that the card can't be played if all Volcanic Areas already have tiles, and that it can be placed on any non-reserved site if using the Hellas map (per official rules)--it previously said not to place the tile on Hellas.
 * [178] Heat Trappers - Corrected Alert to require both units of Heat production to be taken from a single player (see official FAQ).
 * [185] Olympus Conference - Now automatically gives itself the first resource for playing the card.
 * [206] Special Design - report said to flip after next card played, even if in next generation--the card must be used in the same generation, so corrected report.
 * [P12] Experimental Forest - now automatically opens the Tempo window and draws the first card to check.
 * [P35] Acquired Space Agency - now automatically opens the Tempo window and draws the first card to check.
 * [P37] Lava Tube Settlement - see [140] Lava Flows, above.
 * [P39] Psychrophiles - Now prompts for how many units to remove, instead of having to remove 1 at a time.
 * [222] Dirigibles - Now prompts for how many units to remove, and gives you 3 M€ per unit.
 * [243] Rotator Impacts - couldn't spend Titanium on action.
 * [248] Stratopolis - Right-click +1 action only added one Floater to card (should be two).
 * [251] Sulphur-Eating Bacteria - Now prevents you from removing more Microbes than it actually has.
 * All Venus Next cards which could add Floaters to themselves or other cards now have separate right-click options for each choice.


 * [211] Snow Algae - added promo card
 * [212] Penguins - added promo card
 * [X01-X12] Promo cards released with Turmoil added (except [X09], which is useless w/oTurmoil; it’s coded, but stored in a hidden deck and not currently used).


 * Standard Projects - now report when a rebate (e.g., from [156] Standard Technology) is applied, rather than applying it silently.

Corporations


 * Celestic - Added separate right-click options for adding Floaters to itself or another card.
 * Credicor - right-click option to add 4 M€ wasn’t working because it was restricted if map != “cards”...should be map != “playground”.
 * ECA - Standard Project rebate was not functioning because the card setup was looking for the wrong command ("play" instead of "KeepCorpToHand").
 * ECA - Added 2 M€ to the Mark Action for selling a patent
 * Phobolog - was giving Black an extra Space tag, no matter who played it!
 * Pur & Kleen - added counter to be updated manually to track score for oceans adjacent to your cities.
 * Robinson Industries - added right-click menu options to raise production as corp. action -- only the option(s) for the lowest production(s) will be available to click.
 * Saturn Systems - not giving the automatic M€ production for playing the corp (due to its Jovian tag).
 * Shinra - not giving the automatic M€ production for playing the corp (due to its Power tag).
 * Thorgate - copied "st3" Calculated Property from AnyStdProject prototype so Standard Project rebates (e.g., [156] Standard Technology) are accounted for when activating the discounted Energy Plant project in the same way as when activating a Standard Project normally. Also see Standard Project change above.
 * ViTOR - increased starting money to 48 (from 45) to account for the 3 M€ granted automatically for playing the card (due to its VP icon).
 * Weyland-Utani - increased starting money to 50 (from 48) to account for the 2 M€ granted automatically for playing the card (due to its Science tag).
 * Added 3 more Beginner corporations, so everyone can have one! (Note that they are not coded, and so do not grant the correct starting money or give the player their 10 project cards for free.)


 * 6 Promo Corps added

Future fixes and improvements (in no particular order)

Add reminders for mandatory first actions (from corps.) to Player Hand windows.

Add rebates as well, and set them up to be applied automatically. As a corollary, update "Discount, Attributes, and Properties" window to show rebates. Also can remove "Cloud" Tags and Discount (no idea what that was for). Would be good to also add count of green cards & blue cards and Total Score. Can also remove "Red Card VPs" from list; it isn't actually used and would be redundant with the generic Card VPs, anyway.

[023] Arctic Algae - effect report triggered when card was drawn--haven't been able to reproduce. [P10] Ecology Experts - automate its card play. [P11] Excentric Sponsor - automate its discount. [210] Self-Replcating Robots - added promo card, but is still totally manual (card is currently stored in a hidden deck, and will not be shuffled in). [X09] Political Alliance - programmed, but needs Turmoil

"Cities/Greeny" stack.

Emptying research hand should be equivalent to clicking "Research done".

Edit Permanent Effects to specify which are automatically applied. Add GPs to track # of PEs collected by each player, and auto-offset new ones so they don't overlap. Auto-add PEs instead of prompting player to add manually.

Copy version A2.8.3 (French only) updates (color coded reports, tiles pre-placed when bought).

"Increased Blue Bank Level"

Move "Passed" markers off the main map.

Deal cards automatically at beginning of game/start of the Generation (similar code needed for [247] Sponsored Academies to draw cards for other players).

Automatically send discards back to Projects if a card is drawn with the deck emptied.

Add code for beginner corporations (set money to 42, draw 10 cards straight to hand--or possibly move all cards from research to hand, on the assumption they've already been drawn to research?). Possibly add an option for enabling beginner corporations, removing them from the game if not enabled.

Auto-deal all starting cards (Corporations, Preludes, Projects) to players. To support beginner corporations, will need to query each player if they intend to use one.

Split Corporate Era cards out of the main deck, and add option to add them in at start.

Split map into multiple boards, having only the actual map image change.

Move corporation cards (and possibly 1st-player marker) onto player card boards. Delineate locations for corp, prelude, green, blue, and red cards, and permanent effects. Place new cards in the correct locations automatically...blue cards with actions should not overlap.

Move all corporation decks (and Prelude decks) off the main board.

Automate enforced first-turn actions from corps.

Automate all card effects.

Disable Action/Research buttons when already in matching phase.

[004] Cloud Seeding allows you to pick someone with no Heat production. [218] Comet for Venus allows you to pick someone with no Venus tags.

If another player adds a unit to your VP card, they get the points.

Add Turmoil expansion.

Add Colonies expansion.

Add drafting option.

Have cards that require you to dig for projects with specific tags automatically pull the required cards from the deck, instead of requiring the user to manually draw a card at a time and discard the non-matches. Perhaps include an option to enable the old (current) behavior, for purists who don’t like skipping the discards. May even be possible to automate the current behavior, actually….

Unmark doesn’t remove the cube.