Board Game Arena - User contributions [en]

Bugsclarification daybreak

2026-04-29T20:50:16Z

Kayvon: Better formatting

Please note IF THE GAME DID NOT END when you expected it to, you MUST check that you have achieved all of your challenge cards.

You'll know you have a challenge card because you CHOSE one when the game started.

You'll know which one it is because it's on the game panel.

And you'll know that it stopped you from winning because the GAME LOG specifically mentions that the challenge card prevented your victory.

Bugsclarification parks

2026-04-19T14:00:34Z

Kayvon: Created page with "'''Bug Clarifications for Parks (new version)''' === Starting without the campfire lit === '''This is completely normal and intended.''' In the new version of '''Parks''', the campfire starts '''unlit''' at some play counts. Please '''do not file a bug report''' for this. Thank you!"

'''Bug Clarifications for Parks (new version)'''

=== Starting without the campfire lit ===

'''This is completely normal and intended.'''

In the new version of '''Parks''', the campfire starts '''unlit''' at some play counts.

Please '''do not file a bug report''' for this. Thank you!

Gamehelpnotalone

2026-04-05T19:55:42Z

Kayvon: /* Phase 4: End-of-turn actions */ Punctuation fix

[[Category:Card games]]
For tips on how to play not alone, see [[Tips_notalone]]
== Object of the game ==

* NOT ALONE is an asymmetrical card game, with one player (the Creature) playing against the other players (the Hunted).
* If you play as one of the Hunted, you explore Artemia using Place cards.
** By playing these and your Survival cards, your aim is to avoid being hunted down by the Creature until help arrives.
* If you play as the Creature, your aim is to hunt down the shipwrecked survivors and assimilate them into the planet’s ecosystem.
** By playing your Hunt cards and activating the powers of Artemia, you repeatedly attack the Hunted to wear down their will and inescapably bind them to the planet.

== Place cards ==

* The planet Artemia is made up of 10 different Place cards.
* Each Place card has a number, a name and a power that can be activated by the Hunted.
* '''The place cards are horizontally or vertically adjacent.'''
* Each Hunted begins the game with the 5 basic Place cards (Lair, Jungle, River, Beach and Rover) and may explore new places during the game (Swamp, Shelter, Wreck, Source and Artefact).

== Hunt cards ==

* Hunt cards increase the chances of the Creature being able to assimilate the Hunted.
* Each Hunt card shows a power that can be activated by the Creature and the phase in which that power may be played.
* Some also show a Target or Artemia symbol.
* Hunt Cards may be played at any time during the phase shown on the card and are discarded after use.
** '''The Creature may only play one Hunt card per turn''' unless specified otherwise.
* If a Hunt card with the Target symbol is played, '''the Creature assigns its effects by placing the Target token on one of the 10 Place cards''' that form the planet.
** If the Creature plays 2 Hunt cards with this symbol during a turn, apply both effects to the targeted place.
* If a Hunt card with the Artemia symbol is played, '''the Creature assigns its effects by placing the Artemia token on one of the 10 Place cards''' that form the planet.
** If the Creature plays 2 Hunt cards with this symbol during a turn, apply both effects.

== Survival cards ==

* Survival cards increase the chances of the Hunted resisting the Creature’s attacks until the arrival of the Rescue mission.
* Each Survival card shows a power that can be activated by the Hunted and the phase in which that power may be played.
* Survival cards may be played at any time during the phase shown on the card and are discarded after use.
* '''Each Hunted may only play one Survival card per turn''' even if caught by the Creature.
* There is no limit to the number of Survival cards that a Hunted may hold.
* '''Hunt and Survival cards used during the same phase take effect in the order in which they are played.'''
* '''The effects of Hunt and Survival cards are limited to the current game turn''' and they may change the general rules.

== Playing the game ==

* Each turn takes place over 4 phases:

=== Phase 1: Exploration ===

* '''The Hunted simultaneously play one Place card''' each from their hand by placing it face down in front of them.
* They may communicate, but only aloud. Players may bluff, but they may not reveal their cards to each other.
* '''Playing a Place card is mandatory.'''
* Before playing a Place card, a Hunted may choose to do the following:
*# '''Resist''': the player forfeits 1 or 2 Will counters to take back 2 or 4 Place cards of their choice, respectively, from their discard pile.
*#* If in doing so a Hunted loses their third Will counter, they must '''Give Up'''.
*# '''Give Up''': the player regains all of their Will counters and takes back all of their discarded Place cards.
*#* Giving up, however, lets the Creature assimilate the Hunted faster.
*#* '''Each time a Hunted gives up during this phase, immediately move forward the Assimilation counter by one space.'''

=== Phase 2: Hunting ===

* The Creature places tokens to try to catch the players.
** If the token matches the location of a player the effect is applied.
** In the first round the players can only be in locations 1 through 5.
** They can only gain the additional locations by visiting the Rover.
* The Creature may place the following tokens on the Place cards that make up Artemia:
** The Creature token.
** The Target token if the target symbol is on a Hunt card played.
** The Artemia token if the Artemia Symbol is on a Hunt card played '''AND/OR''' on the space under the Rescue counter.
* '''The Hunt tokens can be placed on the same place to stack their effects.'''

=== Phase 3: Reckoning ===

* '''The Hunted simultaneously reveal their Place card.'''
* The phase should then proceed as follows:
*# Starting with the player to the left of the Creature, each Hunted who explores a place without a Hunt token may immediately '''use the place’s power''' OR '''take back 1 Place card of their choice from their discard pile'''.
*#* If a place’s power is ineffective as a result of a Hunt card, the Hunted may not take back a discarded Place card.
*# Each Hunted who explores the place where the Target token is located is subject to the '''effect of the Hunt card'''.
*#* They may then '''use the power on the Place card''' OR '''take back 1 Place card of their choice from their discard pile'''.
*#* If a place’s power is ineffective as a result of a Hunt card, the Hunted may not take back a discarded Place card.
*# Each Hunted who explores the place where the Artemia token is located '''discards 1 Place card from their hand'''.
*#* The '''place’s power may not be used''' and the Hunted may not take back a discarded Place card.
*# Each Hunted who explores the place where the Creature token is located '''loses 1 Will counter'''.
*#* '''Immediately move the Assimilation counter forward 1 space regardless of the number of Hunted caught.'''
*#* The place’s power may not be used and the Hunted may not take back a discarded Place card.
* '''During this phase, if at least one of the Hunted loses their third Will counter, move the Assimilation counter forward by 1 space.'''
** Then these Hunted take back all of their Place cards, as well as their 3 Will counters.

=== Phase 4: End-of-turn actions ===

# '''Each Hunted''' discards the Place card played, face up.
#* The Creature must always be able to see the figures on all discarded Place cards.
#* '''The Creature''' takes back its Hunt tokens and draws Hunt cards up to a hand of 3.
# '''Move the Rescue counter forward 1 space''' and begin again at Phase 1: Exploration.

== End of game ==

* '''The Creature wins''' immediately if the Assimilation counter reaches the Victory space first.
** With their will sapped, all of the Hunted have been assimilated. They are now part of the planet.
* '''The Hunted win''' immediately if the Rescue counter reaches the Victory space first.
** A rescue mission arrives to extract the survivors from this hostile planet.

== FAQ ==

=== The Lair ===

* If a Hunted chooses to retrieve their discarded Place cards, they do not retrieve the Lair because during the Reckoning phase, the Lair is not yet in the player’s discarded cards.
* If a Hunted caught on The Lair only has 1 Will counter, this Hunted loses only one Will counter.

=== The Beach ===

* Use of the Beach is limited to once per turn regardless of the number of Hunted exploring the Beach, either:
** Charge the Marker, or
*** ''Place the Marker token on the Beach''
** Activate the Marker
*** ''Remove the Marker token from the Beach and move the Rescue counter forward by 1 space.''
* If two or more Hunted explore the Beach, one of them may use the power of the Beach and the others may take back 1 Place card of their choice from their discard pile.
* The power of the Beach may stack with that of the Wreck.

=== The Wreck ===

* Use of the Wreck is limited to once per turn regardless of the number of Hunted exploring the Wreck.
* If two or more Hunted explore the Wreck, one of them may use the power of the Wreck and the others may take back 1 Place card of their choice from their discard pile.
* The power of the Wreck may stack with that of the Beach.

=== The Artefact ===

* The 2 Place cards played are resolved one by one in the order of the player’s choice, following the rules of Phase 3: Reckoning.
* The power of the Artefact may not be copied by a place’s power, nor by a Survival card.
* If you get caught twice by the same Hunt token, the personal effects of the token are applied twice.

=== Drone ===

* This Survival card can only be used if the power of you place card could be used.
* On Board Game Arena, you may only play this card when it is your turn to resolve the power of your place card during Phase 3.

=== Gate ===

* This Survival card can only be used if the power of you place card could be used.
* On Board Game Arena, you may only play this card when it is your turn to resolve the power of your place card during Phase 3.

=== Double Back ===

* If you played 2 Place cards using the Artefact, you may only take back one of them.

=== Wrong Track ===

* If the "Clone" Hunt card was played this turn, you may move either the Creature token or the Target token with represents the Clone.

=== Despair ===

* When this Hunt card is played, all Hunted players who already played a Place card automatically take it back in their hand, and then play again any Place card.

=== Dodge ===

* This cards effect only applies to the Hunted who plays it.
* Therefore you must be on the same location than the Creature to play it, and it will not prevent the other Hunted to get caught.

=== Detector ===

* This cards effect only applies to the Hunted who plays it.
* Therefore you must be on the same location than the Artemia token to play it, and it will not prevent the other Hunted to get caught.

Bugsclarification daybreak

2025-07-23T23:54:02Z

Kayvon: Created page with "Please note IF THE GAME DID NOT END when you expected it to, you MUST check that you have achieved all of your challenge cards. You'll know you have a challenge card because you CHOSE one when the game started. You'll know which one it is because it's on the game panel. And you'll know that it stopped you from winning because the GAME LOG specifically mentions that the challenge card prevented your victory."

Please note IF THE GAME DID NOT END when you expected it to, you MUST check that you have achieved all of your challenge cards.
You'll know you have a challenge card because you CHOSE one when the game started.
You'll know which one it is because it's on the game panel.
And you'll know that it stopped you from winning because the GAME LOG specifically mentions that the challenge card prevented your victory.

Gamehelpparks

2025-03-09T02:45:55Z

Kayvon: /* FAQ */

== Overview ==
Players take on the roles of two Hikers as they trek across different Trails during the four Seasons (rounds) of a Year. Each Trail represents a different Season, and as each Season passes, the Trails change and grow steadily longer. Each turn, players send one of their Hikers down the Trail. While on the Trail, Hikers will see beautiful Sites and perform an action when they arrive. When a Hiker reaches the end of the Trail, they can spend tokens they have received to visit Parks and earn points. Your goal is to have the most points from your Parks, Photos, and Personal Bonus at the end of the Year.

== Starting a Season ==
All of the Sites (spaces) in the current trail [or all the Basic Sites at the start of the game] are mixed together with a random additional Advanced Site. They are laid out with the Trailhead on one side, and the Trail End on the other, making this Season's Trail. Both Hikers for each player start the Season on the Trailhead. A Season card is drawn, which will have either an immediate effect, or an ongoing effect that applies to the entire Season. The bottom of the Season card also shows a "Weather Pattern"; the tokens shown in this pattern are placed on the Trail Sites, starting with the 2nd site. (Note that the Trailhead and Trail End spaces are not Sites). The player with {{ParksFirstHiker}} will take the first turn of the Season, with players taking turns in clockwise order.

* If this is the start of the game, the player to the right of the First Hiker receives the {{ParksCamera}}, and all players draw a Canteen.

== Taking turns ==
On a turn, a player selects either one of their Hikers and moves them down the Trail -- any space to the right of that Hiker’s current location.

* If any Hiker, even your own, is on a Site, you may not move onto that Site, unless you extinguish your Campfire. If your Campfire is already extinguished, you may not move to occupied Sites.

* If the Hiker is the first to land on a Site with a token on it (from the Weather Pattern), the player takes the token into their supply.
* The player then takes the action of the Site their Hiker moved to. Hikers cannot be moved to Sites where the player cannot take the action.
* If you gain {{ParksWater}} on your turn, you can place it in an empty Canteen that you have (and only when gaining {{ParksWater}}), to gain the benefit shown on the Canteen card.
* {{ParksWildlife}} are "wild" and can be used in place of another token, except they may not be used to fill Canteens, or as part of exchange abilities (as noted on those cards).
* If you have more than 12 tokens at the end of your turn, you must discard down to 12. The tokens are component limited.

== Trail End ==
When you move a Hiker to the Trail End, you relight your Campfire if it is extinguished, and then choose one of the three areas to place your Hiker: (any number of Hikers can be on each area)

=== Reserve a Park ===

* Take a face-up Park or a Park from the top of the deck; it is placed horizontally in your player area. If you took a face-up Park, the empty slot is refilled from the deck
* You don't pay resources or score points now, but you may later Visit that Park [and no one else can].
* The first player who uses this space each season takes {{ParksFirstHiker}}.

=== Buy Gear ===

* You may buy one of the face-up Gear cards on the board by paying {{ParksSunshine}} equal to its cost [in the upper right of the card].
* The first player [and also the second player in a 4-5 player game] to use this space can buy Gear for one fewer {{ParksSunshine}}.
* Gear gives ongoing abilities for the rest of the game, and some also have an instant action, denoted by a lightning bolt.

=== Visit a Park ===

* Pay the cost shown on any face-up Park, or one you have reserved, to gain the indicated number of points, and the card is placed vertically in your player area, refilling the board if necessary.

== End of a Season ==
Once a player’s two Hikers reach the Trail End, they will no longer take turns for the Season. When only one Hiker is left on the Trail, the player must move the Hiker to the Trail End on their next turn and choose an action there. Then, it is the end of the Season.

At the end of a Season:
*- The player with the {{ParksCamera}} may pay 1 token to take a Photo.
*- All Canteens are emptied, and their {{ParksWater}} are returned to the supply.
*- If this was the fourth Season, the game is over. Otherwise, Start the next Season (see above).

At the end of the game:
*- All players reveal their Year cards and score points based on their Personal Bonus.
*- The player with {{ParksFirstHiker}} gains 1 additional point.

The player with the most points at the end is the winner! If tied, the win goes to the player who visited the most Parks. If still tied, the win is shared.

== Basic Sites ==
'''Forest''': Gain {{ParksForest|1}}.

'''Mountain''': Gain {{ParksMountain|1}}.

'''Ocean''': Gain {{ParksWater|2}}.

'''Valley''': Gain {{ParksSunshine|2}}.

'''Vista''': Either:

* - Draw a Canteen (you can have any number of Canteens, so long as there are any left in the deck) OR
* - Spend any 2 tokens to take a Photo, and then take the {{ParksCamera}} from whoever currently has it. (Photos are worth 1 point each. When you have the {{ParksCamera}}, when any ability lets you spend 2 tokens to take a Photo, you only spend 1 instead.)

'''Waterfall''': Gain {{ParksSunshine|1}} and {{ParksWater|1}}.[4-5 player games only]

== Advanced Sites ==
'''Lodge''': Turn in one token and gain any one token ''(excluding {{ParksWildlife}})''. You may do this a second time.

'''Lookout''': Reserve or Visit a Park OR Buy a Gear card.

'''Wildlife''': Turn in any one token to gain {{ParksWildlife|1}}.

'''River''': Turn in {{ParksWater|1}} to copy the action from another Site currently occupied by any Hiker. (Gear that would allow you special actions on the copied space do not activate, as you are not actually on that space)

== Notable Game Components ==

*- 48 Park cards
*- 36 Gear cards
*- 15 Canteen cards
*- 28 Photos
*- {{ParksForest|16}}
*- {{ParksMountain|16}}
*- {{ParksSunshine|30}}
*- {{ParksWater|30}}
*- {{ParksWildlife|12}}

== FAQ ==
=== Error Messages ===

==== Why isn't my campfire lit in the first season? ====
Your campfire does not start the game lit with certain player counts.

Bugsclarification gaiaproject

2024-07-29T16:33:46Z

Kayvon: Created page with " '''== GENERAL''' '''GEN1:''' On iOS/Mac, the game is unresponsive. The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using. '''GEN2:''' Will you add an undo button? We understand this is a popular request, but we have no plans to do so at the moment. See discussion at boardgamearena.com/bug?id=5..."

'''== GENERAL'''

'''GEN1:''' On iOS/Mac, the game is unresponsive.

The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

'''GEN2:''' Will you add an undo button?

We understand this is a popular request, but we have no plans to do so at the moment. See discussion at boardgamearena.com/bug?id=50676.

If we were to add an undo button, it would not allow you to undo anything other than resource conversion.

'''GEN3:''' The booster tile is covering the conversions pane!

Check the preferences for other options for the booster tile.

'''== CONVERSIONS/POWER'''

'''CONV1:''' Why do I only get one credit when I convert the Brainstone to credits?

If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

'''CONV2:''' Why don't I get a chance to convert resources at the end of my turn?

'''CONV3:''' I should get the option to charge before or after gaining power!

There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

'''CONV4:''' I have enough power to perform a power action, but it doesn't show up as available!

There are two possible reasons:

- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.

- Someone else has taken that action this round.

'''== TECHNOLOGY / RESEARCH'''

'''TECH1:''' I advanced to the top of a track and didn't get the advanced tech for that track!

That is not how you gain an advanced tech. Check out the "how to play" section.

'''TECH2:''' The game isn't allowing me to gain an advanced tech!

'''TECH3:''' The game isn't allowing me to advance to level 5 in a research track!

Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

'''== FEDERATIONS / BUILDING'''

'''BLDG1:''' I can't form a federation!

The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details. If you've read that and are still convinced there's a problem, open a bug report.

'''Xenos:''' note that 7 power is required if you have not built your PI.

'''Bescods:''' note that power is only increased on titanium planets, and only after you have built your PI.

'''Ivits:''' See RACE4 below.

'''BLDG2:''' The game isn't allowing me to upgrade!

This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

'''BLDG3:''' Why wasn't my federation bug report accepted?

To diagnose federation forming problems, we the move number of the action andd a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

'''BLDG4:''' I provided a screenshot and move number, but my bug report was marked "notabug"!

Federation building rules are complicated and nuanced. We've received a large number of false reports due to rules misunderstandings. Please consult the rulebook and this '''FAQ:'''

boardgamegeek.com/wiki/page/Federation_FAQ

'''== FACTION-SPECIFIC'''

'''RACE1:''' As Hadsch Hallas, how do I use my PI ability?

Once you've built your PI, the new conversion options will be available under the Convert menu.

'''RACE2:''' My faction's ability isn't working!

Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

'''RACE3:''' As Nevlas, what happens to the remaining half a power when I convert?

Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

'''RACE4:''' How do I form a second federation as Ivits?

Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Bugsclarification maracaibo

2024-07-29T16:31:08Z

Kayvon: Created page with " '''== GENERAL''' '''GEN1:''' Why can't I buy this card? I have enough gold! Make sure you can afford the *entire* card. Do you have enough figures (meeples) to play it? '''GEN2:''' Where did my synergy token go? Why is the wrong synergy token showing in my player panel? Synergy tokens are faded out before you own than and bright & colorful once you collect them. The number does not indicate that you own the token; it indicates that you have a synergy with the token...."

'''== GENERAL'''

'''GEN1:''' Why can't I buy this card? I have enough gold!

Make sure you can afford the *entire* card. Do you have enough figures (meeples) to play it?

'''GEN2:''' Where did my synergy token go? Why is the wrong synergy token showing in my player panel?

Synergy tokens are faded out before you own than and bright & colorful once you collect them. The number does not indicate that you own the token; it indicates that you have a synergy with the token. Remember that you can never have more than one of a token.

'''GEN3:''' On mobile, the game renders slowly or feels like the interface lags.

Try turning off shadows in the user preferences. This is especially true for iOS (Apple) devices, which render drop shadows poorly.

'''GEN4:''' Why isn't my Master Builder discount working? The card costs 5 and I have 4 doubloons!

A card's price displayed in GREEN indicates its discounted price. The game has already applied the discount, so you can't gain an additional discount.

'''== UPGRADES'''

'''UPG1:''' Why don't I get the benefit after I perform an upgrade?

Make sure you've completed the *entire* upgrade. Both discs must be removed before the upgrade is active, not just the first disc.

'''== SOLO'''

'''SOL1:''' Why is my score -1 after I lose to Jean?

The BGA framework counts all positive scores as a win, so anytime you lose to Jean your score is changed to a negative value. This tells BGA that although you're the highest-scoring (and only) player in the game, you did not win.

Bugsclarification minirogue

2024-07-29T16:28:44Z

Kayvon: Created page with " '''=== GENERAL''' '''GEN1:''' Why did I suddenly change levels? Were you fighting a monster that caused you to fall? You'll notice the fall icon and the message in the log. It causes you to move multiple floors (a complete level!) all at once. '''GEN2:''' Why didn't I gain the full amount of gold? Why am I being forced to discard a potion? As shown in the player panel, there is a maximum limit on most resources. You can't have more than 10 gold. You can't have more..."

'''=== GENERAL'''

'''GEN1:''' Why did I suddenly change levels?

Were you fighting a monster that caused you to fall? You'll notice the fall icon and the message in the log. It causes you to move multiple floors (a complete level!) all at once.

'''GEN2:''' Why didn't I gain the full amount of gold? Why am I being forced to discard a potion?

As shown in the player panel, there is a maximum limit on most resources. You can't have more than 10 gold. You can't have more than one of the same potion.

'''GEN3:''' Why did we have to fight the Bandit twice in a multiplayer game?

Both players need to encounter all non-monster cards and the Bandit is not a monster. If a monster results from an encounter, both players will fight the monster together, but it doesn't end the encounter for the player who hasn't gone yet.

For example, the rules are explicit that both players encounter a trap. Whether the first player succeeds or fails, the second player will also encounter the same trap. Even if the first player rolls the dungeon die such that they fight a monster, the other player must still encounter the trap and may roll that same monster die again.

It works this way for all non-monster cards. The Bandit isn't a monster card; it's a different sort of encounter where a decision is made. You both made decisions that resulted in combats.

'''=== CHARACTER ABILITIES'''

'''CHAR1:''' Why can't I use my in-combat and explore ability each floor?

Because your character only gets one ability use per floor, no matter which one you use. You do not receive one of each, just one total.

'''CHAR2:''' Why didn't the Crusader's ability help my partner?

You and your partner must be in the same location for both to benefit. Like all cooperative games, good communication is key here. Ensure the ability is used before moving away or after both arrive in the space space.

'''=== ITEMS'''

'''ITEM1:''' Why didn't a blessing from a potion/ability cure me?

When you're holding the Cursed Relic, blessings from any source will not cure you. You need to dispose of the Cursed Relic first.

'''ITEM2:''' Why can't I pick up this item? Or offer food to the Crow?

Are you carrying the Cursed Relic? You're limited to a single item. You cannot pick up a new item until you figure out a way to discard the Relic.

'''=== DICE'''

'''DICE1:''' Why are the values being treated as different than what I rolled?

You're probably cursed. No, really. When cursed, all rolls are treated as being one lower than the value shown, so a 2 becomes a miss.

'''DICE2:''' The dice are rigged.

The dice are fine. Here's an analysis of HALF A MILLION dice rolls created by BGA

https://www.boardgamearena.com/forum/viewtopic.php?f=35&t=15811&p=59122&hilit=bga_rand#p59122

And here's and example of a bug report where a player actually had better-than-average rolls overall, but felt the dice were rigged when there were a few unfortunate rolls in a row.

https://boardgamearena.com/bug?id=127481

BGA Undo policy

2024-05-30T12:47:23Z

Kayvon: Restoring wording that shouldn't have been eliminated in revision 20996 by Victoria La (talk)

Introducing "Undo" features in games can lead to bugs and/or bad interface design.

Please read the following carefully before implementing an Undo feature for your game.

= What you must NEVER do =

When you are restoring a game situation A from a game situation B:

* The Undo action must '''never change the active player'''. In other words, if player X clicks on "Undo", it must NOT make player Y active.
* If several players did game actions between A and B, you must NEVER provide an undo. In other words, an "Undo" action must NEVER force another player to redo some moves.
* No hidden (or private) information must have been revealed between A and B.
* No random event with a visible effect must have been triggered between A and B. This includes cards shuffling, dice roll, elements picking, ...

= When to propose to Undo? =

As a rule of thumb, on BGA we advise you to not undo moves.

Undo are painful for opponents, in real world and online. Some players may also use Undo to "test" situations while they should just think instead.

In many cases, proposing an "Undo" means also adding an extra step, which is not good for the game interface.

Undo may be useful in 2 main situations:
* To allow players to take back a move following a "misclick" that may ruin their game.
* To allow players to take back a very complex series of actions.

== About Undo to avoid "misclick" ==

In most cases, you don't need this: players must pay attention :)

However, if several of the following cases correspond to your situation, you may consider adding an Undo for "misclicks":

* If the '''zone to click is very small''', or close to other zones, misclicks may happened frequently. Note that if this only happens on mobile, you can propose the Undo to mobile users only.
* If '''there is already another step''' after the step you want to undo. In this case, adding an "Undo" does not add an extra step.
* If you are in the middle of a real "game action". For example, on Chess, it is normal to allow to undo the selection of a piece in order to select another one, as the move hasn't been done already.
* The action done by the player is obviously a mistake (in this case, please also consider adding a confirmation before the action).

On the contrary, you must be reluctant to add an Undo if:
* This adds an extra step.
* The game action is clear and the zone to click is large.

To conclude: we may allow a player to undo a move caused by a "misclick", but we shouldn't allow a player to undo a bad move he plays consciously.

Note: not all of these situations require server undo, in chess example above Undo of selection - you don't need to send piece selection to the server you can store it locally (this is "client side undo"), there is no Undo button in this case - user just selects another piece. Similary if you add prompt for clicking on critical buttons like "Pass" you can add extra prompt, but no Undo

== About Undo to take back moves from a complex series of actions ==

Games with a complex serie of actions are an "exception" to BGA Undo policy.

In most games, you shouldn't provide an undo because players are not allowed to "explore" the different possibilities by playing and undoing their moves.

However, in some games, it is commonly admitted that players are allowed to take back a move. The typical example is a complex strategy game with a long serie of actions during your turn. "Through the Ages" or "Tzolk'in" are 2 good examples.

To know if this is a good idea to propose an undo, ask yourself the question: "when playing in real life, will my opponents authorize me to take back this move?". Depending on your answer, you should choose to provide an Undo, to not provide an Undo, or maybe to propose an Undo as an option for the game.

Note: in this situation it is also possible to use client side undo, instead of server side, see "Russian Railroads" for example (implemented using setClientState method).

= How to implement Undo =

There are 2 ways to implement Undo:
* The framework undoSavePoint/undoRestorepoint methods, [[Main_game_logic:_yourgamename.game.php#Undo_moves | documented here]].
* Your own method.

As a rule of thumb, it is way better to use your own method to provide an Undo. The reasons are:
* The framework method is quite heavy to use (it saves the WHOLE situation). To cancel a simple move, it is way more efficient for you to execute the opposite move.
* The framework method is doing a full "reset" of the game interface. It is way more smooth and clear to play the opposite move from a player point of view.
* The framework Undo provides only ONE save point. If you want to provide a complex Undo (i.e.: the possibility to undo all the previous steps one by one), you must implement it by yourself.

However, the framework is very handy to use (only 2 methods), so this should be your first choice if some moves are very difficult to reverse on client side.

== How does undoSavePoint/undoRestorepoint works? ==

The undoSavePoint method makes a full copy of the game database state.

The undoRestorePoint method:
* restores the game database
* removes all your game HTML + the player panels
* restores the game HTML + the player panels according to their state at the initial game loading
* calls your "setup" method

'''Important''': because undoRestorePoint is calling your "setup" method, you must ensure that your whole game state can be restored from there. In particular, all your member variables must be initialized inside the "setup" method (and not only in the constructor !).

== Adding simple Undo action to your game ==

=== Step 1: Declare in gameinfos ===
Add 'db_undo_support' => true in gamesinfo.inc.php

Note: if you have game in studio you must reload gameinfos and restart all these games

=== Step 2: Insert savepoint ===
Determine where you want to save the undo state. Must be single active player state
* Begging of new user turn
* Every time new information revealed such as
** dice roll
** card is drawn
** anything else hidden is shown

Insert
$this->undoSavepoint();

=== Step 3: Create undo action in server ===
Add players undo action
in game.action.php:
public function undo() {
self::setAjaxMode();
$this->game->action_undo();
self::ajaxResponse();
}
in game.game.php
function action_undo() {
$this->undoRestorePoint(); // do not do checkAction - its on purpose - do not need to add undo as possible action to every state
}

=== Step 4: Create undo action in client ===
in game.js
add this to onUpdateActionButton regardless of state but inside isCurrenPlayerAction
<pre>
this.addActionButton('button_undo', _('Undo'), 'onUndo', undefined, undefined, 'red');
</pre>

and onUndo would be like this
<pre>
onUndo: function (event) {
const action = "undo";
this.ajaxcall(
"/" + this.game_name + "/" + this.game_name + "/" + action + ".html",
[],
this,
(result) => {},
(err) => {
if (err) return;
this.setMainTitle(_("Undo requested..."));
dojo.empty("generalactions");
},
true
);
},
</pre>

=== Step 5: Make it fancy ===
If you want you can add extra styling to the Undo button such as it will appeat at right of all buttons
in game.css
<pre>
#button_undo {
float: right;
background-color: red;
background-image: none;
}
</pre>

[[Category:Studio]]

Gamehelpgaiaproject

2024-02-24T16:13:19Z

Kayvon: To avoid confusion, revert plural third-person pronouns in favor of traditional proper English syntax.

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Actions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
[[Image:Gaia_Project_Free_Actions.JPG]]
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits the maximum amount he is willing to bid for each faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction. During the round-robin portion, each player automatically bids '''on the faction with the greatest difference between the faction's current bid and that player's maximum possible bid.'''

A typical '''automatic''' auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction they wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

'''Here is a game log auction example for a 3 player game:'''

In summary:

PLAYER_A wins IVITS for 11, their maximum bid was 27 for IVITS,

PLAYER_B wins AMBAS for 6, their maximum bid was 10 for IVITS, 8 for AMBAS.

PLAYER_C wins TERRANS for 0, their maximum bid was16 for IVITS, 12 for AMBAS, 6 for TERRANS.

some notable example lines from the log are:

''**PLAYER_B switches from [IVITS] to [AMBAS] when the bid reaches 3 on IVITS, because 9>7 : AMBAS:8--1= '''9''' > IVITS:10-3='''7'''.''

<code>explanation: AMBAS: 8(PlayerB max bid for Ambas) - -1(current bid for Ambas) = 9 > IVITS: 10(PlayerB max bid for Ivits) - 3 (current bid for Ivits) =11</code>

''++PLAYER_C switches from [IVITS] to [AMBAS] when the bid reaches 5 on IVITS, because 12>11 : AMBAS:12-0='''12''' > IVITS:16-5='''11'''.''

<code>explanation: AMBAS: 12(PlayerC max bid for Ambas) - 0(current bid for Ambas) = 12 > IVITS: 16(PlayerC max bid for Ivits) - 5 (current bid for Ivits) =11</code>

Actual Log:

Players will automatically bid on the faction with the greatest gap between its current bid and the player's maximum bid

PLAYER_A bids 0 on [IVITS] (and is willing to bid up to 27 if needed)

PLAYER_B bids 1 on [IVITS], outbidding PLAYER_A. (The bid was 10 away from PLAYER_B's max bid of 10.)

PLAYER_C bids 2 on [IVITS], outbidding PLAYER_B. (The bid was 15 away from PLAYER_C's max bid of 16.)

PLAYER_A bids 3 on [IVITS], outbidding PLAYER_C. (The bid was 25 away from PLAYER_A's max bid of 27.)

<nowiki>**</nowiki>PLAYER_B bids 0 on [AMBAS] (and is willing to bid up to 8 if needed)

PLAYER_C bids 4 on [IVITS], outbidding PLAYER_A. (The bid was 13 away from PLAYER_C's max bid of 16.)

PLAYER_A bids 5 on [IVITS], outbidding PLAYER_C. (The bid was 23 away from PLAYER_A's max bid of 27.)

++PLAYER_C bids 1 on [AMBAS], outbidding PLAYER_B. (The bid was 12 away from PLAYER_C's max bid of 12.)

PLAYER_B bids 2 on [AMBAS], outbidding PLAYER_C. (The bid was 7 away from PLAYER_B's max bid of 8.)

PLAYER_C bids 6 on [IVITS], outbidding PLAYER_A. (The bid was 11 away from PLAYER_C's max bid of 16.)

PLAYER_A bids 7 on [IVITS], outbidding PLAYER_C. (The bid was 21 away from PLAYER_A's max bid of 27.)

PLAYER_C bids 3 on [AMBAS], outbidding PLAYER_B. (The bid was 10 away from PLAYER_C's max bid of 12.)

PLAYER_B bids 4 on [AMBAS], outbidding PLAYER_C. (The bid was 5 away from PLAYER_B's max bid of 8.)

PLAYER_C bids 8 on [IVITS], outbidding PLAYER_A. (The bid was 9 away from PLAYER_C's max bid of 16.)

PLAYER_A bids 9 on [IVITS], outbidding PLAYER_C. (The bid was 19 away from PLAYER_A's max bid of 27.)

PLAYER_C bids 5 on [AMBAS], outbidding PLAYER_B. (The bid was 8 away from PLAYER_C's max bid of 12.)

PLAYER_B bids 6 on [AMBAS], outbidding PLAYER_C. (The bid was 3 away from PLAYER_B's max bid of 8.)

PLAYER_C bids 10 on [IVITS], outbidding PLAYER_A. (The bid was 7 away from PLAYER_C's max bid of 16.)

PLAYER_A bids 11 on [IVITS], outbidding PLAYER_C. (The bid was 17 away from PLAYER_A's max bid of 27.)

PLAYER_C bids 0 on [TERRANS] (and is willing to bid up to 6 if needed)

PLAYER_A wins the auction for [IVITS], spending [VP11]

PLAYER_C wins the auction for [TERRANS], spending [VP0]

PLAYER_B wins the auction for [AMBAS], spending [VP6]

All players receive [VP11] to ensure every player starts with at least 10 VP

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelparcticscavengers

2024-02-24T16:06:14Z

Kayvon: Bullet point formatting

==Objective==

The player with the largest tribe (most people) at the end of the game is the winner.

==Setup==

Each player starts with:
*4 refugee cards
*3 scavenger cards
*1 brawler card
*1 spear card
*1 shovel card

==Playing the Game==

Each round of Arctic Scavengers has three phases, played in the order shown below:

'''Drawing Phase'''
*1) Discard all cards from the previous round.
*2) Each player draws 5 cards from the top of their deck, shuffling the discard pile and adding it to the deck when their deck becomes exhausted.
*3) Beginning with the third round, and continuing for the remainder of the game, the initiator peeks at the top card on the contested resources pile and then returns it to the pile.
'''Resource Gathering Phase'''
*4) The initiator takes the first action and uses any number of cards to gather resources.
*5) The initiator announces how many of their cards will remain for the skirmish.
*6) Play continues with the other players, in clockwise order, and they execute steps 4 and 5.
'''Skirmish Phase (Round 3 and following)'''
*7) Once all players have taken their resource gathering actions, players reveal their remaining cards for the skirmish and a winner is determined.
*8) The winner of the skirmish takes the top card from the contested resources pile and adds it to their discard pile.
*9) The initiator passes the initiator card to their left-hand opponent, starting a new round.

The game continues like this until the contested resource pile is depleted.

==Resource Gathering==

During this phase, each player plays any number of cards from their hand in order to add more resources (cards) to their deck. Gathering starts with the player that has the initiator card (lying in their play area) and play continues in clockwise order.
There is no limit to the number of actions that a player can take during the resource gathering phase, although no action may be taken more than once.

'''Dig'''

The player draws one or more cards from the top of the junkyard pile. The player may choose one to place in their discard pile and returns any other cards to the bottom of the junkyard pile. The number of cards is determined by the sum of all the dig numbers displayed on the card(s) played from the player’s hand. As with other actions, dig may only be used once per round.

'''Draw'''

The player draws one or more cards from their deck, adding them to their hand. Multiple cards may be combined to draw several cards. As with other actions, draw may only be used once per round.

'''Hire'''

The hire ability is a free action (no card is needed to grant this action) in which a player takes a mercenary card from the face-up piles of cards. The player must be able to pay the cost displayed on the card. There are two currencies: food and medicine. Food is created in real-time using the hunt action (described below). Meds are provided in the form of medicine cards that must be played from the players hand in order to complete the hiring of a
mercenary. Medicine cards do not require an associated person to spend. Each player may only hire one mercenary per round, and the player immediately adds the card to their discard pile.

'''Hunt'''

The hunt ability generates food during the round that can then be used as currency for hiring a single mercenary card. The amount of food generated is determined by summing all hunt abilities played from the player’s hand. The player can assign tools to the mercenaries to improve their hunt abilities.

'''Trash'''

The trash ability is a free action (no card is needed to grant this action) that allows a player to take any number of cards from their hand and add them to the junkyard supply pile. The player does not draw cards from their deck to replace these cards. The junkyard pile is shuffled any time new cards are added.

'''Special Actions'''

Some cards may grant special actions that can be used in place of or to enhance a standard action. Examples include saboteur (disarm another player’s tool) and sniper team (snipe another player’s tribe member).

'''Using Tools'''

Each player starts with two tools – a spear and a shovel. Players can find additional tools by digging in the junkyard. Tools cannot perform actions on their own (these are inanimate, objects after all). A tribe member can use a single tool that enhances the ability of the action the tribe member is performing. Using a tool does not grant a tribe member an ability that they cannot inherently perform.

==Skirmish==

The game begins with two rounds of resource gathering (digging in the junkyard, hunting for food, and hiring mercenaries). In the first two rounds, there is no skirmishing. This allows each player to get a solid foundation prior to skirmishing over the contested resources. The initiator card remains with the first player for rounds 1-3. Thereafter, it moves to the initiator’s left at the start of each subsequent round.

Once all the players have completed their resource gathering actions, the skirmish phase begins. All players simultaneously reveal the cards that they have saved for the skirmish. The sum of the fight values from all of a player’s cards represents the strength of that player’s attack. All rules related to tool usage also apply to tools used as weapons during the skirmish phase (see ‘Using Tools’ above).
Skirmishes are resolved by starting with the initiator and having their declare any actions performed by their units (including saboteurs and sniper teams). Play then passes to the next player in clockwise order to declare actions for their units (provided that they were not sniped or disarmed by the previous player). This continues until all skirmish actions have been resolved. Then the total remaining fight values are summed and the player with the highest fight value wins. The winning player draws the top card from the contested resources supply pile and adds it to their discard pile without revealing it to the other players. When cards are played during the Resource Gathering phase, they are discarded after use. During the Skirmish Phase, all cards remain until the end of the round, even if a special power is activated (e.g. saboteur or sniper team).

'''Resolving ties'''

In the event of a tie, each player sums the number of people involved in the skirmish (this includes refugees and tribe families that may not be directly contributing to the fight score) and the player with the most people involved wins the skirmish. If players are still tied, then the skirmish is considered a deadlock. In this case, the players place the top card from the contested resources pile into the junkyard pile without looking at it. The players shuffle the junkyard and the round ends. The player with the initiator card passes it to the left to begin a new round.

==2 Player Variant==

*Remove two cards of each kind from the junkyard (i.e. 2 junk, 2 medkit, 2 pickaxe, etc.)
*Eliminate all contested resources peeking
*The number of tribe members a player brings to a skirmish is no longer relevant
*Skirmishes must be won by 2. If not, then it is a tie and the players place the contested resource on top of the junkyard and then shuffle the junkyard

==HQ expansion==

====Module #1 – Medics, Tools, and Gangs====

Adds
*8 Medic mercenaries (can draw, hire for 1 med (like pills) or stop a sniper attack)
*8 Junkyard cards (4 Rifle for +2 hunting and fighting, 4 Toolkit)
*2 Gangs - go to relevant player at the end of the game. Worth 5 people.

The Gearheads gang go to the player with the most cards with the tool icon. Ties broken by most tools that are contested resources.

The Pharmers gang go to the player with the highest total med value from pills and medkits. Ties are broken by most Medics.

====Module #2 – Engineers and Buildings====

Adds
*8 Engineer mercenaries
*12 buildings (3 each of bunkers, armories, pharmacies, hydroponic gardens)
*1 Gang, The Masons - goes to the player with the most completed and enabled buildings cards at the end of the game. Ties are broken by most Engineers. Worth 5 people.

Engineers can dig in the engineering schematics pile (12 building cards as above). The process of constructing a building is as follows:
#Play an engineer card
#Use the engineer’s dig (combined with any modifiers) to draw cards from the engineering schematics pile equal to the dig value
#Select a maximum of 1 card to build and return the others to the bottom of the engineering schematics pile
#Place the new building card face-up in your play area
#Draw cards from the player’s deck equal to the building’s build time and place those facedown on top of the new building
#Discard the engineer card
#At the start of the player’s next round, remove 1 card from each building that is under construction
#Starting with the round following the initial building placement, additional tribe members (and toolkits) may be played from the player’s hand to accelerate construction on one or more buildings. Each tribe member played can remove 1 card from a building that is under construction. If wielding a toolkit, then 2 additional cards may be removed. Tribe members that work on construction projects may not take any other actions that round and are immediately discarded.
#Once a building has zero cards stacked on it, it is complete and immediately goes into effect.

====Module #3 – Tribal Leaders====

Adds 10 Tribal Leaders, each with a unique power.

Each player selects one of two leaders at the start of the game.

====Module #4 – Dirty Deeds====

'''New Saboteur Ability''': A saboteur may attack a building that is completed and disable it, rendering it unusable (flip the building’s card over to reveal its back, indicating that the building is disabled). If a building is disabled, its abilities cannot be used and cards cannot be added or removed from the building. To repair the building, a tribe member card must be played from the player’s hand to work on the building and then immediately discarded.

'''New Sniper Ability''': A sniper team may attack a tribal leader, wounding him (turn the leader’s card over to indicate the tribal leader is injured). This removes the leader’s advantage until a med is applied to the leader to heal him.

== Recon expansion ==

====Module 1 – Spy Hunter====

Adds
*4 binoculars to junkyard
*8(?) Spies to the mercenaries

'''Recon Action''' - Enables you to peek at cards and gain essential information. Recon rules:
*Only you may see cards as a result of your recon action. You may not share this information with any other player.
*Cards are returned in their original order.
*It may be possible for your recon action to be interrupted through a cancel action or as a result of a snipe attack.

====Module 2 – Liars and Thieves====

Adds assassin, provocateur, rogue, and guard mercenaries (select 6 other mercenaries for a total of 10 in the market)

'''Assassin''': Like the sniper team, this mercenary has the ability to snipe an opponent’s tribe members during resource gathering or the skirmish. Unlike the sniper team, the assassin is restricted to only attacking single-unit tribe members (cards that represent only 1 tribe member).

'''Provocateur''': Grants a special means of fighting through intimidation. During your turn of the skirmish resolution phase, you may announce an intent to use the number of tribe members you brought to the skirmish as your fight score. Count the total size of your force (tribe members you brought, even if they are not fighters) ignoring any tools or other combat modifiers, but including leader and building abilities that increase the size of your force. Use the total force size as your fight score. If your provocateur gets sniped, your fight score reverts back to its natural score. The Gangster leader ability does not count toward the provocateur ability. A player in later turn order can snipe a provocateur in earlier turn order.

'''Rogue''': Grants a special skirmish win condition. If a skirmish ends with a tie for highest fight score, the first player in turn order with a rogue in the skirmish automatically wins the contested resource. Only a tie for highest fight score is considered, not the number of tribe members. The rogue ability constitutes a higher order of precedence than the number of tribe members brought to the skirmish. It is not necessary that the player using the rogue be involved in the tie. Any two players with identical fight scores trigger the potential for a rogue win condition for ANY player in the skirmish. At this point, the number of tribe members in the skirmish is not relevant. The rogue’s ability to steal the CR is passive. You do not need to give up the rogue’s fight in order to steal the CR. Your rogue can be targeted by a snipe action. Only the first rogue action can be successful per round (resolved in turn order). Multiple players cannot successfully use this action. A player in lower turn order can snipe a rogue in higher turn order.

'''Guard''': An inexpensive fighter, similar to a brawler. Can be used to cancel any action outside of the skirmish which targets your card(s). Examples include spying, sniping or disarming while you gather resources, attacks against your buildings, and etc. If you do use the guard for his cancel ability, discard him and draw a new card from the top of your deck.

====Module 3 – Expanding the Ranks====

Adds courier, drill sergeant, scrappers, and tinker (select 6 other mercenaries for a total of 10 in the market)

====Module 4 – Randomized Contested Resources====

Adds 14 contested resources (cargo sled, combat medic, demolition team, tear gas, tribal hunters)

The new contested resources are shuffled with the 14 base game contested resources and 14 are drawn for this game.

====Module 5 – The Kitchen Sink====

Adds
*Humanitarians gang
*Map
*2 Leaders (Swindler and Yardmaster)

==FAQ==

===GENERAL===
GEN1: Why was the skirmish considered a tie in my two-player game? I should have won!

When playing with only two players, you must win the skirmish by at least two strength, otherwise it is considered a tie. There is no population tiebreaker in two player games.

Gamehelpmaracaibo

2024-02-24T15:46:40Z

Kayvon: Added Gen4

Welcome to Maracaibo! You'll play as an independent seafarer in the Caribbean seeking wealth and fame through combat, exploration, and strategic card play.

Maracaibo is played over 4 rounds. Each round, you and your opponents will sail along a loop around the Caribbean, stopping at cities and villages to take actions. You can stop at as many spaces as you want during a round, but watch out! After any player reaches the end of the loop, the round will end and all players will move back to the start.

----

== What To Do On Your Turn ==
On your turn, you will go through these phases in this order:

=== Phase A - Sailing ===
On your turn, you must move 1 to 7 spaces forward in the loop. You may choose to follow either the upper or lower path at a fork.

=== Phase B - Perform Actions ===
You will perform a Main Action at the space you landed on. Each space is either a City or a Village, and this will determine what Main Actions you have available to you. You may also perform any Free Actions. This phase will be the bulk of your turn and is detailed in the next sections.

=== Phase C - Draw New Cards===
After you’ve performed your actions, you refill your hand to 4 cards (or up to 6 if you have the “Expanded Living Quarters” Ship Upgrade).

You may draw cards from the deck for free, or pay 1 Doubloon to draw a card from the face up display. This is also free if you have “Charismatic Leader” Ship Upgrade.

After this, it is the next player’s turn.

----

== Main Actions (Phase B) ==

=== '''Village Spaces''' ===
When you land on a Village space, you can do one of the following:

* ● Perform Village Actions based on the number of spaces you moved.
** ---● 1 to 3 spaces: 1 Village Action
** ---● 4 to 6 spaces: 2 Village Actions
** ---● 7 spaces: 3 Village Actions
* ● Complete a Quest by paying its cost and gaining its effects. Your 4th quest is worth +3 VP and your 5th+ quests are worth +2 VP.
* ● Use an Assistant’s action

You start the game with 3 basic Village Actions:

* ● Gain 1 Doubloon
* ● Discard your entire hand for 2 Doubloons
* ● Buy a card

==== '''Buying a Card''' ====
When buying a card, you pay its cost (Doubloons, goods, and/or combat points) and then gain any bonuses:

*● Green Scrolls: Doubloon or VP Production. You will increase your production by the amount shown. You start the game with 0 VP Production and 8 Doubloon Production. You will gain this at the start of each round. Some production bonuses are locked until you gain the required synergy token. ''If you would gain Doubloon production beyond 34, all subsequent Doubloon production is converted to VP Production.''
*● Tan Scrolls: Immediate bonuses. Gain a number of Figures, Combat Points, etc.
*● Synergy Tokens: You gain the depicted synergy token. These unlock production on cards that show a matching synergy token requirement. You can only gain 1 of each synergy token, but you may still play multiple cards that provide a given synergy token. Gaining a synergy token activates any production bonuses you have that needed this token.
*● Red Scrolls: Passive Effects. These are ongoing effects or abilities that you can use at the specified time:
** ---● Last Village Actions can be used as the final village action whenever you receive a village actions
** ---● New combat actions to use once per Combat phase
** ---● Bonuses that give you additional exploration steps when you explore, or an extra combat point when you do Combat
*● Assistants Actions. Some cards are Assistants and require you to place a Figure at the designated space on the board to signify that you have an assistant there. These allow only you to take their special action at this space. ''If you don’t use an Assistant, skip past it, or don’t reach it in a round, you gain 2 VP immediately.''
*● Prestige Card endgame bonuses. You can buy any face up Prestige Card to unlock an endgame scoring bonus. Multiple players can buy the same prestige card, but if you are the first player to buy one, you receive an additional 2 VP. 

===City Spaces===
Cities allow you to perform powerful actions as well as make deliveries to improve your ship and abilities.

==== '''Deliveries''' ====
When you land on a City space, you first have the option to deliver a Good if there is an available market space. To do this, you must discard a card from your hand with a matching Good icon (Corn, Sugar, or Tobacco). ''This delivery must happen before taking the city’s action!''

After selecting a card to deliver, you must remove a Disk from your Ship Upgrades board. There are various upgrades that each have 2 Disks on them in the beginning of the game.

When you remove the first Disk from an upgrade, nothing happens. When you remove the '''second disk''', you unlock the associated upgrade. For example, one upgrade increase your hand size, another gives you an immediate 5 Doubloons, and another gives you a new Village Action.

==== '''Gaining Resources''' ====
After delivering, you may use the City’s action which have various effects, including:
*● Gaining Doubloons or Victory Points: You gain the amount shown
*● Gaining Combat Points: You gain the amount shown, but you cannot exceed 8 Combat Points at any given time
*● Gaining Figures: You gain the amount shown, but each player has a limited pool of 8 Figures.
** ---● At the start of the game, you have 2 in your personal supply that are free to use, 3 in the general supply that can be acquired, and 3 “locked” on your Career Card that you can acquire by completing Career objectives. ''If you would gain Figures from an action but have none in the general supply, you do not gain Figures.''
*● Gaining Influence: Move one space to the right with a nation of your choice on its Influence track. If you are already at the rightmost space, gain 2 VP instead.

==== '''Exploring''' ====
When you explore, you must move your Explorer on the Exploration Track on the bottom of the map up to the number of spaces shown. You gain the bonus shown. ''You cannot share a space with another player’s explorer.''

If you pass an exploration barrier (red, green, and blue bars), you immediately gain a bonus.

*● Red Barrier: Gain 3 Influence in one nation
*● Green and Blue barriers: Gain 4 VP if you are the first player to cross, otherwise gain 2 VP.

If you reach the end of the exploration track, you gain 1 Village Action and immediately receive an amount of bonus VP based on what player order you arrived in.

==== '''Combat''' ====
When you participate in combat, you are shown a Combat Token with Combat Point values for France, Spain, and England. These are “temporary” combat points that you will have only for the duration of the Combat. ''They are not added to your personal supply of Combat Points.''

Some tokens show a bonus of +3 Combat Points to the nation with the fewest Ownership Markers (cubes) on the board, while some tokens show a penalty of -2 Combat Points to the nation with the most Ownership Markers on the board. No bonus/penalty is awarded if there is a tie for fewest/most Ownership Markers.

You must choose one nation to fight for and can then perform combat actions by spending up to your temporary combat points PLUS your personal supply of combat points. Any card effects such as Sailor will also apply now and add Combat Points to your personal supply.

You may use each combat action ''once per Combat:''

*● Annexing a City allows you to gain an influence and place a cube for the nation you’re fighting for. You must pay 2 extra combat points if you annex a city where a different nation’s cube already exists to "displace" it. You gain the bonus shown on the city’s Flag (Doubloons, Figure, or VP).
*● You can gain 1 influence for 2 combat points or 2 influence for 5 combat points.
*● Annexing a Village allows you to gain an influence and place a cube for the nation you’re fighting for. You must pay 2 extra combat points if you annex a village where a different nation’s cube already exists to "displace" it. You gain 3 Doubloons per assistant of yours there, and 1 Doubloon per opponent’s assistant there. This action must be unlocked via the “Upgraded Cannons” Ship Upgrade.
*● Other cards feature new combat actions that also can be used only once per Combat.

After completing your actions, you gain the Combat Token which may be referenced by other actions or effects. ''Any unused temporary combat points received from the combat token ARE LOST and are not added to your personal supply.''

==== '''Combat Notes:''' ====
*● When an Ownership Marker is Displaced, it is removed from the game and does not return to its nation's supply.
*● If all Cities and Villages have Ownership Markers, you MUST displace another Ownership Marker if you want to add a cube to the board.
*● If a nation has no more Ownership Cubes, ''you cannot place another!''
*● If the supply of Combat Tiles runs out, you will perform Combat using a value of 3 Combat Points for your chosen nation.

----

== Free Actions ==

===Planning a Card===
At any time before Phase C, you may Plan a card by moving it from your hand to your Planning Area. You may buy a card from the Planning Area as normal, but it no longer can be used for a delivery, completing a Quest, or fulfilling any Goods or Items requirement.

=== Completing a Career Goal ===
You can complete a career goal at one of two levels. Both levels provide 1 Figure. The first level is easier but only rewards Doubloons, while the second level also rewards VP. If you are able to complete a career goal, you will see either a Doubloon or VP icon next to your Career card on your mini player board.

If you complete all 3 career goals, you gain an additional 2 VP and 2 Doubloons. You do not need to go in order!

----

==End of Round==

===Rounds 1 to 3===
When any player reaches Spaces 20, they must stop their movement and choose to do Combat or Explore. They must move to 21a on their next turn.

When a player lands on Space 21a, the round ends and every player will be able to Buy a Card or gain 2VP, before receiving production income. Then all ships move back to Havana, the first space. Player turn order is preserved - the next player in turn order after the player who landed on Space 21a will start the next round.

Production is received and the face up display of cards are wiped. New quests will be added to the board on spaces indicated by the “Upcoming Quest Locations” scroll found at the top of the board, to the left of the influence track. All delivery discs are removed from cities.

=== Round 4===
In Round 4, players must move from Space 20 to 21b and stop (instead of moving to 21a). On their next turn, they must move to Space 22 which triggers the end of the round. Players complete their Buy a Card or 2VP action and then proceed to final scoring.

After Round 4 ends, Victory Point production happens as normal, but Doubloon Production is converted to points based on the doubloon income track below the Influence Track
----

== Final Scoring==
You score Victory Points in the following ways for the following things:

1. VP earned from various actions during the 4 rounds

2. 1 VP per 5 remaining Doubloons

3. VP found on Project cards and Prestige cards

4. 3 VP per Influence track where you are furthest player

5. Influence VP ''for each nation.'' VP = Noble Rank x Nation Value

* ● A nation’s value is the sum of its base value and bonus. These are calculated and shown on the influence track and follow this system:
** ---● Nation's Base Value: The number of fully uncovered VP icons from a nation’s cube supply
** ---● Nation's Bonus: +2 VP / +1 VP if this nation has the most / second most Ownership Cubes on the board. If there is a tie for most, all tied nations receive the +2 VP bonus and other nations do not receive the +1 bonus. If only one nation has a strict majority, all nations with the second most Ownership Markers gain +1 VP.
* ● A player's noble rank for a nation is the furthest red banner they have reached on the influence track. This becomes the multiplier (0x to 6x) for the nations' value.
----

==FAQ==

===GENERAL===
GEN1: Why can't I buy this card? I have enough gold!

Make sure you can afford the *entire* card. Do you have enough figures (meeples) to play it?

GEN2: Where did my synergy token go? Why is the wrong synergy token showing in my player panel?

Synergy tokens are faded out before you own them and bright & colorful once you collect them. The number does not indicate that you own the token; it indicates that you have a synergy with the token. Remember that you can never have more than one of a token.

GEN3: On mobile, the game renders slowly or feels like the interface lags.

Try turning off shadows in the user preferences. This is especially true for iOS (Apple) devices, which render drop shadows poorly.

GEN4: Why isn't my Master Builder discount working? The card costs 5 and I have 4 doubloons!

A card's price displayed in GREEN indicates its discounted price. The game has already applied the discount, so you can't gain an additional discount.

===UPGRADES===
UPG1: Why don't I get the benefit after I perform an upgrade?

Make sure you've completed the *entire* upgrade. Both discs must be removed before the upgrade is active, not just the first disc.

===SOLO===
SOL1: Why is my score -1 after I lose to Jean?

The BGA framework counts all positive scores as a win, so anytime you lose to Jean your score is changed to a negative value. This tells BGA that although you're the highest-scoring (and only) player in the game, you did not win.

Gamehelparcticscavengers

2024-02-24T15:39:30Z

Kayvon:

==Objective==

The player with the largest tribe (most people) at the end of the game is the winner.

==Setup==

Each player starts with:
*4 refugee cards
*3 scavenger cards
*1 brawler card
*1 spear card
*1 shovel card

==Playing the Game==

Each round of Arctic Scavengers has three phases, played in the order shown below:

'''Drawing Phase'''
*1) Discard all cards from the previous round.
*2) Each player draws 5 cards from the top of their deck, shuffling the discard pile and adding it to the deck when their deck becomes exhausted.
*3) Beginning with the third round, and continuing for the remainder of the game, the initiator peeks at the top card on the contested resources pile and then returns it to the pile.
'''Resource Gathering Phase'''
*4) The initiator takes the first action and uses any number of cards to gather resources.
*5) The initiator announces how many of their cards will remain for the skirmish.
*6) Play continues with the other players, in clockwise order, and they execute steps 4 and 5.
'''Skirmish Phase (Round 3 and following)'''
*7) Once all players have taken their resource gathering actions, players reveal their remaining cards for the skirmish and a winner is determined.
*8) The winner of the skirmish takes the top card from the contested resources pile and adds it to their discard pile.
*9) The initiator passes the initiator card to their left-hand opponent, starting a new round.

The game continues like this until the contested resource pile is depleted.

==Resource Gathering==

During this phase, each player plays any number of cards from their hand in order to add more resources (cards) to their deck. Gathering starts with the player that has the initiator card (lying in their play area) and play continues in clockwise order.
There is no limit to the number of actions that a player can take during the resource gathering phase, although no action may be taken more than once.

'''Dig'''

The player draws one or more cards from the top of the junkyard pile. The player may choose one to place in their discard pile and returns any other cards to the bottom of the junkyard pile. The number of cards is determined by the sum of all the dig numbers displayed on the card(s) played from the player’s hand. As with other actions, dig may only be used once per round.

'''Draw'''

The player draws one or more cards from their deck, adding them to their hand. Multiple cards may be combined to draw several cards. As with other actions, draw may only be used once per round.

'''Hire'''

The hire ability is a free action (no card is needed to grant this action) in which a player takes a mercenary card from the face-up piles of cards. The player must be able to pay the cost displayed on the card. There are two currencies: food and medicine. Food is created in real-time using the hunt action (described below). Meds are provided in the form of medicine cards that must be played from the players hand in order to complete the hiring of a
mercenary. Medicine cards do not require an associated person to spend. Each player may only hire one mercenary per round, and the player immediately adds the card to their discard pile.

'''Hunt'''

The hunt ability generates food during the round that can then be used as currency for hiring a single mercenary card. The amount of food generated is determined by summing all hunt abilities played from the player’s hand. The player can assign tools to the mercenaries to improve their hunt abilities.

'''Trash'''

The trash ability is a free action (no card is needed to grant this action) that allows a player to take any number of cards from their hand and add them to the junkyard supply pile. The player does not draw cards from their deck to replace these cards. The junkyard pile is shuffled any time new cards are added.

'''Special Actions'''

Some cards may grant special actions that can be used in place of or to enhance a standard action. Examples include saboteur (disarm another player’s tool) and sniper team (snipe another player’s tribe member).

'''Using Tools'''

Each player starts with two tools – a spear and a shovel. Players can find additional tools by digging in the junkyard. Tools cannot perform actions on their own (these are inanimate, objects after all). A tribe member can use a single tool that enhances the ability of the action the tribe member is performing. Using a tool does not grant a tribe member an ability that they cannot inherently perform.

==Skirmish==

The game begins with two rounds of resource gathering (digging in the junkyard, hunting for food, and hiring mercenaries). In the first two rounds, there is no skirmishing. This allows each player to get a solid foundation prior to skirmishing over the contested resources. The initiator card remains with the first player for rounds 1-3. Thereafter, it moves to the initiator’s left at the start of each subsequent round.

Once all the players have completed their resource gathering actions, the skirmish phase begins. All players simultaneously reveal the cards that they have saved for the skirmish. The sum of the fight values from all of a player’s cards represents the strength of that player’s attack. All rules related to tool usage also apply to tools used as weapons during the skirmish phase (see ‘Using Tools’ above).
Skirmishes are resolved by starting with the initiator and having their declare any actions performed by their units (including saboteurs and sniper teams). Play then passes to the next player in clockwise order to declare actions for their units (provided that they were not sniped or disarmed by the previous player). This continues until all skirmish actions have been resolved. Then the total remaining fight values are summed and the player with the highest fight value wins. The winning player draws the top card from the contested resources supply pile and adds it to their discard pile without revealing it to the other players. When cards are played during the Resource Gathering phase, they are discarded after use. During the Skirmish Phase, all cards remain until the end of the round, even if a special power is activated (e.g. saboteur or sniper team).

'''Resolving ties'''

In the event of a tie, each player sums the number of people involved in the skirmish (this includes refugees and tribe families that may not be directly contributing to the fight score) and the player with the most people involved wins the skirmish. If players are still tied, then the skirmish is considered a deadlock. In this case, the players place the top card from the contested resources pile into the junkyard pile without looking at it. The players shuffle the junkyard and the round ends. The player with the initiator card passes it to the left to begin a new round.

==2 Player Variant==

*Remove two cards of each kind from the junkyard (i.e. 2 junk, 2 medkit, 2 pickaxe, etc.)
*Eliminate all contested resources peeking
*The number of tribe members a player brings to a skirmish is no longer relevant
*Skirmishes must be won by 2. If not, then it is a tie and the players place the contested resource on top of the junkyard and then shuffle the junkyard

==HQ expansion==

====Module #1 – Medics, Tools, and Gangs====

Adds
*• 8 Medic mercenaries (can draw, hire for 1 med (like pills) or stop a sniper attack)
*• 8 Junkyard cards (4 Rifle for +2 hunting and fighting, 4 Toolkit)
*• 2 Gangs - go to relevant player at the end of the game. Worth 5 people.

The Gearheads gang go to the player with the most cards with the tool icon. Ties broken by most tools that are contested resources.

The Pharmers gang go to the player with the highest total med value from pills and medkits. Ties are broken by most Medics.

====Module #2 – Engineers and Buildings====

Adds
*• 8 Engineer mercenaries
*• 12 buildings (3 each of bunkers, armories, pharmacies, hydroponic gardens)
*• 1 Gang, The Masons - goes to the player with the most completed and enabled buildings cards at the end of the game. Ties are broken by most Engineers. Worth 5 people.

Engineers can dig in the engineering schematics pile (12 building cards as above). The process of constructing a building is as follows:
#• Play an engineer card
#• Use the engineer’s dig (combined with any modifiers) to draw cards from the engineering schematics pile equal to the dig value
#• Select a maximum of 1 card to build and return the others to the bottom of the engineering schematics pile
#• Place the new building card face-up in your play area
#• Draw cards from the player’s deck equal to the building’s build time and place those facedown on top of the new building
#• Discard the engineer card
#• At the start of the player’s next round, remove 1 card from each building that is under construction
#• Starting with the round following the initial building placement, additional tribe members (and toolkits) may be played from the player’s hand to accelerate construction on one or more buildings. Each tribe member played can remove 1 card from a building that is under construction. If wielding a toolkit, then 2 additional cards may be removed. Tribe members that work on construction projects may not take any other actions that round and are immediately discarded.
#• Once a building has zero cards stacked on it, it is complete and immediately goes into effect.

====Module #3 – Tribal Leaders====

Adds 10 Tribal Leaders, each with a unique power.

Each player selects one of two leaders at the start of the game.

====Module #4 – Dirty Deeds====

'''New Saboteur Ability''': A saboteur may attack a building that is completed and disable it, rendering it unusable (flip the building’s card over to reveal its back, indicating that the building is disabled). If a building is disabled, its abilities cannot be used and cards cannot be added or removed from the building. To repair the building, a tribe member card must be played from the player’s hand to work on the building and then immediately discarded.

'''New Sniper Ability''': A sniper team may attack a tribal leader, wounding him (turn the leader’s card over to indicate the tribal leader is injured). This removes the leader’s advantage until a med is applied to the leader to heal him.

== Recon expansion ==

====Module 1 – Spy Hunter====

Adds
*•4 binoculars to junkyard
*•8(?) Spies to the mercenaries

'''Recon Action''' - Enables you to peek at cards and gain essential information. Recon rules:
*•Only you may see cards as a result of your recon action. You may not share this information with any other player.
*•Cards are returned in their original order.
*•It may be possible for your recon action to be interrupted through a cancel action or as a result of a snipe attack.

====Module 2 – Liars and Thieves====

Adds assassin, provocateur, rogue, and guard mercenaries (select 6 other mercenaries for a total of 10 in the market)

'''Assassin''': Like the sniper team, this mercenary has the ability to snipe an opponent’s tribe members during resource gathering or the skirmish. Unlike the sniper team, the assassin is restricted to only attacking single-unit tribe members (cards that represent only 1 tribe member).

'''Provocateur''': Grants a special means of fighting through intimidation. During your turn of the skirmish resolution phase, you may announce an intent to use the number of tribe members you brought to the skirmish as your fight score. Count the total size of your force (tribe members you brought, even if they are not fighters) ignoring any tools or other combat modifiers, but including leader and building abilities that increase the size of your force. Use the total force size as your fight score. If your provocateur gets sniped, your fight score reverts back to its natural score. The Gangster leader ability does not count toward the provocateur ability. A player in later turn order can snipe a provocateur in earlier turn order.

'''Rogue''': Grants a special skirmish win condition. If a skirmish ends with a tie for highest fight score, the first player in turn order with a rogue in the skirmish automatically wins the contested resource. Only a tie for highest fight score is considered, not the number of tribe members. The rogue ability constitutes a higher order of precedence than the number of tribe members brought to the skirmish. It is not necessary that the player using the rogue be involved in the tie. Any two players with identical fight scores trigger the potential for a rogue win condition for ANY player in the skirmish. At this point, the number of tribe members in the skirmish is not relevant. The rogue’s ability to steal the CR is passive. You do not need to give up the rogue’s fight in order to steal the CR. Your rogue can be targeted by a snipe action. Only the first rogue action can be successful per round (resolved in turn order). Multiple players cannot successfully use this action. A player in lower turn order can snipe a rogue in higher turn order.

'''Guard''': An inexpensive fighter, similar to a brawler. Can be used to cancel any action outside of the skirmish which targets your card(s). Examples include spying, sniping or disarming while you gather resources, attacks against your buildings, and etc. If you do use the guard for his cancel ability, discard him and draw a new card from the top of your deck.

====Module 3 – Expanding the Ranks====

Adds courier, drill sergeant, scrappers, and tinker (select 6 other mercenaries for a total of 10 in the market)

====Module 4 – Randomized Contested Resources====

Adds 14 contested resources (cargo sled, combat medic, demolition team, tear gas, tribal hunters)

The new contested resources are shuffled with the 14 base game contested resources and 14 are drawn for this game.

====Module 5 – The Kitchen Sink====

Adds
*•Humanitarians gang
*•Map
*•2 Leaders (Swindler and Yardmaster)

==FAQ==

===GENERAL===
GEN1: Why was the skirmish considered a tie in my two-player game? I should have won!

When playing with only two players, you must win the skirmish by at least two strength, otherwise it is considered a tie. There is no population tiebreaker in two player games.

Gamehelpmaracaibo

2024-02-24T15:20:07Z

Kayvon: /* FAQ */ formatting

Welcome to Maracaibo! You'll play as an independent seafarer in the Caribbean seeking wealth and fame through combat, exploration, and strategic card play.

Maracaibo is played over 4 rounds. Each round, you and your opponents will sail along a loop around the Caribbean, stopping at cities and villages to take actions. You can stop at as many spaces as you want during a round, but watch out! After any player reaches the end of the loop, the round will end and all players will move back to the start.

----

== What To Do On Your Turn ==
On your turn, you will go through these phases in this order:

=== Phase A - Sailing ===
On your turn, you must move 1 to 7 spaces forward in the loop. You may choose to follow either the upper or lower path at a fork.

=== Phase B - Perform Actions ===
You will perform a Main Action at the space you landed on. Each space is either a City or a Village, and this will determine what Main Actions you have available to you. You may also perform any Free Actions. This phase will be the bulk of your turn and is detailed in the next sections.

=== Phase C - Draw New Cards===
After you’ve performed your actions, you refill your hand to 4 cards (or up to 6 if you have the “Expanded Living Quarters” Ship Upgrade).

You may draw cards from the deck for free, or pay 1 Doubloon to draw a card from the face up display. This is also free if you have “Charismatic Leader” Ship Upgrade.

After this, it is the next player’s turn.

----

== Main Actions (Phase B) ==

=== '''Village Spaces''' ===
When you land on a Village space, you can do one of the following:

* ● Perform Village Actions based on the number of spaces you moved.
** ---● 1 to 3 spaces: 1 Village Action
** ---● 4 to 6 spaces: 2 Village Actions
** ---● 7 spaces: 3 Village Actions
* ● Complete a Quest by paying its cost and gaining its effects. Your 4th quest is worth +3 VP and your 5th+ quests are worth +2 VP.
* ● Use an Assistant’s action

You start the game with 3 basic Village Actions:

* ● Gain 1 Doubloon
* ● Discard your entire hand for 2 Doubloons
* ● Buy a card

==== '''Buying a Card''' ====
When buying a card, you pay its cost (Doubloons, goods, and/or combat points) and then gain any bonuses:

*● Green Scrolls: Doubloon or VP Production. You will increase your production by the amount shown. You start the game with 0 VP Production and 8 Doubloon Production. You will gain this at the start of each round. Some production bonuses are locked until you gain the required synergy token. ''If you would gain Doubloon production beyond 34, all subsequent Doubloon production is converted to VP Production.''
*● Tan Scrolls: Immediate bonuses. Gain a number of Figures, Combat Points, etc.
*● Synergy Tokens: You gain the depicted synergy token. These unlock production on cards that show a matching synergy token requirement. You can only gain 1 of each synergy token, but you may still play multiple cards that provide a given synergy token. Gaining a synergy token activates any production bonuses you have that needed this token.
*● Red Scrolls: Passive Effects. These are ongoing effects or abilities that you can use at the specified time:
** ---● Last Village Actions can be used as the final village action whenever you receive a village actions
** ---● New combat actions to use once per Combat phase
** ---● Bonuses that give you additional exploration steps when you explore, or an extra combat point when you do Combat
*● Assistants Actions. Some cards are Assistants and require you to place a Figure at the designated space on the board to signify that you have an assistant there. These allow only you to take their special action at this space. ''If you don’t use an Assistant, skip past it, or don’t reach it in a round, you gain 2 VP immediately.''
*● Prestige Card endgame bonuses. You can buy any face up Prestige Card to unlock an endgame scoring bonus. Multiple players can buy the same prestige card, but if you are the first player to buy one, you receive an additional 2 VP. 

===City Spaces===
Cities allow you to perform powerful actions as well as make deliveries to improve your ship and abilities.

==== '''Deliveries''' ====
When you land on a City space, you first have the option to deliver a Good if there is an available market space. To do this, you must discard a card from your hand with a matching Good icon (Corn, Sugar, or Tobacco). ''This delivery must happen before taking the city’s action!''

After selecting a card to deliver, you must remove a Disk from your Ship Upgrades board. There are various upgrades that each have 2 Disks on them in the beginning of the game.

When you remove the first Disk from an upgrade, nothing happens. When you remove the '''second disk''', you unlock the associated upgrade. For example, one upgrade increase your hand size, another gives you an immediate 5 Doubloons, and another gives you a new Village Action.

==== '''Gaining Resources''' ====
After delivering, you may use the City’s action which have various effects, including:
*● Gaining Doubloons or Victory Points: You gain the amount shown
*● Gaining Combat Points: You gain the amount shown, but you cannot exceed 8 Combat Points at any given time
*● Gaining Figures: You gain the amount shown, but each player has a limited pool of 8 Figures.
** ---● At the start of the game, you have 2 in your personal supply that are free to use, 3 in the general supply that can be acquired, and 3 “locked” on your Career Card that you can acquire by completing Career objectives. ''If you would gain Figures from an action but have none in the general supply, you do not gain Figures.''
*● Gaining Influence: Move one space to the right with a nation of your choice on its Influence track. If you are already at the rightmost space, gain 2 VP instead.

==== '''Exploring''' ====
When you explore, you must move your Explorer on the Exploration Track on the bottom of the map up to the number of spaces shown. You gain the bonus shown. ''You cannot share a space with another player’s explorer.''

If you pass an exploration barrier (red, green, and blue bars), you immediately gain a bonus.

*● Red Barrier: Gain 3 Influence in one nation
*● Green and Blue barriers: Gain 4 VP if you are the first player to cross, otherwise gain 2 VP.

If you reach the end of the exploration track, you gain 1 Village Action and immediately receive an amount of bonus VP based on what player order you arrived in.

==== '''Combat''' ====
When you participate in combat, you are shown a Combat Token with Combat Point values for France, Spain, and England. These are “temporary” combat points that you will have only for the duration of the Combat. ''They are not added to your personal supply of Combat Points.''

Some tokens show a bonus of +3 Combat Points to the nation with the fewest Ownership Markers (cubes) on the board, while some tokens show a penalty of -2 Combat Points to the nation with the most Ownership Markers on the board. No bonus/penalty is awarded if there is a tie for fewest/most Ownership Markers.

You must choose one nation to fight for and can then perform combat actions by spending up to your temporary combat points PLUS your personal supply of combat points. Any card effects such as Sailor will also apply now and add Combat Points to your personal supply.

You may use each combat action ''once per Combat:''

*● Annexing a City allows you to gain an influence and place a cube for the nation you’re fighting for. You must pay 2 extra combat points if you annex a city where a different nation’s cube already exists to "displace" it. You gain the bonus shown on the city’s Flag (Doubloons, Figure, or VP).
*● You can gain 1 influence for 2 combat points or 2 influence for 5 combat points.
*● Annexing a Village allows you to gain an influence and place a cube for the nation you’re fighting for. You must pay 2 extra combat points if you annex a village where a different nation’s cube already exists to "displace" it. You gain 3 Doubloons per assistant of yours there, and 1 Doubloon per opponent’s assistant there. This action must be unlocked via the “Upgraded Cannons” Ship Upgrade.
*● Other cards feature new combat actions that also can be used only once per Combat.

After completing your actions, you gain the Combat Token which may be referenced by other actions or effects. ''Any unused temporary combat points received from the combat token ARE LOST and are not added to your personal supply.''

==== '''Combat Notes:''' ====
*● When an Ownership Marker is Displaced, it is removed from the game and does not return to its nation's supply.
*● If all Cities and Villages have Ownership Markers, you MUST displace another Ownership Marker if you want to add a cube to the board.
*● If a nation has no more Ownership Cubes, ''you cannot place another!''
*● If the supply of Combat Tiles runs out, you will perform Combat using a value of 3 Combat Points for your chosen nation.

----

== Free Actions ==

===Planning a Card===
At any time before Phase C, you may Plan a card by moving it from your hand to your Planning Area. You may buy a card from the Planning Area as normal, but it no longer can be used for a delivery, completing a Quest, or fulfilling any Goods or Items requirement.

=== Completing a Career Goal ===
You can complete a career goal at one of two levels. Both levels provide 1 Figure. The first level is easier but only rewards Doubloons, while the second level also rewards VP. If you are able to complete a career goal, you will see either a Doubloon or VP icon next to your Career card on your mini player board.

If you complete all 3 career goals, you gain an additional 2 VP and 2 Doubloons. You do not need to go in order!

----

==End of Round==

===Rounds 1 to 3===
When any player reaches Spaces 20, they must stop their movement and choose to do Combat or Explore. They must move to 21a on their next turn.

When a player lands on Space 21a, the round ends and every player will be able to Buy a Card or gain 2VP, before receiving production income. Then all ships move back to Havana, the first space. Player turn order is preserved - the next player in turn order after the player who landed on Space 21a will start the next round.

Production is received and the face up display of cards are wiped. New quests will be added to the board on spaces indicated by the “Upcoming Quest Locations” scroll found at the top of the board, to the left of the influence track. All delivery discs are removed from cities.

=== Round 4===
In Round 4, players must move from Space 20 to 21b and stop (instead of moving to 21a). On their next turn, they must move to Space 22 which triggers the end of the round. Players complete their Buy a Card or 2VP action and then proceed to final scoring.

After Round 4 ends, Victory Point production happens as normal, but Doubloon Production is converted to points based on the doubloon income track below the Influence Track
----

== Final Scoring==
You score Victory Points in the following ways for the following things:

1. VP earned from various actions during the 4 rounds

2. 1 VP per 5 remaining Doubloons

3. VP found on Project cards and Prestige cards

4. 3 VP per Influence track where you are furthest player

5. Influence VP ''for each nation.'' VP = Noble Rank x Nation Value

* ● A nation’s value is the sum of its base value and bonus. These are calculated and shown on the influence track and follow this system:
** ---● Nation's Base Value: The number of fully uncovered VP icons from a nation’s cube supply
** ---● Nation's Bonus: +2 VP / +1 VP if this nation has the most / second most Ownership Cubes on the board. If there is a tie for most, all tied nations receive the +2 VP bonus and other nations do not receive the +1 bonus. If only one nation has a strict majority, all nations with the second most Ownership Markers gain +1 VP.
* ● A player's noble rank for a nation is the furthest red banner they have reached on the influence track. This becomes the multiplier (0x to 6x) for the nations' value.
----

==FAQ==

===GENERAL===
GEN1: Why can't I buy this card? I have enough gold!

Make sure you can afford the *entire* card. Do you have enough figures (meeples) to play it?

GEN2: Where did my synergy token go? Why is the wrong synergy token showing in my player panel?

Synergy tokens are faded out before you own them and bright & colorful once you collect them. The number does not indicate that you own the token; it indicates that you have a synergy with the token. Remember that you can never have more than one of a token.

GEN3: On mobile, the game renders slowly or feels like the interface lags.

Try turning off shadows in the user preferences. This is especially true for iOS (Apple) devices, which render drop shadows poorly.

===UPGRADES===
UPG1: Why don't I get the benefit after I perform an upgrade?

Make sure you've completed the *entire* upgrade. Both discs must be removed before the upgrade is active, not just the first disc.

===SOLO===
SOL1: Why is my score -1 after I lose to Jean?

The BGA framework counts all positive scores as a win, so anytime you lose to Jean your score is changed to a negative value. This tells BGA that although you're the highest-scoring (and only) player in the game, you did not win.

Gamehelpmaracaibo

2024-02-24T15:18:10Z

Kayvon: /* GENERAL */ Added GEN3

Welcome to Maracaibo! You'll play as an independent seafarer in the Caribbean seeking wealth and fame through combat, exploration, and strategic card play.

Maracaibo is played over 4 rounds. Each round, you and your opponents will sail along a loop around the Caribbean, stopping at cities and villages to take actions. You can stop at as many spaces as you want during a round, but watch out! After any player reaches the end of the loop, the round will end and all players will move back to the start.

----

== What To Do On Your Turn ==
On your turn, you will go through these phases in this order:

=== Phase A - Sailing ===
On your turn, you must move 1 to 7 spaces forward in the loop. You may choose to follow either the upper or lower path at a fork.

=== Phase B - Perform Actions ===
You will perform a Main Action at the space you landed on. Each space is either a City or a Village, and this will determine what Main Actions you have available to you. You may also perform any Free Actions. This phase will be the bulk of your turn and is detailed in the next sections.

=== Phase C - Draw New Cards===
After you’ve performed your actions, you refill your hand to 4 cards (or up to 6 if you have the “Expanded Living Quarters” Ship Upgrade).

You may draw cards from the deck for free, or pay 1 Doubloon to draw a card from the face up display. This is also free if you have “Charismatic Leader” Ship Upgrade.

After this, it is the next player’s turn.

----

== Main Actions (Phase B) ==

=== '''Village Spaces''' ===
When you land on a Village space, you can do one of the following:

* ● Perform Village Actions based on the number of spaces you moved.
** ---● 1 to 3 spaces: 1 Village Action
** ---● 4 to 6 spaces: 2 Village Actions
** ---● 7 spaces: 3 Village Actions
* ● Complete a Quest by paying its cost and gaining its effects. Your 4th quest is worth +3 VP and your 5th+ quests are worth +2 VP.
* ● Use an Assistant’s action

You start the game with 3 basic Village Actions:

* ● Gain 1 Doubloon
* ● Discard your entire hand for 2 Doubloons
* ● Buy a card

==== '''Buying a Card''' ====
When buying a card, you pay its cost (Doubloons, goods, and/or combat points) and then gain any bonuses:

*● Green Scrolls: Doubloon or VP Production. You will increase your production by the amount shown. You start the game with 0 VP Production and 8 Doubloon Production. You will gain this at the start of each round. Some production bonuses are locked until you gain the required synergy token. ''If you would gain Doubloon production beyond 34, all subsequent Doubloon production is converted to VP Production.''
*● Tan Scrolls: Immediate bonuses. Gain a number of Figures, Combat Points, etc.
*● Synergy Tokens: You gain the depicted synergy token. These unlock production on cards that show a matching synergy token requirement. You can only gain 1 of each synergy token, but you may still play multiple cards that provide a given synergy token. Gaining a synergy token activates any production bonuses you have that needed this token.
*● Red Scrolls: Passive Effects. These are ongoing effects or abilities that you can use at the specified time:
** ---● Last Village Actions can be used as the final village action whenever you receive a village actions
** ---● New combat actions to use once per Combat phase
** ---● Bonuses that give you additional exploration steps when you explore, or an extra combat point when you do Combat
*● Assistants Actions. Some cards are Assistants and require you to place a Figure at the designated space on the board to signify that you have an assistant there. These allow only you to take their special action at this space. ''If you don’t use an Assistant, skip past it, or don’t reach it in a round, you gain 2 VP immediately.''
*● Prestige Card endgame bonuses. You can buy any face up Prestige Card to unlock an endgame scoring bonus. Multiple players can buy the same prestige card, but if you are the first player to buy one, you receive an additional 2 VP. 

===City Spaces===
Cities allow you to perform powerful actions as well as make deliveries to improve your ship and abilities.

==== '''Deliveries''' ====
When you land on a City space, you first have the option to deliver a Good if there is an available market space. To do this, you must discard a card from your hand with a matching Good icon (Corn, Sugar, or Tobacco). ''This delivery must happen before taking the city’s action!''

After selecting a card to deliver, you must remove a Disk from your Ship Upgrades board. There are various upgrades that each have 2 Disks on them in the beginning of the game.

When you remove the first Disk from an upgrade, nothing happens. When you remove the '''second disk''', you unlock the associated upgrade. For example, one upgrade increase your hand size, another gives you an immediate 5 Doubloons, and another gives you a new Village Action.

==== '''Gaining Resources''' ====
After delivering, you may use the City’s action which have various effects, including:
*● Gaining Doubloons or Victory Points: You gain the amount shown
*● Gaining Combat Points: You gain the amount shown, but you cannot exceed 8 Combat Points at any given time
*● Gaining Figures: You gain the amount shown, but each player has a limited pool of 8 Figures.
** ---● At the start of the game, you have 2 in your personal supply that are free to use, 3 in the general supply that can be acquired, and 3 “locked” on your Career Card that you can acquire by completing Career objectives. ''If you would gain Figures from an action but have none in the general supply, you do not gain Figures.''
*● Gaining Influence: Move one space to the right with a nation of your choice on its Influence track. If you are already at the rightmost space, gain 2 VP instead.

==== '''Exploring''' ====
When you explore, you must move your Explorer on the Exploration Track on the bottom of the map up to the number of spaces shown. You gain the bonus shown. ''You cannot share a space with another player’s explorer.''

If you pass an exploration barrier (red, green, and blue bars), you immediately gain a bonus.

*● Red Barrier: Gain 3 Influence in one nation
*● Green and Blue barriers: Gain 4 VP if you are the first player to cross, otherwise gain 2 VP.

If you reach the end of the exploration track, you gain 1 Village Action and immediately receive an amount of bonus VP based on what player order you arrived in.

==== '''Combat''' ====
When you participate in combat, you are shown a Combat Token with Combat Point values for France, Spain, and England. These are “temporary” combat points that you will have only for the duration of the Combat. ''They are not added to your personal supply of Combat Points.''

Some tokens show a bonus of +3 Combat Points to the nation with the fewest Ownership Markers (cubes) on the board, while some tokens show a penalty of -2 Combat Points to the nation with the most Ownership Markers on the board. No bonus/penalty is awarded if there is a tie for fewest/most Ownership Markers.

You must choose one nation to fight for and can then perform combat actions by spending up to your temporary combat points PLUS your personal supply of combat points. Any card effects such as Sailor will also apply now and add Combat Points to your personal supply.

You may use each combat action ''once per Combat:''

*● Annexing a City allows you to gain an influence and place a cube for the nation you’re fighting for. You must pay 2 extra combat points if you annex a city where a different nation’s cube already exists to "displace" it. You gain the bonus shown on the city’s Flag (Doubloons, Figure, or VP).
*● You can gain 1 influence for 2 combat points or 2 influence for 5 combat points.
*● Annexing a Village allows you to gain an influence and place a cube for the nation you’re fighting for. You must pay 2 extra combat points if you annex a village where a different nation’s cube already exists to "displace" it. You gain 3 Doubloons per assistant of yours there, and 1 Doubloon per opponent’s assistant there. This action must be unlocked via the “Upgraded Cannons” Ship Upgrade.
*● Other cards feature new combat actions that also can be used only once per Combat.

After completing your actions, you gain the Combat Token which may be referenced by other actions or effects. ''Any unused temporary combat points received from the combat token ARE LOST and are not added to your personal supply.''

==== '''Combat Notes:''' ====
*● When an Ownership Marker is Displaced, it is removed from the game and does not return to its nation's supply.
*● If all Cities and Villages have Ownership Markers, you MUST displace another Ownership Marker if you want to add a cube to the board.
*● If a nation has no more Ownership Cubes, ''you cannot place another!''
*● If the supply of Combat Tiles runs out, you will perform Combat using a value of 3 Combat Points for your chosen nation.

----

== Free Actions ==

===Planning a Card===
At any time before Phase C, you may Plan a card by moving it from your hand to your Planning Area. You may buy a card from the Planning Area as normal, but it no longer can be used for a delivery, completing a Quest, or fulfilling any Goods or Items requirement.

=== Completing a Career Goal ===
You can complete a career goal at one of two levels. Both levels provide 1 Figure. The first level is easier but only rewards Doubloons, while the second level also rewards VP. If you are able to complete a career goal, you will see either a Doubloon or VP icon next to your Career card on your mini player board.

If you complete all 3 career goals, you gain an additional 2 VP and 2 Doubloons. You do not need to go in order!

----

==End of Round==

===Rounds 1 to 3===
When any player reaches Spaces 20, they must stop their movement and choose to do Combat or Explore. They must move to 21a on their next turn.

When a player lands on Space 21a, the round ends and every player will be able to Buy a Card or gain 2VP, before receiving production income. Then all ships move back to Havana, the first space. Player turn order is preserved - the next player in turn order after the player who landed on Space 21a will start the next round.

Production is received and the face up display of cards are wiped. New quests will be added to the board on spaces indicated by the “Upcoming Quest Locations” scroll found at the top of the board, to the left of the influence track. All delivery discs are removed from cities.

=== Round 4===
In Round 4, players must move from Space 20 to 21b and stop (instead of moving to 21a). On their next turn, they must move to Space 22 which triggers the end of the round. Players complete their Buy a Card or 2VP action and then proceed to final scoring.

After Round 4 ends, Victory Point production happens as normal, but Doubloon Production is converted to points based on the doubloon income track below the Influence Track
----

== Final Scoring==
You score Victory Points in the following ways for the following things:

1. VP earned from various actions during the 4 rounds

2. 1 VP per 5 remaining Doubloons

3. VP found on Project cards and Prestige cards

4. 3 VP per Influence track where you are furthest player

5. Influence VP ''for each nation.'' VP = Noble Rank x Nation Value

* ● A nation’s value is the sum of its base value and bonus. These are calculated and shown on the influence track and follow this system:
** ---● Nation's Base Value: The number of fully uncovered VP icons from a nation’s cube supply
** ---● Nation's Bonus: +2 VP / +1 VP if this nation has the most / second most Ownership Cubes on the board. If there is a tie for most, all tied nations receive the +2 VP bonus and other nations do not receive the +1 bonus. If only one nation has a strict majority, all nations with the second most Ownership Markers gain +1 VP.
* ● A player's noble rank for a nation is the furthest red banner they have reached on the influence track. This becomes the multiplier (0x to 6x) for the nations' value.
----

==FAQ==

===GENERAL===
GEN1: Why can't I buy this card? I have enough gold!
Make sure you can afford the *entire* card. Do you have enough figures (meeples) to play it?

GEN2: Where did my synergy token go? Why is the wrong synergy token showing in my player panel?
Synergy tokens are faded out before you own them and bright & colorful once you collect them. The number does not indicate that you own the token; it indicates that you have a synergy with the token. Remember that you can never have more than one of a token.

GEN3: On mobile, the game renders slowly or feels like the interface lags.
Try turning off shadows in the user preferences. This is especially true for iOS (Apple) devices, which render drop shadows poorly.

===UPGRADES===
UPG1: Why don't I get the benefit after I perform an upgrade?
Make sure you've completed the *entire* upgrade. Both discs must be removed before the upgrade is active, not just the first disc.

===SOLO===
SOL1: Why is my score -1 after I lose to Jean?
The BGA framework counts all positive scores as a win, so anytime you lose to Jean your score is changed to a negative value. This tells BGA that although you're the highest-scoring (and only) player in the game, you did not win.

Gamehelpparks

2024-02-13T01:41:18Z

Kayvon: /* Error Messages */

== Overview ==
Players take on the roles of two Hikers as they trek across different Trails during the four Seasons (rounds) of a Year. Each Trail represents a different Season, and as each Season passes, the Trails change and grow steadily longer. Each turn, players send one of their Hikers down the Trail. While on the Trail, Hikers will see beautiful Sites and perform an action when they arrive. When a Hiker reaches the end of the Trail, they can spend tokens they have received to visit Parks and earn points. Your goal is to have the most points from your Parks, Photos, and Personal Bonus at the end of the Year.

== Starting a Season ==
All of the Sites (spaces) in the current trail [or all the Basic Sites at the start of the game] are mixed together with a random additional Advanced Site. They are laid out with the Trailhead on one side, and the Trail End on the other, making this Season's Trail. Both Hikers for each player start the Season on the Trailhead. A Season card is drawn, which will have either an immediate effect, or an ongoing effect that applies to the entire Season. The bottom of the Season card also shows a "Weather Pattern"; the tokens shown in this pattern are placed on the Trail Sites, starting with the 2nd site. (Note that the Trailhead and Trail End spaces are not Sites). The player with {{ParksFirstHiker}} will take the first turn of the Season, with players taking turns in clockwise order.

* If this is the start of the game, the player to the right of the First Hiker receives the {{ParksCamera}}, and all players draw a Canteen.

== Taking turns ==
On a turn, a player selects either one of their Hikers and moves them down the Trail -- any space to the right of that Hiker’s current location.

* If any Hiker, even your own, is on a Site, you may not move onto that Site, unless you extinguish your Campfire. If your Campfire is already extinguished, you may not move to occupied Sites.

* If the Hiker is the first to land on a Site with a token on it (from the Weather Pattern), the player takes the token into their supply.
* The player then takes the action of the Site their Hiker moved to. Hikers cannot be moved to Sites where the player cannot take the action.
* If you gain {{ParksWater}} on your turn, you can place it in an empty Canteen that you have (and only when gaining {{ParksWater}}), to gain the benefit shown on the Canteen card.
* {{ParksWildlife}} are "wild" and can be used in place of another token, except they may not be used to fill Canteens, or as part of exchange abilities (as noted on those cards).
* If you have more than 12 tokens at the end of your turn, you must discard down to 12. The tokens are component limited.

== Trail End ==
When you move a Hiker to the Trail End, you relight your Campfire if it is extinguished, and then choose one of the three areas to place your Hiker: (any number of Hikers can be on each area)

=== Reserve a Park ===

* Take a face-up Park or a Park from the top of the deck; it is placed horizontally in your player area. If you took a face-up Park, the empty slot is refilled from the deck
* You don't pay resources or score points now, but you may later Visit that Park [and no one else can].
* The first player who uses this space each season takes {{ParksFirstHiker}}.

=== Buy Gear ===

* You may buy one of the face-up Gear cards on the board by paying {{ParksSunshine}} equal to its cost [in the upper right of the card].
* The first player [and also the second player in a 4-5 player game] to use this space can buy Gear for one fewer {{ParksSunshine}}.
* Gear gives ongoing abilities for the rest of the game, and some also have an instant action, denoted by a lightning bolt.

=== Visit a Park ===

* Pay the cost shown on any face-up Park, or one you have reserved, to gain the indicated number of points, and the card is placed vertically in your player area, refilling the board if necessary.

== End of a Season ==
Once a player’s two Hikers reach the Trail End, they will no longer take turns for the Season. When only one Hiker is left on the Trail, the player must move the Hiker to the Trail End on their next turn and choose an action there. Then, it is the end of the Season.

At the end of a Season:
*- The player with the {{ParksCamera}} may pay 1 token to take a Photo.
*- All Canteens are emptied, and their {{ParksWater}} are returned to the supply.
*- If this was the fourth Season, the game is over. Otherwise, Start the next Season (see above).

At the end of the game:
*- All players reveal their Year cards and score points based on their Personal Bonus.
*- The player with {{ParksFirstHiker}} gains 1 additional point.

The player with the most points at the end is the winner! If tied, the win goes to the player who visited the most Parks. If still tied, the win is shared.

== Basic Sites ==
'''Forest''': Gain {{ParksForest|1}}.

'''Mountain''': Gain {{ParksMountain|1}}.

'''Ocean''': Gain {{ParksWater|2}}.

'''Valley''': Gain {{ParksSunshine|2}}.

'''Vista''': Either:

* - Draw a Canteen (you can have any number of Canteens, so long as there are any left in the deck) OR
* - Spend any 2 tokens to take a Photo, and then take the {{ParksCamera}} from whoever currently has it. (Photos are worth 1 point each. When you have the {{ParksCamera}}, when any ability lets you spend 2 tokens to take a Photo, you only spend 1 instead.)

'''Waterfall''': Gain {{ParksSunshine|1}} and {{ParksWater|1}}.[4-5 player games only]

== Advanced Sites ==
'''Lodge''': Turn in one token and gain any one token ''(excluding {{ParksWildlife}})''. You may do this a second time.

'''Lookout''': Reserve or Visit a Park OR Buy a Gear card.

'''Wildlife''': Turn in any one token to gain {{ParksWildlife|1}}.

'''River''': Turn in {{ParksWater|1}} to copy the action from another Site currently occupied by any Hiker. (Gear that would allow you special actions on the copied space do not activate, as you are not actually on that space)

== Notable Game Components ==

*- 48 Park cards
*- 36 Gear cards
*- 15 Canteen cards
*- 28 Photos
*- {{ParksForest|16}}
*- {{ParksMountain|16}}
*- {{ParksSunshine|30}}
*- {{ParksWater|30}}
*- {{ParksWildlife|12}}

== FAQ ==
=== Error Messages ===

==== ERR1: "This action would leave you unable to complete your turn" on River space ====
This is not a bug! The river space's costs a rain token to complete. If you attempt to take an action that leaves you without rain or wild tokens, you cannot complete the river action. The error message is accurate.

==== ERR2: "You don't have enough resources to visit [this park]" on River space. ====
See ERR1.

=== Gear ===

==== GEAR1: Why didn't my gear activate when copying a location? ====
Some gear requires you to be at a specific site for it to activate. Copying the action of a location does not place your hiker on the location, so it will not trigger the gear.

Gamehelpparks

2024-02-13T01:37:05Z

Kayvon: Added FAQ

== Overview ==
Players take on the roles of two Hikers as they trek across different Trails during the four Seasons (rounds) of a Year. Each Trail represents a different Season, and as each Season passes, the Trails change and grow steadily longer. Each turn, players send one of their Hikers down the Trail. While on the Trail, Hikers will see beautiful Sites and perform an action when they arrive. When a Hiker reaches the end of the Trail, they can spend tokens they have received to visit Parks and earn points. Your goal is to have the most points from your Parks, Photos, and Personal Bonus at the end of the Year.

== Starting a Season ==
All of the Sites (spaces) in the current trail [or all the Basic Sites at the start of the game] are mixed together with a random additional Advanced Site. They are laid out with the Trailhead on one side, and the Trail End on the other, making this Season's Trail. Both Hikers for each player start the Season on the Trailhead. A Season card is drawn, which will have either an immediate effect, or an ongoing effect that applies to the entire Season. The bottom of the Season card also shows a "Weather Pattern"; the tokens shown in this pattern are placed on the Trail Sites, starting with the 2nd site. (Note that the Trailhead and Trail End spaces are not Sites). The player with {{ParksFirstHiker}} will take the first turn of the Season, with players taking turns in clockwise order.

* If this is the start of the game, the player to the right of the First Hiker receives the {{ParksCamera}}, and all players draw a Canteen.

== Taking turns ==
On a turn, a player selects either one of their Hikers and moves them down the Trail -- any space to the right of that Hiker’s current location.

* If any Hiker, even your own, is on a Site, you may not move onto that Site, unless you extinguish your Campfire. If your Campfire is already extinguished, you may not move to occupied Sites.

* If the Hiker is the first to land on a Site with a token on it (from the Weather Pattern), the player takes the token into their supply.
* The player then takes the action of the Site their Hiker moved to. Hikers cannot be moved to Sites where the player cannot take the action.
* If you gain {{ParksWater}} on your turn, you can place it in an empty Canteen that you have (and only when gaining {{ParksWater}}), to gain the benefit shown on the Canteen card.
* {{ParksWildlife}} are "wild" and can be used in place of another token, except they may not be used to fill Canteens, or as part of exchange abilities (as noted on those cards).
* If you have more than 12 tokens at the end of your turn, you must discard down to 12. The tokens are component limited.

== Trail End ==
When you move a Hiker to the Trail End, you relight your Campfire if it is extinguished, and then choose one of the three areas to place your Hiker: (any number of Hikers can be on each area)

=== Reserve a Park ===

* Take a face-up Park or a Park from the top of the deck; it is placed horizontally in your player area. If you took a face-up Park, the empty slot is refilled from the deck
* You don't pay resources or score points now, but you may later Visit that Park [and no one else can].
* The first player who uses this space each season takes {{ParksFirstHiker}}.

=== Buy Gear ===

* You may buy one of the face-up Gear cards on the board by paying {{ParksSunshine}} equal to its cost [in the upper right of the card].
* The first player [and also the second player in a 4-5 player game] to use this space can buy Gear for one fewer {{ParksSunshine}}.
* Gear gives ongoing abilities for the rest of the game, and some also have an instant action, denoted by a lightning bolt.

=== Visit a Park ===

* Pay the cost shown on any face-up Park, or one you have reserved, to gain the indicated number of points, and the card is placed vertically in your player area, refilling the board if necessary.

== End of a Season ==
Once a player’s two Hikers reach the Trail End, they will no longer take turns for the Season. When only one Hiker is left on the Trail, the player must move the Hiker to the Trail End on their next turn and choose an action there. Then, it is the end of the Season.

At the end of a Season:
*- The player with the {{ParksCamera}} may pay 1 token to take a Photo.
*- All Canteens are emptied, and their {{ParksWater}} are returned to the supply.
*- If this was the fourth Season, the game is over. Otherwise, Start the next Season (see above).

At the end of the game:
*- All players reveal their Year cards and score points based on their Personal Bonus.
*- The player with {{ParksFirstHiker}} gains 1 additional point.

The player with the most points at the end is the winner! If tied, the win goes to the player who visited the most Parks. If still tied, the win is shared.

== Basic Sites ==
'''Forest''': Gain {{ParksForest|1}}.

'''Mountain''': Gain {{ParksMountain|1}}.

'''Ocean''': Gain {{ParksWater|2}}.

'''Valley''': Gain {{ParksSunshine|2}}.

'''Vista''': Either:

* - Draw a Canteen (you can have any number of Canteens, so long as there are any left in the deck) OR
* - Spend any 2 tokens to take a Photo, and then take the {{ParksCamera}} from whoever currently has it. (Photos are worth 1 point each. When you have the {{ParksCamera}}, when any ability lets you spend 2 tokens to take a Photo, you only spend 1 instead.)

'''Waterfall''': Gain {{ParksSunshine|1}} and {{ParksWater|1}}.[4-5 player games only]

== Advanced Sites ==
'''Lodge''': Turn in one token and gain any one token ''(excluding {{ParksWildlife}})''. You may do this a second time.

'''Lookout''': Reserve or Visit a Park OR Buy a Gear card.

'''Wildlife''': Turn in any one token to gain {{ParksWildlife|1}}.

'''River''': Turn in {{ParksWater|1}} to copy the action from another Site currently occupied by any Hiker. (Gear that would allow you special actions on the copied space do not activate, as you are not actually on that space)

== Notable Game Components ==

*- 48 Park cards
*- 36 Gear cards
*- 15 Canteen cards
*- 28 Photos
*- {{ParksForest|16}}
*- {{ParksMountain|16}}
*- {{ParksSunshine|30}}
*- {{ParksWater|30}}
*- {{ParksWildlife|12}}

== FAQ ==
=== Error Messages ===
ERR1: "This action would leave you unable to complete your turn" on River space

This is not a bug! The river space's costs a rain token to complete. If you attempt to take an action that leaves you without rain or wild tokens, you cannot complete the river action. The error message is accurate.

ERR2: "You don't have enough resources to visit [this park]" on River space.

See ERR1.

=== Gear ===
GEAR1: Why didn't my gear activate when copying a location?

Some gear requires you to be at a specific site for it to activate. Copying the action of a location does not place your hiker on the location, so it will not trigger the gear.

Gamehelpmaracaibo

2023-12-31T14:45:38Z

Kayvon: Added FAQ

== FAQ ==

=== GENERAL ===
GEN1: Why can't I buy this card? I have enough gold!
Make sure you can afford the *entire* card. Do you have enough figures (meeples) to play it?

GEN2: Where did my synergy token go? Why is the wrong synergy token showing in my player panel?
Synergy tokens are faded out before you own than and bright & colorful once you collect them. The number does not indicate that you own the token; it indicates that you have a synergy with the token. Remember that you can never have more than one of a token.

=== UPGRADES ===
UPG1: Why don't I get the benefit after I perform an upgrade?
Make sure you've completed the *entire* upgrade. Both discs must be removed before the upgrade is active, not just the first disc.

=== SOLO ===
SOL1: Why is my score -1 after I lose to Jean?
The BGA framework counts all positive scores as a win, so anytime you lose to Jean your score is changed to a negative value. This tells BGA that although you're the highest-scoring (and only) player in the game, you did not win.

Gamehelpgaiaproject

2023-04-02T16:23:26Z

Kayvon: /* Auctions for Drafting Factions */ bolding the part people overlook

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Actions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
[[Image:Gaia_Project_Free_Actions.JPG]]
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits the maximum amount he is willing to bid for each faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction. During the round-robin portion, each player automatically bids '''on the faction with the greatest difference between the faction's current bid and that player's maximum possible bid.'''

A typical auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction he wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelpgaiaproject

2022-10-31T14:22:23Z

Kayvon: /* Auctions for Drafting Factions */

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Actions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits the maximum amount he is willing to bid for each faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction. During the round-robin portion, each player automatically bids on the faction with the greatest difference between the faction's current bid and that player's maximum possible bid.

A typical auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction he wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelpgaiaproject

2022-10-31T14:21:03Z

Kayvon: /* Auctions for Drafting Factions */ Clarifications

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Actions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits the maximum< amount he is willing to bid for each faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction. Each player automatically bids on the faction with the greatest difference between the faction's current bid and that player's maximum possible bid.

A typical auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction he wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelpspaceempires

2022-10-02T17:10:13Z

Kayvon: /* Retreat */

Discuss this game in the [https://boardgamearena.com/group?id=10418422 Space Empires Group].

If you encounter any bugs, please [https://boardgamearena.com/bugs?game=1488 fill out a bug report here]!

= Space Empires 4X =

== Introduction ==
'''Space Empires 4X''' is a game in the 4X empire-building genre (''eXplore, eXpand, eXploit, eXterminate'') for one to four players. Eliminating your opponent's Homeworld wins you the game. Beginners should start with the Basic Rules. The galaxy game board is made up of hexes and your pieces are square counters (aka chits or tokens). All dice rolls in the game are done with a 10-sided die and "0" equals 10.

== Game Start ==
Choose the hex in your Home System where you'd like your Homeworld to be located.
Once all players have made their choice, the galaxy populates with random hidden counters (square tokens) and your Homeworld will appear with the following units:
* Shipyard
* Miner
* Scouts (x3)
* Colony Ships (x3)

== Sequence of Play ==
Space Empires 4X is played with 3 normal turns followed by an Economic Phase and then repeated.
On turn one, a die is rolled to determine first player. In future turns, first player is determined through bidding in the Economic Phase.

# Determine player order
# Turn One:
#* Player 1
## Movement
## Combat
## Exploration
#* Players 2-4: Same as Player 1
# Turn Two: Same as Turn One
# Turn Three: Same as Turn One
# Economic Phase: All players conduct this phase simultaneously.

== Movement ==
Your units can move into adjacent hexes based on your Movement Technology Level, which starts at 1 hex. During your Move phase you can move one, some, all, or none of your units. When you develop your Movement Technology and Upgrade your ship(s) you are able to move additional hex spaces:
* Level 2: Ships move 1 space in turns 1-2 and then 2 spaces in turn 3.
* Level 3: Ships move 1 space in turn 1 and then 2 spaces in turns 2-3.
* Level 4: Ships move 2 spaces in all turns.
* Level 5: Ships move 2 spaces in turns 1-2 and then 3 spaces in turn 3.
* Level 6: Ships move 2 spaces in turn 1 and then 2 spaces in turns 2-3.
* Level 7: Ships move 3 spaces in all turns.
Mining Ships, Colony Ships, MS Pipelines, and Mines only ever move 1 space per turn.
Bases and Ship Yards do not move.

=== Movement Restrictions ===
Units may not enter a hex with a face-down (unexplored) System marker, a Nebula, or Asteroids, unless it starts its turn adjacent to it. Entering a hex with any of these markers ends that unit’s movement, regardless of its Movement Technology Level.

Moving a unit without Attack Strength (ie: Miners, Colony Ships, or Decoys) into a hex with a face-down (unexplored) System marker, enemy unit, or enemy colony is not allowed ''unless'' a combat capable ship has also entered that hex.

=== Enemy Occupied Hexes ===
If you enter a hex occupied by a combat-capable enemy unit you '''must''' stop movement and attack during the Combat phase. If the hex is occupied by enemy units without combat capability, they are immediately destroyed and do not impede movement. You may ignore an enemy Colony and move through the planet or you may stop and attack it during Combat phase.

=== Planets and Colonization ===
Planets without Colonies do not affect your movement and may be Colonized by a Colony Ship. If a Colony is destroyed the planet may be re-colonized.

==== Initiating Colonization ====
Move your Colony Ship onto the Planet and Colonize it. Your crew will dismantle the Colony Ship to start your new Colony. Your Colonies grow during future Economic Phases, from 1 CP, to 3 CP, to 5 CP maximum.

==== Colonizing Barren Planets ====
You may encounter Barren (monochrome colored) planets while scouting. If you have developed Terra-forming Technology you can Colonize it just like a habitable planet. Once Colonized, it performs just like any other planet. If the Colony is destroyed, however, it will revert to a Barren Planet.

== Combat ==
The Combat Phase occurs whenever two enemy units occupy the same System (hex). The player that moved into the occupied System is the Attacker. If there is more than one battle, the Attacker will choose the order. During Combat both attacker and defender will fire, often multiple times, until only one player remains in the System. Combat may last any number of rounds.

=== Combat Procedure ===
The Combat Phase window appears with opposing ships organized along battles lines and Class level (A through E). Any Decoy units are destroyed at start of Combat.

==== Combat Screening ====
A player with a greater number of Combat capable ships than their opponent may optionally choose to Screen ships from Combat (up to the difference in ship count). Screened ships may not fire or be fired upon for that Combat round and they may Retreat on their turn. Screened ships can be changed each Combat round. Non-combat ships are automatically Screened.

==== Fleet Size Bonus ====
At the start of each Combat round, if your fleet is twice as large as your opponent, your firing units receive +1 Attack bonus. Mines do not count towards Fleet Size.

==== Resolve Combat ====
Starting with your A Class units, and proceeding down through every Class, each ship has the opportunity to fire one time. A ship can be a target more than once. After the first round of Combat any firing unit may instead choose to Retreat.

=== Firing Order ===
Combat is not simultaneous. A Class fires before B, B fires before C, etc. If Combat units have equal Class, the units with higher Tactics technology fire first. If Combat units have equal Class and Tactics, the defender fires first.

If Combat occurs in a System (hex) occupied by Asteroids or Nebulae then all ships are affected and considered Class E no matter what their original Class.

=== Who May Fire ===
A unit (ship) with Attack Strength may fire at any opposing unit unless Screened. Ships in the same Group each fire and may choose unique targets.

=== Non-Combat Units ===
Colony Ships, Mining Ships, and MS Pipelines have no Combat ability and will be destroyed if caught alone or if all other Combat capable units are destroyed or retreat. They may not retreat. Colonies (planets) have no Combat abilities but are not automatically destroyed.

=== Fire Resolution ===
Select your Attacking unit and your target. Your Attack Strength is the sum of your unit's Attack Strength plus its Attack Technology Level. Add a +1 bonus if Fleet Size Bonus is in effect. Your target's Defense is the sum of its Defense Strength plus its Defense Technology Level and this result is subtracted from your Attack Strength to determine your "To Hit" number. A die is rolled for each attacking ship and must be equal or less than the "To Hit" number to succeed. A die roll of 1 will always hit.

=== Recording Hits ===
Damage is cumulative through Combat and once a ship's damage equals its Hull Size, it is destroyed. Ships in a group may only be targeted one at a time. Hits to a ship do not affect abilities or performance in any way.

At the conclusion of Combat, any surviving ships will send their crews into repair mode and all damage will be removed.

=== Special Conditions ===
; Asteroids
: When Combat occurs in a System with Asteroids, all ships are considered Class E and their Attack Technology Level is considered to be zero. Attack Strength is not affected. Fire order depends on Tactics.
; Nebula
: When Combat occurs in a System with a Nebula, all ships are considered Class E and their Defense Technology Level is considered to be zero. Defense Strength is not affected. Fire order depends on Tactics.

=== Retreat ===
After the first round of Combat, any Combat capable ship may instead choose to Retreat to an adjacent System (hex) which is the same distance, or less, from one of its colonies. That System must not contain enemy units or be an unexplored System. If there is no legal retreat System available, Retreat is not possible. Bases and Ship Yards cannot retreat, nor can Colony Ships, Mining Ships, or MS Pipelines as they are too slow.
Be warned that this rule can lead to seemingly counter-intuitive retreats, which are perfectly legal: an enemy fleet CAN retreat towards one of your colonies if that square is at least the same distance from one of the retreating party's colonies. To stop this you may try to surround embattled hexes with weak or even non-military units (such as decoys, miners or scouts) which will prevent enemy forces retreating into their square.
This discussion thread may be helpful: https://boardgamegeek.com/thread/2862734/whats-your-opinion-retreat-rule

=== Colonies and Combat ===
Once all ships in a System have been destroyed or Retreated, you may attack an enemy Colony or Homeworld. Each of your ships may fire once and the Colony cannot fire back (it has no Defense Strength or Defense Technology). The attacking ship's Attack Strength and Attack Technology are used to determine success at firing.

A hit will reduce the Colony one step (ie: 2), so a Colony with 5 CP is reduced to 3 CP, 3 CP is reduced to 1 CP, and 1 CP is destroyed if hit. A newly colonized Planet with a grounded Colony Ship on it also only requires one hit to destroy. The empty Planet may be colonized again in the future. Damaged Colonies function normally and will grow again in the next Economic Phase.

A hit will reduce a Homeworld one step (ie: 5), so a Homeworld with 20 CP is reduced to 15 CP, 15 CP is reduced to 10 CP, 10 CP to 5 CP, and 5 CP is destroyed if hit.

=== Post Combat ===
Ships revealed in Combat will stay face-up and can be examined by other players until they return to one of their Colonies where they can flip face-down again.

== Exploration ==
At the start of the game all Systems (hexes) are unexplored, except for the players' Homeworlds. If a unit (ship) lands on an unexplored space it '''must''' explore that system and apply any effects immediately.

=== Planets, Nebulae, Asteroids ===
* Planets: Can be Colonized
* Nebulae & Asteroids: Affect Movement and Combat

=== Minerals ===
Mineral counters represent valuable resources. They do not affect Movement or Combat and cannot be voluntarily destroyed. Minerals can be towed away to one of your Colonies or your Homeworld by a Mining ship. Each Mining Ship can tow one Mineral counter. There is no cost to pick up or deposit Minerals. You may deposit more than one Mineral per Colony/Homeworld. During the Economic Phase they generate the amount of CP printed on the counter.

If a Mining Ship is destroyed while towing a Mineral, the Mineral is also destroyed. If a Colony with Minerals is destroyed before the Economic Phase, the Mineral is also destroyed.

=== Black Holes ===
Discovery of a Black Hole in a hex requires units to stop and make a roll to determine survival. Each unit must roll so observant enemies will see how many ships entered the System. A roll of 1-6 and the unit survives, 7-10 means the unit is destroyed. Surviving units may continue any remaining Movement. Black Holes remain for the entire game.

=== Danger! ===
Space is full of danger. When this counter is discovered, all units there are destroyed. The hex remains empty in the future.

=== Super Nova ===
Super Novas dominate an entire sector. If a unit moving into a hex discovered a Super Nova, they must return to the hex they came from. Units may not move or retreat into a Super Nova. Super Novas remain for the entire game.

=== Lost in Space ===
When this counter is discovered by your unit(s), the player to your right shifts your unit(s) 1 hex in any direction. If that hex contains an unexplored system it must be explored. If it contains an enemy you must enter Combat. After leaving the Lost in Space hex, the counter is removed and the hex remains empty for the rest of the game.

=== Space Wreck ===
A Space Wreck can be picked up and deposited just like a Mineral. It will provide a free Technology upgrade instead of CP. To determine which Technology, roll a die and consult the list:
* 1-2: Ship Size upgrade
* 3-4: Attack upgrade
* 5-6: Defense upgrade
* 7: Tactics upgrade
* 8-9: Move upgrade
*10: Ship Yard upgrade
If the Technology Level is already at maximum the free upgrade is wasted.

== Economic Phase ==
During the Economic Phase you will see the amount of CP (Colonization Points) generated by your Homeworld/Colonies* and any Minerals you have deposited. You will also have a negative number, which is the cost to keep your fleet Maintained and is equal to your collective Hull Sizes (see below). You may also optionally bid any number of CP to win the choice of player order for the next 3 turns. If nobody bids or there is a tie, the current first player retains the position in first. The remaining CP balance can be spent on Technology Level upgrades and/or you can click on any of your Colonized Planets or Homeworld to see which ship units can be built there. Unspent CP can be carried forward to the next Economic Phase but never more than 30 CP.

''* Colonies occupied by an enemy unit with Attack Strength are in '''Blockade''' and do not generate CP or Mineral income (they can still Grow, however).''

=== Maintenance Costs ===
Each ship's Hull Size is equal to its maintenance cost. Bases, Colonies, Colony Ships, Ship Yards, and Mining Ships do not have a Maintenance Cost.

=== Purchase Units and Technology ===
Costs for Units and Technology are printed on the Ship Technology Chart and Research Chart. At the start of the game you may only build Scouts, Mining Ships, Colony Ships, Ship Yards, and Decoys. You may build other ships when you advance your Technology Levels.

==== Ship Technology Level ====
Building a new unit (Ship) automatically builds it at your current Technology Level. You can purchase a Technology Level and a spaceship in the same Economic Phase and it will have the latest tech. Ships already in play, however, are not automatically upgraded (unless playing with Basic Rules options that provide Instant Upgrades).

===== Purchase Limits =====
You may not build ships if all counters of that ship type are already in play (unless you Scuttle ships to reuse the counter).

== Technology ==
Besides ships, you can spend your CPs on Technology Level upgrades. Refer to the Research Chart for each level's cost. Each Technology must be purchased in level order (no skipping over levels) and only one level of each tech may be purchased per Economic Phase.

=== Attack and Defense Technology ===
Improve your unit Combat abilities with these two techs. Note that your unit Hull Size limits your Attack and Defense levels to the same amount, never more. This is the only limit on technologies.

=== Tactics Technology ===
Units/Groups that have a higher Tactics level will fire first in Combat.

=== Ship Size Technology ===
In order to build larger and more powerful ships, you need to increase your Ship Size technology. You may use this new tech in the same Economic Turn it was purchased.

=== Movement Technology ===
This dictates how fast (far) your ship may move.

=== Ship Yard Technology ===
You start with a Ship Yard capable of building ships with a Hull Size of 1. Level 2 grants 1.5 Hull Size and Level 3 grants 2 Hull Size ships. Combine multiple Ship Yards on a Colony to build even larger ships.

=== Terraforming Technology ===
Once purchased, your Colony Ships can Terraform Barren Planets. Colony Ships built prior to upgrade do not have Terraform.

=== Exploration Technology ===
This tech provides your Cruiser Ships with advanced sensors which allow you to peek at ''one'' adjacent unexplored (face down) counter prior to moving. Once seen, you choose to reveal or leave it face down. If revealed and the counter has any immediate effect, it is discarded and any negative effects do not affect your Cruiser.

''NOTE: This means that a Cruiser equipped with Exploration Technology can explore 2 hexes each turn (one with its Exploration Technology and one by moving into the hex).''

== Playing Pieces ==

=== System Markers ===
Your Home System will contain randomly-placed face-down square counters. Each player's color (red, blue, green, or yellow) will show as an outline on the square counters within their System. The white-outlined counters between players' Systems are "Deep Space" territory.

=== Homeworld ===
Each player has one Homeworld, representing their starting planet/solar system from which they explore the galaxy. Each Homeworld produces 20 CPs (Construction Points). If your Homeworld is defeated by an enemy, you lose the game.

=== Planets ===
Planets have no function until Colonized. Some planets are Barren and cannot be Colonized until Terra-formed. Habitable planets have a color matching the player Home System.

=== Colony ===
A Planet that has been Colonized. Once populated, a Colony can grow from 1 CP, to 3 CP, to the maximum of 5 CP.

=== Group ===
Your spaceships of the same type and Technology Level. Each spaceship Group can contain 1-6 units, which is hidden from the enemy until engaged in Combat. The backside of the counter only displays a ship, while the front contains all the details, including: Type, Class, Attack Strength, Defense Strength, Hull Size, and Group Number.

Miners, Colony Ships, and MS Pipelines* are always single ships.

==== Type ====
The upper left corner contains the ship type followed by the group ID number.
* BB: Battleships
* BC: Battle Cruisers
* CA: Cruisers
* CV: Carriers*
* DD: Destroyers
* DN: Dreadnaughts
* F: Fighters*
* R: Raiders*
* SC: Scouts
* SW: Minesweepers*
* SY: Ship Yards
''* denotes Advanced Rules ship types''

==== Class ====
This letter determines which ship fires first in Combat (A goes before B).

==== Attack Strength - Defense Strength ====
The lower left corner contains two numbers with a dash between them. The first is your Attack Strength, which is the number you need to score a hit (a 4 means you must roll a 4 or less). The second number is your Defense Strength, which modifies the attacker's die roll, making it harder to hit your ship(s).

==== Hull Size ====
The number in the lower right with an "x" is your unit Hull Size and indicates how many hits a ship in the group can take before being destroyed. Hull Size also determines the maintenance cost of the ship, the amount of technology that a ship can utilize, and the construction capacity needed to build a ship at a Ship Yard.

=== Special Unit Types ===

==== Bases ====
A Base is a defensive unit designed to protect a Colony. Only 1 base may be built per incoming-producing Colony (ie: not a brand new Colony) and it cannot move or retreat. A Base does not require a Ship Yard to be built. Does not have a maintenance cost.

==== Ship Yards ====
Ship Yards can only be built on an income-producing Colony, one per Planet. Additional Ship Yards (needed to increase Hull Size production) may be built in future Economic Phases. As Ship Yards are placed along side other units, they cannot produce new Units in the same Phase as their placement. Does not have a maintenance cost. Decoys, Bases, and Ship Yards to not require a Ship Yard to be built.

==== Decoys ====
Decoys are unarmed, expendable ships that look just like larger ships or Groups to your opponents. Decoys do not explore, attack, or defend. They always move at the speed of your current Movement Technology Level. Decoys are revealed and destroyed if encountered alone by the enemy (enemy does not reveal themselves). If a Decoy is part of a friendly Group in Combat, it will be destroyed at start of Combat. Does not have a maintenance cost.

==== Colony Ships ====
Colony Ships always represent a single ship, always stay face-up, and always move just 1 hex per turn. They flip to their Colony side once they Colonize a Planet.

==== Mining Ships ====
Mining Ships always represent a single ship, always stay face-up, and always move just 1 hex per turn. They are used to tow a Mineral or a Space Wreck counter back to one of your Colonies. Does not have a maintenance cost.

== Glossary ==
* Construction Point (CP): Your Homeworld and your Colonies (planets) produce Construction Points, which are used in the Economic Phase to purchase units, maintain your fleet, and develop technologies.
* Enemy: Any other player's unit(s)
* Group: A counter (token) that represents 1-6 spaceships of the same type. A group can be a single ship as group size is usually hidden from the enemy.
* Home System: The group of hexes where your Home System and Homeworld markers are placed.
* System: A single hex on the board.
* Unit: A Group, Decoy, Miner, Colony Ship, Base, Ship Yard, or MS Pipeline.

Gamehelpgaiaproject

2022-07-06T23:22:39Z

Kayvon:

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Actions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits bids for every faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction.

A typical auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction he wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelpgaiaproject

2022-07-05T19:04:08Z

Kayvon: /* Auctions */ spelling

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Actions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits bids for every faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction.

A typical auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction he wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy not undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelpgaiaproject

2022-07-05T19:03:42Z

Kayvon: Added FAQ

== Factions ==
{| class="wikitable"
|- style="font-weight:bold; vertical-align:bottom;"
! '''Faction'''
! '''Planet Type'''
! '''Ability'''
! '''Planetary Institute'''
! '''Starting Research'''
! '''Basic Income'''
|-
| style="vertical-align:bottom;" | Terrans
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, move the power tokens in your Gaia area to area II of your power cycle instead of to area I.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, when you move power tokens from your Gaia area to area II of your power cycle, you may gain resources as if you were spending that much power to take free actions.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Lantids
| style="vertical-align:bottom;" | Terra
| style="background-color:rgba(255, 255, 255, 0.85);" | When you take the “Build a Mine” action, you may build a mine on a planet colonized by an opponent (including the Lost Planet). Place your mine next to the opponent’s structure. You do not have to pay for terraforming, but you must still pay the mine’s cost. This mine counts as a normal mine in all ways except the following: this mine cannot be upgraded, and it does not count for any effects that relate to how many planet types or Gaia planets you have colonized.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you build a mine on a planet colonized by an opponent, gain two knowledge.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Xenos
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | You place a third starting mine after all other starting mines have been placed.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can form federations with a total power value of six instead of seven. You gain one Q.I.C. as income instead of one power token.
| style="vertical-align:bottom;" | Artificial Intelligence
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Gleens
| style="vertical-align:bottom;" | Desert
| style="background-color:rgba(255, 255, 255, 0.85);" | If you would ever gain Q.I.C., gain that much ore instead; once you have upgraded to the indicated academy, this effect no longer applies. To make a Gaia Planet habitable, pay one ore instead of one Q.I.C. Each time you build a mine on a Gaia Planet, gain two additional VP.
| style="background-color:rgba(255, 255, 255, 0.85);" | When you upgrade to the planetary institute, immediately gain the Gleens’ federation token (gaining the resources shown as normal). Gaining this tile counts as forming a federation. The planetary institute itself can still be part of a federation on the board.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Taklons
| style="vertical-align:bottom;" | Swamp
| style="background-color:rgba(255, 255, 255, 0.85);" | The Brainstone counts as one power token (when starting a Gaia Project, building satellites, etc.), but you can spend it as if it were three power.
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you would charge power from “Passive Action: Charge Power,” you gain one power token. You can choose to gain the power before or after charging.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Ambas
| style="vertical-align:bottom;" | Swamp
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | Once per round, as an action, you can swap your planetary institute with one of your mines on the game board (this can help you form a new federation). This has no impact on existing federations, even if their power value becomes less than seven. The swap does not count as a build or upgrade action; no VP or power can be gained from it.
| style="vertical-align:bottom;" | Navigation
| style="vertical-align:bottom;" | 1 Knowledge, 2 Ore
|-
| style="vertical-align:bottom;" | Hadsch Hallas
| style="vertical-align:bottom;" | Oxide
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend credits instead of power to take free actions that allow you to gain resources. Example: You can spend 3 credits to take the free action that allows you to gain one ore.
| style="vertical-align:bottom;" | Economy
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 3 Credits
|-
| style="vertical-align:bottom;" | Ivits
| style="vertical-align:bottom;" | Oxide
| style="background-color:rgba(255, 255, 255, 0.85);" | During setup, do not place mines. Instead, after all other players have placed mines (including the Xenos’ third mine), place your planetary institute on any red planet. You can only have one federation, but each time the power value of your federation becomes a multiple of 7, you may take the "Form A Federation" action again. You must discard Q.I.C. instead of power tokens to make satellites.
| style="background-color:rgba(255, 255, 255, 0.85);" | As a special action, place a space station on an accessible space that does not contain a planet or another space station. The accessibility of a space follows the same rules as the “Build a Mine” action.
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 QIC
|-
| style="vertical-align:bottom;" | Geodens
| style="vertical-align:bottom;" | Volcanic
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | The first time you build a mine on each planet type, gain 3 knowledge. (You do not gain knowledge for planet types you colonized before upgrading to your planetary institute.)
| style="vertical-align:bottom;" | Terraforming
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bal T'aks
| style="vertical-align:bottom;" | Volcanic
| style="background-color:rgba(255, 255, 255, 0.85);" | You cannot advance in the “Navigation” research area, even if you take the tech tile below the “Navigation” research area. If you do take that tech tile, no advancement occurs. As a free action, you can move a Gaiaformer from a Gaiaformer space on your faction board to your Gaia area to gain one Q.I.C. Gaiaformers in your Gaia area are not available until the next Gaia phase. In the next Gaia phase, move any Gaiaformer in your Gaia area back to its Gaiaformer space.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can now advance in the “Navigation” research area.
| style="vertical-align:bottom;" | Gaia Project
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Firaks
| style="vertical-align:bottom;" | Titanium
| style="vertical-align:bottom;" | NA
| style="background-color:rgba(255, 255, 255, 0.85);" | As an action, you can “downgrade” a research lab into a trading station and immediately advance one level in a research area of your choice. Advancing in a research area is explained on page 15. This counts as an “Upgrade to a Trading Station” action. You can later upgrade the trading station back into a research lab using the normal rules (including gaining a new tech tile).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 2 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Bescods
| style="vertical-align:bottom;" | Titanium
| style="background-color:rgba(255, 255, 255, 0.85);" | The positions of your planetary institute and academies are swapped on your faction board, as is the income you gain for trading stations and research labs. As with the other factions, upgrading to an academy or a research lab allows you to gain a tech tile. Once per round, as an action, you can advance your lowest-level token in a research area (without paying knowledge). If multiple of your tokens are tied for the lowest level, choose which of the tied tokens to advance. To advance to level 5 this way, you must still flip a federation token as normal. Remember, only one player can reach level 5 of each research area.
| style="background-color:rgba(255, 255, 255, 0.85);" | The power value of your structures on gray planets (your home type) is increased by one (in addition to any other effects that increase their power value).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Ore
|-
| style="vertical-align:bottom;" | Nevlas
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | As a free action, you can move one power token from area III of your power cycle to your Gaia area to gain one knowledge (these power tokens follow the normal Gaia phase rules). This does not count as spending power.
| style="background-color:rgba(255, 255, 255, 0.85);" | You can spend power tokens in area III of your power cycle as if they were each two power. Otherwise, they count as one power token (when starting a Gaia Project, building satellites, etc.). When paying for a power action with an odd power cost (1, 3, 5, etc.), the unspent power is lost.
| style="vertical-align:bottom;" | Science
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore
|-
| style="vertical-align:bottom;" | Itars
| style="vertical-align:bottom;" | Ice
| style="background-color:rgba(255, 255, 255, 0.85);" | Each time you discard a power token from area II of your power cycle to move another power token to area III, place the discarded power token in your Gaia area instead of returning it to the supply.
| style="background-color:rgba(255, 255, 255, 0.85);" | During the Gaia phase, you can discard 4 power tokens from your Gaia area to immediately gain a tech tile (standard or advanced).
| style="vertical-align:bottom;" | NA
| style="vertical-align:bottom;" | 1 Knowledge, 1 Ore, 1 Power in Bowl I
|}

== Rules to Remember ==
* Starting Resources (before receiving income at the beginning of Round 1) - Credits: 15, Ore: 4, Knowledge: 3
* Resource Storage Limits - Credits: 30, Ore: 15, Knowledge: 15

==Auctions==
# '''Build a Mine''' - This places a mine on the board, which usually give you ore as income. These mines must be at most a distance away from another building of yours equal to your navigation (the second track from the left). You must pay the cost of the mine. If it's a Gaia planet (green planets without gaiaformers on them), you must also pay one QIC. If it's some other planet type, you must pay additional ore - the exact cost is determined by your terraforming ability (the first track from the left) and the number of terraforming steps required to make the destination planet habitable for your faction.
# '''Start a Gaia Project''' - This allows you to transform Transdim planets (purple) into a Gaia planet. You can only do this if you have at least one available gaiaformer, which you can get as a result of the Gaia Project track (the fourth track from the left). To do this, move power tokens into the gaia section of your board. These tokens are not lost - you'll get them back as the last step of the income phase. At the start of the next round, these planets are now Gaia planets and you can build mines on them normally (without spending a QIC like you normally would to build on a Gaia Planet). The gaiaformer is removed (and sent to your faction board) only after you decide to build on these planets (they are "reserved" for you until then).
# '''Upgrade Existing Structure''' - Mines can be upgraded to Trading Stations, which usually produce credits - note that this has a cheaper cost if it's at most two units away from an opponent's structure. Trade Centers can be upgraded to either a Planetary Institute (which produces power and unlocks an ability specific to your faction) or Research Labs, which produce knowledge and allows you to immediately take a technology tile and advance on one of the tracks (if able, depending on your current position in the track). Research Labs can be upgraded to Academies, which also let you gain more technologies and produce either knowledge or QIC (or other resources depending on the faction).
# '''Form a Federation''' - This allows you to combine structures to gain more points. To do this, you need any cluster of structures whose total power level is 7 or more. This can include empty space as well, but for each empty space included this way, pay 1 power token from any bowl to create a satellite. For doing this, you gain a federation token, which gives you immediate points, some other resource bonus, and can later be spent to advance to the top position of a research track or gain advanced technology tiles.
# '''Research Progress''' - Spend 4 knowledge to advance on any track. The tracks are
##Terraforming, which improves your ability to terraform planets
##Navigation, which increases the range at which you can build structures
##Artificial Intelligence, which gives you more QIC
##Gaia Project, which allows you to start Gaia Projects on Transdim planets
##Economy, which increase your ore, credits, power charge income
##Science, which increases your knowledge income.
# '''Power and Q.I.C. Actions''' - Spend power or QICs to take any of the actions at the bottom of the research board. Each of these can be taken only once per round.
# '''Special Actions''' - Use any actions printed on booster tiles or your faction board. These can be taken only once per round.
# '''Pass''' - Select a new booster tile. Wait until all other players have passed too.
# '''Free Actions''' - Resource Conversions (or burn power to move power from Bowl 2 to Bowl 3).
# '''Passive Action''' - Charging power. Spend VP as necessary depending on the amount of power being charged. This is optional.

== Auctions for Drafting Factions ==

Each player submits bids for every faction that has been drafted. Once all bids are submitted, a round-robin auction is automatically conducted in turn order until each player has the top bid on one faction.

A typical auction might look like this behind the scenes.

1) The first player bids zero VP on the faction that has his highest maximum bid (i.e. the faction he wanted most)

2) If the second player submitted the same top bid for two different factions, he'll automatically bid zero on the faction no one has picked yet. If he had placed a higher bid on the same faction as player 1, he would have increased that bid to one VP instead.

3) The third player looks at the current bids and compares those to his maximum bid. He'll automatically bid one higher on the faction with the greatest difference between his maximum bid and the current bid of that faction.

This is all resolved quickly and automatically behind the scenes. It's not uncommon for players to get factions for free if no one outbids them.

After the auction, all players are given VP so that the player that paid the most still starts with 10 VP to use during the game.

== FAQ: General ==
Q: The booster tile is covering the conversions pane!

A: Check the preferences for other options for the booster tile.

Q: On iOS/Mac, the game is unresponsive.

A: The rendering engine on Apple devices deals very poorly with shadows. You'll get much better performance by setting the "Structure outlines" user preference to "No outlines." This is true regardless of which browser you're using.

Q: The game isn't allowing me to gain an advanced tech!

Q: The game isn't allowing me to advance to level 5 in a research track!

A: Both of these require a green federation tile. If you want to do both in a single action, you need two federation tiles.

Q: Why can't I upgrade?

A: This is usually because you lack the resources required to perform any available upgrades. Occasionally, it's because you lack the structures (because they are already on the board).

Q: Is there an option to undo my entire turn?

A: The game asks you to confirm or cancel after selecting a planet for a build/upgrade action, selecting planets for a federation, selecting a research track, passing, and so on. However, the developers have decided not to add an option to [https://boardgamearena.com/doc/BGA_Undo_policy not undo your entire turn].

== FAQ: Conversions/Power ==
Q: Why do I only get one credit when I convert the Brainstone to credits?

A: If you want to get more than one credit, click on that button more than one time. The game does not do this automatically in order to allow you to allocate the spent power as desired.

Q: Why don't I get a chance to convert resources at the end of my turn?

Q: I should get the option to charge before or after gaining power!

A: There are options in the pull-down menu to the right to enable this under various conditions. By default, options are selected that improve the speed of the game.

Q: I have enough power to perform a power action, but it doesn't show up as available!

A: There are two possible reasons:
- You're lacking something else that would be required to perform that action. For example, if you don't have a mine and enough resources to build a mine, the terraforming actions won't show as available.
- Someone else has taken that action this round.

== FAQ: Federations ==

Q: Why can't I form this federation?

A: The federation rules are surprisingly intricate given the amount of space they occupy in the rulebook. See boardgamegeek.com/thread/2120375/official-federation-faq for more details.

Xenos: note that 7 power is required if you have not built your PI.

Bescods: note that power is only increased on titanium planets, and only after you have built your PI.

Ivits: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

IMPORTANT: All bug reports regarding federations require the move number of the action and a screenshot showing which hexes are selected. Without these, it's nearly impossible to piece together exactly what's happening and when.

== FAQ: Faction-specific ==

Q: As Hadsch Hallas, how do I use my PI ability?

A: Once you've built your PI, the new conversion options will be available under the Convert menu.

Q: My faction's ability isn't working!

A: Make sure you're not confusing your passive ability with the ability granted by your Planetary Institute. If it's the PI ability, you'll need to have built your PI.

Q: As Nevlas, what happens to the remaining half a power when I convert?

A: Any "half power" not used is lost. Make sure you select all desired conversions before clicking confirm.

Q: How do I form a second federation as Ivits?

A: Your existing federation starts out pre-selected. Your second federation must connect to your existing federation. Don't forget that Ivits spend QICs for satellites!

Gamehelpgaiaproject

2022-07-04T20:19:08Z

Kayvon: /* Auctions for Drafting Factions */

Gamehelpgaiaproject

2022-07-04T15:00:57Z

Kayvon: /* Actions */

Gamehelpgaiaproject

2022-07-02T20:46:59Z

Kayvon: /* Undoing your turn */

Gamehelpgaiaproject

2022-07-02T20:07:13Z

Kayvon: Added auction description

Gamehelpgaiaproject

2022-07-02T19:53:35Z

Kayvon: Re-prioritizing to place rules before advice

Troubleshooting

2022-05-30T16:37:48Z

Kayvon: /* Undefined offset: 0 in table/table.game.php on line 1417 */

Describing common errors which is hard to understand and debug

__TOC__

== Game does not start at all ==

=== Undefined offset: 0 in table/table.game.php on line 1417 ===

Do not call self::getActivePlayerName() during setupNewGame()

Ensure you're calling $this->gamestate->changeActivePlayer() at the end of your game setup. You must always have at least one active player.

=== Unexpected error: Wrong formatted data from BGA gameserver 1 (method: createGame): ... ===

This is generic message usually followed by exact position in your source code, and usually its syntax error in one of yours php script

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Not logged ===

Calling self::getCurrentPlayerId () or using $g_user from 'args' state function, see also below

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Unknow player statistic: ===

Calling self::incStat() with second parameter which is an empty string

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Error while processing SQL request: INSERT INTO stats ... ===

Fatal error during yourgame setup: Error while processing SQL request: INSERT INTO stats (stats_type, stats_player_id, stats_value) VALUES ('10','2300663','0'),('10','2300662','0')
Duplicate entry '10-2300663' for key 'stats_table_id'

Why? In the stats.inc.php you declared two keys with the same integer "id"

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: BGA main website do not respond ===

Check if other games work; if not, it's a problem with BGA Studio; if so, your game likely reaches an end state immediately. Check your states.inc.php and your transitions.

=== Unexpected error: Propagating error from GS 1 (method: createGame): BGA service error ===

You may have a syntax error in your dbmodel.sql.

Or, you may be calling self::initStat() for a statistic that does not exist. Check the statistic name, and make sure you clicked "Reload statistics configuration" button in the admin console after making changes to stats.inc.php

Or you may not have your states.inc.php set up correctly.

You may have an error in your table.game.php file in setupNewGame (such as <code>$result['x'] = y;</code> when $result is not an array).

=== Unexpected error: Table status of a starting game should be 'setup' ===

This error message appears when you start a one player game using the "Express Start" button.

In normal situation, the game starts just after this message and everything should works normally. In this case, you can just ignore this message.

If the games does not start, it is most probable that there is a syntax error in any of your php code (Check your states.inc.php and X.game.php)

=== Fatal error during creation of database ebd_quoridor_389 Not logged ===

Check that you didn't use $g_user or getCurrentPlayerId() in setupNewGame() function or in an 'args' function of your state.

As these functions are not consequences of a user action, there is no current player defined.

As a general rule, you should use getActivePlayerId() and not getCurrentPlayerId(). See the [http://www.slideshare.net/boardgamearena/bga-studio-focus-on-bga-game-state-machine presentation on the game state machine] for more information.

=== Warning: Invalid argument supplied for foreach() in table.game.php ===

Warning: Invalid argument supplied for foreach() in /var/tournoi/release/tournoi-151226-1240-gs/www/game/module/table/table.game.php on line 129
Fatal error: Cannot unset string offsets in /var/tournoi/release/tournoi-151226-1240-gs/www/game/module/table/table.game.php on line 143

That appears when your arg* function that suppose to return array of state arguments returns a scalar (a non-array) value

=== The server reported an error ===

During table creation: "The server reported an error" error shown and nothing else.

If you cannot even create a table - there is syntax error in gameinfos.php, check it, reload it from management panel.
If still no luck copy clean version from template https://github.com/elaskavaia/bga-sharedcode/blob/master/gameinfos.inc.php

=== Unexpected Error : Invalid player number for this game : 4 ===

This error may comes when trying to change the player number configuration in gameinfos.inc.php from a higher to lower number of players (for example from 4 to 2).

The following steps will help to change a player config from array(4) to array(2) :

* change in gameinfos.inc.php the entry to 'players' => array( 2,3,4 )
* In game management page (Control Panel > Manage Games > "Your Game"), press the "Reload Game information" button
* create a new table
* reduce the number of players to 2 and start the game
* (express) Stop the game
* change in gameinfos.inc.php the entry to 'players' => array( 2 )
* press again the "Reload Game information" button

=== Blank page ===
If you see no html at all check
* if you have syntax error in your view.php file
* class name of your view.php file does not match the project name (should be view_foo_foo if project is foo)
* game name return by getGameName() does not match the project name (should be "foo" if project is foo)

class view_russianrailroads_russianrailroads extends game_view {
function getGameName() {
return "russianrailroads";
}

== Game starts but I can't make a move ==

=== When I do a move, I got "Move recorded, waiting for update ..." forever ===

"Move recorded" means that your ajaxcall request has been sent to the server and returned normally.

"Waiting for update" means that your client interface is waiting for some notifications from the server that correspond to the move we just did.

If this message stays forever, it is probably that your PHP code does not send any notification when the move happens, which is abnormal. To fix this: add a notifyAllPlayers or a notifyPlayer call in your PHP code.

=== When I do a move, I get "Sending move to server..." then nothing and game resets to state before the move ===

Its possible that server code get into infinite loops or thinks too much, in which case it will timeout and will be aborted without any extra logs (and db transaction you saw in the log won't be committed). You will usually see "Unable to connect to server" message on console in this case. You have to put more logging into server
to trace where it hangs.

=== When I do a move, I get "Ajaxcall error: empty answer" ===

You either have missing self::ajaxResponse(); in your [[Players actions: yourgamename.action.php|game.action.php]] method, or there is some problem with getting arguments (check that you are using btoa() on client when using AT_base64 arg type in action.php)

=== Some player action is triggered randomly when I click somewhere on the game area ===

You probably used "dojo.connect" on a null object. In this case, dojo.connect associate the event (ex: "onclick") to the whole game area.

Most of the time it happens in this situation, when my_object element does not exists:
<pre>
dojo.connect( $("my_object"), "onclick", this, (event)=>{})
</pre>

To determine if this is the case, place "alert( $("my_object") )" before the dojo.connect to check if the object exists or not.

=== Error: This is not your turn ===

This happens when checkAction() is called and current player is NOT the active player.

You can change the active player in studio by clicking the red arrow next to their name in the player panel (right side of the page).

[[File:Change_active_player.jpg]]

=== Error: Please wait, an action is already in progress ===
Its followed by error "(Generated by checkAction / XXX)" on studio.

This error is triggered in the JS by the checkAction function for XXX action.

This can happen when the player sent an Ajax request action earlier, and:
* action is not complete yet - i.e. takes some time, and user clicked something again
* if there is bug in interface where MULTIPLE handlers are fired on same click. To debug this add some console.trace() in place this specific checkAction is called.
* did not get any notification from the PHP side. To avoid this, put an empty notifyPlayer in the PHP side of the Ajax handler to ensure the client receives a response. This line of code should do it:
<pre>
$this->notifyPlayer($this->getCurrentPlayerId(), 'message', '', []); // sent to current player, who originated the action
</pre>

=== Error: This move is not authorized now ===
This is generic error message generated by this.showMoveUnauthorized() function. If you did not call this function yourself, check the console log, it may have additional information.
If you see "Move not authorized now : XXX" in the log, where XXX is your action name - this means that action XXX is not defined in list of possible actions for your current state. This error generated by checkAction() function.

=== Error: You are not connected - after waiting for the submitted move ===
In the log you may find:
Query execution was interrupted, maximum statement execution time exceeded - Request: SELECT global_id, global_value FROM global WHERE 1

The error message above is because of failed attempt to lock a table, which happens because of infinite loop in you game.
* Check that don't enter same game state over and over again
* Check that you reverse for loop actually descrease counter or other loop issues
* Check that recursive function ends

== Predefined server errors ==

=== Unexpected error: Unexpected final game state (XX) ===

The action function does not transition to any state, i.e.
function selectField($field) {
self::checkAction ( 'selectField' );
if ($field!=0) $this->gamestate->nextState ( 'next' );
}
Here if $field is 0 there is no transition

=== This game action is impossible right now ===

Check the game log. Usually your state does not define the action you trying to perform in 'possibleactions' array.

Also check your onActionName javascript function. Make sure you are calling the right "actionname.html".

=== Unexpected error: This transition (playerTurn) is impossible at this state (42) ===

This is pretty self explanatory. Function nextState() takes transition name not a state name, so you probably did not
define this transition that the given state

== Game interface hangs during reload or on start ==

Showing "Application Loading..."

=== Javascript error: During pageload undefined no_stack_avail Script: ===

This error usually has no useful data, but it means you called somes API that require a callback and did not define callback function, i.e
in dojo.connect, this.connectClass, dojo.subscribe, etc

this.connectClass('field', 'onclick', 'onField'); // <-- onField is not defined

=== Other errors with "Application loading..." ===

You probably have a syntax error in your Javascript code, and the interface refuses to load.

To find this error, check if there is an error message in the Javascript console (F12).

If there is really nothing on the log, it's probably that the system was unable to load your Javascript because of an syntax error that affect the structure of the Javascript file, typically a missing "}" or a missing "," after a method definition.

If you have "Uncaught ReferenceError: bgagame is not defined" you have major syntax error in your js file, you should see some other clues in the log where the errors is.

If you have "dojo.publish is not defined" or something similar, this could be caused by another error earlier. For example, a syntax error caused by a malformed generated file (such as using newlines in tiebreaker description). Also you might have left some images in the /img directory with special characters in the name which must be removed. If you edited images for the game box and website, ensure that you have not left any unnecessary files there.

=== Unexpected Syntax Error: ===

No further details in the log. When log is filling with some social connect errors.

Possible Reason: Syntax error in of the php script which is loaded before the start, such as gameoptions.inc.php, gameinfos.inc.php and such.

=== Game interface spins in a loop throwing error ===

Errors is something like "Cannot read property 'is_ai' of undefined". Cannot restart the game because cannot access UI to stop.
Likely you get in actplayer state with player id == 0. The only way to fix it is to edit database, globals index == 2 set player id to one of your test dudes
(can copy from row 5 for example).

=== Unable to find table database (1): ebd_yourgame_112222 ===

Its either temporarily server error especially on studio it timeouts sometimes, just try reloading again.
Or check if you have syntax errors in your php game file or sql.

== Type conversion / juggling errors ==

=== On php side I get a number instead of string I expect ===

$num = 3;
$meeple = "meeple_" + $num; // <-- suppose to be "meeple_3"!

When you switch between JS and PHP it easy to type this and not notice the +. Plus sign (+) in php does not mean string concatenation (in javascript does!),
in php + means integer arithmetic. So change + to . (dot)

=== On php side my string comparison does not work ===

if ($color == '4baae2' || $color == '000000') {
}

Apparently you should not be using '==' in php to compare strings! You should use '==='. The (==) operator will typecast the strings
to numbers then do comparison!
Its not very apparent because usually you can get away with it, but not when strings resemble numbers like hex 'colors'.

=== Integer columns in the database are returned as strings ===

This is normal PHP behavior. All fields are returned as string type, regardless of their actual type in the database. This also applies to global variables accessed via getGameStateValue(), since they are stored in a database table.

You can use type-casting to convert them to the correct type after they come out of the database.

$myValueInt = (int)self::getGameStateValue(GLOBAL_ROUND_NUMBER);

or

$myValueInt = self::getGameStateValue(GLOBAL_ROUND_NUMBER) + 0; // adding 0 casts to int

same with direct qdb ueries
$sql = "SELECT my_int_column FROM my_table WHERE my_condition";
$myResult = self::getUniqueValueFromDB($sql); <-- this is a string
$myResultAsInt = (int)$myResult;

https://stackoverflow.com/questions/5323146/mysql-integer-field-is-returned-as-string-in-php

== Zombie mode ==

=== Unexpected error: Propagating error from GS 1 (method: zombie): Not logged ===

You are probably calling getCurrentPlayerId() or getCurrentPlayerName() in your zombieTurn method or any of the methods it uses. Instead, use the $active_player_id provided as parameter to zombieTurn().

If you do not see these commands within "function zombieTurn( $state, $active_player ){}", check all the functions called from zombieTurn, also "function getGameProgression(){}" and all the functions THAT calls.

=== Unexpected error: Can't manage zombie player in this game state ===

The state the game was in at the time the error was generated didn't have "transitions" => array( "zombiePass" => 27 )" in states.inc.php (27 was an arbitrary example, but everything else must be spelled exactly that way.)

To correct this error, either add "zombiePass" => ## to the transitions array or work out why the game is in a state it should not be in.

=== Unexpected error: Wrong formatted data from BGA gameserver 1 (method: zombie): ===

This is almost certainly an undefined value in PHP code. Look for a warning or error message in the game replay log on the right side of the table UI.

=== Unexpected error: BGA gameserver 1 do not respond (method: zombie) (timeout: cluster) ===

You are trying to end the game from a zombie method. This is not allowed. The zombie logic must continue the game as best it can. See [[Main_game_logic:_yourgamename.game.php#Zombie_mode|Zombie mode]] for more info.

=== Game unexpectedly ends when one player becomes zombie ===

There is an error in handling zombie mode, check error log. Example: if the zombie turn is called again, framework detects a infinite loop and cancels the game. On the studio there is a notification called ZombieTurnFailed

== Other errors ==

=== Javascript does not know how to sum two numbers ===

Be careful when you manipulate integers returned by notifications: most of the time, Javascript considers they are Strings and not Integers.

As a result:
<pre>
var i=1;
i += notif.args.increment; // With notif.args.increment='1'
alert( i ); // i=11 instead of 2 !! Javascript concatenate 2 strings !
</pre>

To solve this, you should use the "toint" function:
<pre>
var i=1;
i += toint( notif.args.increment ); // With notif.args.increment='1'
alert( i ); // i=2 :)
</pre>

=== Javascript: do not use substr with negative numbers ===

To get the last characters of a string, use "slice" instead of "substr" which has a bug on IE:
<pre>
var three_last_characters = string.substr( -3 ); // Wrong
var three_last_characters = string.slice( -3 ); // Correct
</pre>

=== Game "spontaneously" transition to a new state without user input ===

Make sure on php side you have no code after $this->gamestate->nextState(...) code.
Because if you do accidentally have code that goes to another state it will cause another state transition without user interaction.

function selectField($field) {
self::checkAction ( 'selectField' );
if ($field!=0) $this->gamestate->nextState ( 'next' );
$this->gamestate->nextState ( 'last' ); // <-- here is missing else, so it will cause double state transition
}

=== Message "Invalid or missing substitution argument for log message: ${actplayer} ... " when entering a state ===

You probably have an args function defined for that state that does '''not''' return an array

=== Server syntax error: Warning: count(): Parameter must be an array or an object that implements Countable in /var/tournoi/release/tournoi-220308-1000-gs/www/game/module/table/gamestate.game.php on line 823 ===

Generally comes with that syntax error : Warning: implode(): Invalid arguments passed in /var/tournoi/release/tournoi-220308-1000-gs/www/game/module/table/gamestate.game.php on line 845

It is most probable that you used setPlayersMultiactive method with id of a single player not included in an array -> you should use : ... setPlayersMultiactive( array($player_id), ...

[[Category:Studio]]

Troubleshooting

2022-05-30T16:37:37Z

Kayvon:

Describing common errors which is hard to understand and debug

__TOC__

== Game does not start at all ==

=== Undefined offset: 0 in table/table.game.php on line 1417 ===

Do not call self::getActivePlayerName() during setupNewGame()
Ensure you're calling $this->gamestate->changeActivePlayer() at the end of your game setup. You must always have at least one active player.

=== Unexpected error: Wrong formatted data from BGA gameserver 1 (method: createGame): ... ===

This is generic message usually followed by exact position in your source code, and usually its syntax error in one of yours php script

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Not logged ===

Calling self::getCurrentPlayerId () or using $g_user from 'args' state function, see also below

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Unknow player statistic: ===

Calling self::incStat() with second parameter which is an empty string

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Error while processing SQL request: INSERT INTO stats ... ===

Fatal error during yourgame setup: Error while processing SQL request: INSERT INTO stats (stats_type, stats_player_id, stats_value) VALUES ('10','2300663','0'),('10','2300662','0')
Duplicate entry '10-2300663' for key 'stats_table_id'

Why? In the stats.inc.php you declared two keys with the same integer "id"

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: BGA main website do not respond ===

Check if other games work; if not, it's a problem with BGA Studio; if so, your game likely reaches an end state immediately. Check your states.inc.php and your transitions.

=== Unexpected error: Propagating error from GS 1 (method: createGame): BGA service error ===

You may have a syntax error in your dbmodel.sql.

Or, you may be calling self::initStat() for a statistic that does not exist. Check the statistic name, and make sure you clicked "Reload statistics configuration" button in the admin console after making changes to stats.inc.php

Or you may not have your states.inc.php set up correctly.

You may have an error in your table.game.php file in setupNewGame (such as <code>$result['x'] = y;</code> when $result is not an array).

=== Unexpected error: Table status of a starting game should be 'setup' ===

This error message appears when you start a one player game using the "Express Start" button.

In normal situation, the game starts just after this message and everything should works normally. In this case, you can just ignore this message.

If the games does not start, it is most probable that there is a syntax error in any of your php code (Check your states.inc.php and X.game.php)

=== Fatal error during creation of database ebd_quoridor_389 Not logged ===

Check that you didn't use $g_user or getCurrentPlayerId() in setupNewGame() function or in an 'args' function of your state.

As these functions are not consequences of a user action, there is no current player defined.

As a general rule, you should use getActivePlayerId() and not getCurrentPlayerId(). See the [http://www.slideshare.net/boardgamearena/bga-studio-focus-on-bga-game-state-machine presentation on the game state machine] for more information.

=== Warning: Invalid argument supplied for foreach() in table.game.php ===

Warning: Invalid argument supplied for foreach() in /var/tournoi/release/tournoi-151226-1240-gs/www/game/module/table/table.game.php on line 129
Fatal error: Cannot unset string offsets in /var/tournoi/release/tournoi-151226-1240-gs/www/game/module/table/table.game.php on line 143

That appears when your arg* function that suppose to return array of state arguments returns a scalar (a non-array) value

=== The server reported an error ===

During table creation: "The server reported an error" error shown and nothing else.

If you cannot even create a table - there is syntax error in gameinfos.php, check it, reload it from management panel.
If still no luck copy clean version from template https://github.com/elaskavaia/bga-sharedcode/blob/master/gameinfos.inc.php

=== Unexpected Error : Invalid player number for this game : 4 ===

This error may comes when trying to change the player number configuration in gameinfos.inc.php from a higher to lower number of players (for example from 4 to 2).

The following steps will help to change a player config from array(4) to array(2) :

* change in gameinfos.inc.php the entry to 'players' => array( 2,3,4 )
* In game management page (Control Panel > Manage Games > "Your Game"), press the "Reload Game information" button
* create a new table
* reduce the number of players to 2 and start the game
* (express) Stop the game
* change in gameinfos.inc.php the entry to 'players' => array( 2 )
* press again the "Reload Game information" button

=== Blank page ===
If you see no html at all check
* if you have syntax error in your view.php file
* class name of your view.php file does not match the project name (should be view_foo_foo if project is foo)
* game name return by getGameName() does not match the project name (should be "foo" if project is foo)

class view_russianrailroads_russianrailroads extends game_view {
function getGameName() {
return "russianrailroads";
}

== Game starts but I can't make a move ==

=== When I do a move, I got "Move recorded, waiting for update ..." forever ===

"Move recorded" means that your ajaxcall request has been sent to the server and returned normally.

"Waiting for update" means that your client interface is waiting for some notifications from the server that correspond to the move we just did.

If this message stays forever, it is probably that your PHP code does not send any notification when the move happens, which is abnormal. To fix this: add a notifyAllPlayers or a notifyPlayer call in your PHP code.

=== When I do a move, I get "Sending move to server..." then nothing and game resets to state before the move ===

Its possible that server code get into infinite loops or thinks too much, in which case it will timeout and will be aborted without any extra logs (and db transaction you saw in the log won't be committed). You will usually see "Unable to connect to server" message on console in this case. You have to put more logging into server
to trace where it hangs.

=== When I do a move, I get "Ajaxcall error: empty answer" ===

You either have missing self::ajaxResponse(); in your [[Players actions: yourgamename.action.php|game.action.php]] method, or there is some problem with getting arguments (check that you are using btoa() on client when using AT_base64 arg type in action.php)

=== Some player action is triggered randomly when I click somewhere on the game area ===

You probably used "dojo.connect" on a null object. In this case, dojo.connect associate the event (ex: "onclick") to the whole game area.

Most of the time it happens in this situation, when my_object element does not exists:
<pre>
dojo.connect( $("my_object"), "onclick", this, (event)=>{})
</pre>

To determine if this is the case, place "alert( $("my_object") )" before the dojo.connect to check if the object exists or not.

=== Error: This is not your turn ===

This happens when checkAction() is called and current player is NOT the active player.

You can change the active player in studio by clicking the red arrow next to their name in the player panel (right side of the page).

[[File:Change_active_player.jpg]]

=== Error: Please wait, an action is already in progress ===
Its followed by error "(Generated by checkAction / XXX)" on studio.

This error is triggered in the JS by the checkAction function for XXX action.

This can happen when the player sent an Ajax request action earlier, and:
* action is not complete yet - i.e. takes some time, and user clicked something again
* if there is bug in interface where MULTIPLE handlers are fired on same click. To debug this add some console.trace() in place this specific checkAction is called.
* did not get any notification from the PHP side. To avoid this, put an empty notifyPlayer in the PHP side of the Ajax handler to ensure the client receives a response. This line of code should do it:
<pre>
$this->notifyPlayer($this->getCurrentPlayerId(), 'message', '', []); // sent to current player, who originated the action
</pre>

=== Error: This move is not authorized now ===
This is generic error message generated by this.showMoveUnauthorized() function. If you did not call this function yourself, check the console log, it may have additional information.
If you see "Move not authorized now : XXX" in the log, where XXX is your action name - this means that action XXX is not defined in list of possible actions for your current state. This error generated by checkAction() function.

=== Error: You are not connected - after waiting for the submitted move ===
In the log you may find:
Query execution was interrupted, maximum statement execution time exceeded - Request: SELECT global_id, global_value FROM global WHERE 1

The error message above is because of failed attempt to lock a table, which happens because of infinite loop in you game.
* Check that don't enter same game state over and over again
* Check that you reverse for loop actually descrease counter or other loop issues
* Check that recursive function ends

== Predefined server errors ==

=== Unexpected error: Unexpected final game state (XX) ===

The action function does not transition to any state, i.e.
function selectField($field) {
self::checkAction ( 'selectField' );
if ($field!=0) $this->gamestate->nextState ( 'next' );
}
Here if $field is 0 there is no transition

=== This game action is impossible right now ===

Check the game log. Usually your state does not define the action you trying to perform in 'possibleactions' array.

Also check your onActionName javascript function. Make sure you are calling the right "actionname.html".

=== Unexpected error: This transition (playerTurn) is impossible at this state (42) ===

This is pretty self explanatory. Function nextState() takes transition name not a state name, so you probably did not
define this transition that the given state

== Game interface hangs during reload or on start ==

Showing "Application Loading..."

=== Javascript error: During pageload undefined no_stack_avail Script: ===

This error usually has no useful data, but it means you called somes API that require a callback and did not define callback function, i.e
in dojo.connect, this.connectClass, dojo.subscribe, etc

this.connectClass('field', 'onclick', 'onField'); // <-- onField is not defined

=== Other errors with "Application loading..." ===

You probably have a syntax error in your Javascript code, and the interface refuses to load.

To find this error, check if there is an error message in the Javascript console (F12).

If there is really nothing on the log, it's probably that the system was unable to load your Javascript because of an syntax error that affect the structure of the Javascript file, typically a missing "}" or a missing "," after a method definition.

If you have "Uncaught ReferenceError: bgagame is not defined" you have major syntax error in your js file, you should see some other clues in the log where the errors is.

If you have "dojo.publish is not defined" or something similar, this could be caused by another error earlier. For example, a syntax error caused by a malformed generated file (such as using newlines in tiebreaker description). Also you might have left some images in the /img directory with special characters in the name which must be removed. If you edited images for the game box and website, ensure that you have not left any unnecessary files there.

=== Unexpected Syntax Error: ===

No further details in the log. When log is filling with some social connect errors.

Possible Reason: Syntax error in of the php script which is loaded before the start, such as gameoptions.inc.php, gameinfos.inc.php and such.

=== Game interface spins in a loop throwing error ===

Errors is something like "Cannot read property 'is_ai' of undefined". Cannot restart the game because cannot access UI to stop.
Likely you get in actplayer state with player id == 0. The only way to fix it is to edit database, globals index == 2 set player id to one of your test dudes
(can copy from row 5 for example).

=== Unable to find table database (1): ebd_yourgame_112222 ===

Its either temporarily server error especially on studio it timeouts sometimes, just try reloading again.
Or check if you have syntax errors in your php game file or sql.

== Type conversion / juggling errors ==

=== On php side I get a number instead of string I expect ===

$num = 3;
$meeple = "meeple_" + $num; // <-- suppose to be "meeple_3"!

When you switch between JS and PHP it easy to type this and not notice the +. Plus sign (+) in php does not mean string concatenation (in javascript does!),
in php + means integer arithmetic. So change + to . (dot)

=== On php side my string comparison does not work ===

if ($color == '4baae2' || $color == '000000') {
}

Apparently you should not be using '==' in php to compare strings! You should use '==='. The (==) operator will typecast the strings
to numbers then do comparison!
Its not very apparent because usually you can get away with it, but not when strings resemble numbers like hex 'colors'.

=== Integer columns in the database are returned as strings ===

This is normal PHP behavior. All fields are returned as string type, regardless of their actual type in the database. This also applies to global variables accessed via getGameStateValue(), since they are stored in a database table.

You can use type-casting to convert them to the correct type after they come out of the database.

$myValueInt = (int)self::getGameStateValue(GLOBAL_ROUND_NUMBER);

or

$myValueInt = self::getGameStateValue(GLOBAL_ROUND_NUMBER) + 0; // adding 0 casts to int

same with direct qdb ueries
$sql = "SELECT my_int_column FROM my_table WHERE my_condition";
$myResult = self::getUniqueValueFromDB($sql); <-- this is a string
$myResultAsInt = (int)$myResult;

https://stackoverflow.com/questions/5323146/mysql-integer-field-is-returned-as-string-in-php

== Zombie mode ==

=== Unexpected error: Propagating error from GS 1 (method: zombie): Not logged ===

You are probably calling getCurrentPlayerId() or getCurrentPlayerName() in your zombieTurn method or any of the methods it uses. Instead, use the $active_player_id provided as parameter to zombieTurn().

If you do not see these commands within "function zombieTurn( $state, $active_player ){}", check all the functions called from zombieTurn, also "function getGameProgression(){}" and all the functions THAT calls.

=== Unexpected error: Can't manage zombie player in this game state ===

The state the game was in at the time the error was generated didn't have "transitions" => array( "zombiePass" => 27 )" in states.inc.php (27 was an arbitrary example, but everything else must be spelled exactly that way.)

To correct this error, either add "zombiePass" => ## to the transitions array or work out why the game is in a state it should not be in.

=== Unexpected error: Wrong formatted data from BGA gameserver 1 (method: zombie): ===

This is almost certainly an undefined value in PHP code. Look for a warning or error message in the game replay log on the right side of the table UI.

=== Unexpected error: BGA gameserver 1 do not respond (method: zombie) (timeout: cluster) ===

You are trying to end the game from a zombie method. This is not allowed. The zombie logic must continue the game as best it can. See [[Main_game_logic:_yourgamename.game.php#Zombie_mode|Zombie mode]] for more info.

=== Game unexpectedly ends when one player becomes zombie ===

There is an error in handling zombie mode, check error log. Example: if the zombie turn is called again, framework detects a infinite loop and cancels the game. On the studio there is a notification called ZombieTurnFailed

== Other errors ==

=== Javascript does not know how to sum two numbers ===

Be careful when you manipulate integers returned by notifications: most of the time, Javascript considers they are Strings and not Integers.

As a result:
<pre>
var i=1;
i += notif.args.increment; // With notif.args.increment='1'
alert( i ); // i=11 instead of 2 !! Javascript concatenate 2 strings !
</pre>

To solve this, you should use the "toint" function:
<pre>
var i=1;
i += toint( notif.args.increment ); // With notif.args.increment='1'
alert( i ); // i=2 :)
</pre>

=== Javascript: do not use substr with negative numbers ===

To get the last characters of a string, use "slice" instead of "substr" which has a bug on IE:
<pre>
var three_last_characters = string.substr( -3 ); // Wrong
var three_last_characters = string.slice( -3 ); // Correct
</pre>

=== Game "spontaneously" transition to a new state without user input ===

Make sure on php side you have no code after $this->gamestate->nextState(...) code.
Because if you do accidentally have code that goes to another state it will cause another state transition without user interaction.

function selectField($field) {
self::checkAction ( 'selectField' );
if ($field!=0) $this->gamestate->nextState ( 'next' );
$this->gamestate->nextState ( 'last' ); // <-- here is missing else, so it will cause double state transition
}

=== Message "Invalid or missing substitution argument for log message: ${actplayer} ... " when entering a state ===

You probably have an args function defined for that state that does '''not''' return an array

=== Server syntax error: Warning: count(): Parameter must be an array or an object that implements Countable in /var/tournoi/release/tournoi-220308-1000-gs/www/game/module/table/gamestate.game.php on line 823 ===

Generally comes with that syntax error : Warning: implode(): Invalid arguments passed in /var/tournoi/release/tournoi-220308-1000-gs/www/game/module/table/gamestate.game.php on line 845

It is most probable that you used setPlayersMultiactive method with id of a single player not included in an array -> you should use : ... setPlayersMultiactive( array($player_id), ...

[[Category:Studio]]

Your game state machine: states.inc.php

2022-01-05T19:31:09Z

Kayvon: /* Private parallel states */ "useful" has only one 'l'

{{Studio_Framework_Navigation}}

This file describes the state machine of your game (all the game states properties, and the transitions to get from one state to another).

Important: to understand the game state machine, it's recommended that you read this presentation first:

[http://www.slideshare.net/boardgamearena/bga-studio-focus-on-bga-game-state-machine Focus on BGA game state machine]

== Overall structure ==

The machine states are described by a PHP associative array.

Example:

<pre>
$machinestates = array(

// The initial state. Please do not modify.
1 => array(
"name" => "gameSetup",
"description" => clienttranslate("Game setup"),
"type" => "manager",
"action" => "stGameSetup",
"transitions" => array( "" => 2 )
),

// Note: ID=2 => your first state

2 => array(
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must play a card or pass'),
"descriptionmyturn" => clienttranslate('${you} must play a card or pass'),
"type" => "activeplayer",
"possibleactions" => array( "playCard", "pass" ),
"transitions" => array( "playCard" => 2, "pass" => 2 )
),
</pre>

== Syntax ==

=== id ===

The keys determine game state IDs (in the example above: 1 and 2).

IDs must be positive integers.

ID=1 is reserved for the first game state and should not be used (and you must not modify it).

ID=99 is reserved for the last game state (end of the game) (and you must not modify it).

Note: you may use any ID, even an ID greater than 100. But you cannot use 1 or 99.

Note²: You must not use the same ID twice.

Note³: When a game is in prod and you change the ID of a state, all active games (including many turn based) will behave unpredictably.

=== name ===

('''Mandatory''')

The name of a game state is used to identify it in your game logic.

Several game states can share the same name; however, this is not recommended.

Warning! Do not put spaces in the name. This could cause unexpected problems in some cases.

PHP example:
<pre>

// Get current game state
$state = $this->gamestate->state();
if( $state['name'] == 'myGameState' )
{
...
}

</pre>

JS example:
<pre>
onEnteringState: function( stateName, args )
{
console.log( 'Entering state: '+stateName );

switch( stateName )
case 'myGameState':

// Do some stuff at the beginning at this game state
....

break;
</pre>

=== type ===

('''Mandatory''')

You can use 3 types of game states:
* activeplayer (1 player is active and must play.)
* multipleactiveplayer (1..N players can be active and must play.)
* private (during multiactive states players can independently move to different private parallel states. See more details [[#Private_parallel_states|here]].
* game (No player is active. This is a transitional state to do something automatic specified by the game rules.)

'''Note:''' Make sure you don't mistype the value of this attribute. If you do (e.g. 'multiactiveplayer' instead of 'multipleactiveplayer'), things won't work, and you might have a hard time figuring out why.

=== description ===

('''Mandatory''')

The description is the string that is displayed in the main action bar (top of the screen) when the state is active.

When a string is specified as a description, you must use "clienttranslate" in order for the string to be translated on the client side:

<pre>
"description" => clienttranslate('${actplayer} must play a card or pass'),
</pre>

In the description string, you can use ${actplayer} to refer to the active player.

You can also use custom arguments in your description. These custom arguments correspond to values returned by your "args" PHP method (see below "args" field).

Example of custom field:
<pre>

In states.inc.php:
"description" => clienttranslate('${actplayer} must choose ${nbr} identical energies'),
"args" => "argMyArgumentMethod"

In mygame.game.php:
function argMyArgumentMethod()
{
return array(
'nbr' => 2 // In this case ${nbr} in the description will be replaced by "2"
);
}
</pre>

Note: You may specify an empty string ("") here if it never happens that the game remains in this state (i.e., if this state immediately jumps to another state when activated).

Note²: Usually, you specify a string for "activeplayer" and "multipleactiveplayer" game states, and you specify an empty string for "game" game states. BUT, if you are using synchronous notifications, the client can remain on a "game" type game state for a few seconds, and in this case it may be useful to display a description in the status bar while in this state.

=== descriptionmyturn ===

('''Mandatory''' when the state type is "activeplayer" or "multipleactiveplayer")

"descriptionmyturn" has exactly the same role and properties as "description", except that this value is displayed to the current active player - or to all active players in case of a multipleactiveplayer game state.

In general, we have this situation:

<pre>
"description" => clienttranslate('${actplayer} can take some actions'),
"descriptionmyturn" => clienttranslate('${you} can take some actions'),
</pre>

Note: you can use ${you} in descriptionmyturn so the description will display "You" instead of the name of the player.

Note 2: you can use ${otherplayer} to refer to some other player if you want this to be shown in player's color, but you must provide otherplayer_id as argument (along with otherplayer) to specify this player's id in this case or game won't load.

I.e.

"descriptionmyturn" => clienttranslate('${you} can follow action of ${otherplayer}'),

And this will have to be state arguments for this
<pre>
function arg_playerTurnFollow(){
return ['otherplayer'=> $this->getLeaderPlayerName(),
'otherplayer_id'=> $this->getLeaderPlayerId()
];
}
</pre>

=== action ===

('''Mandatory''' when the state type is "game.")

"action" specifies a PHP method to call when entering this game state.

Example:
In states.inc.php:
<pre>
28 => array(
"name" => "gameTurnNextPlayer",
"description" => clienttranslate('Updating some stuff...'),
"type" => "game",
"action" => "st_gameTurnNextPlayer",
</pre>
In mygame.game.php:
<pre>
function st_gameTurnNextPlayer() {
$player_id = $this->getActivePlayerId();
$next_player_id = $this->getPlayerAfter($player_id);
$this->giveExtraTime($next_player_id);
$this->incStat(1, 'turns_number', $next_player_id);
$this->incStat(1, 'turns_number');
$this->gamestate->changeActivePlayer($next_player_id);
$this->gamestate->nextState('next');
}
</pre>

Usually, for a "game" state type, the action method is used to perform automatic functions specified by the rules (for example: check victory conditions, deal cards for a new round, go to the next player, etc.) and then jump to another game state.

Note: a BGA convention specifies that PHP methods called with "action" are prefixed by "st".

Note: this field CAN be used for player states to set something up; e.g., for multiplayer states, it can make all players active.

Example for action in player state:
in states.inc.php:
<pre>
2 => array(
"name" => "playerTurnPlace",
"description" => clienttranslate('Other player must place ships'),
"descriptionmyturn" => clienttranslate('${you} must place ships (click on YOUR SHIPS board to place)'),
"type" => "multipleactiveplayer",
'action' => 'st_MultiPlayerInit',
'args' => 'arg_playerTurnPlace',
"possibleactions" => array( "playPlace" ),
"transitions" => array( "next" => 4, "last" => 99)
),
</pre>
in mygame.game.php:
<pre>
function st_MultiPlayerInit() {
$this->gamestate->setAllPlayersMultiactive();
}
</pre>

=== transitions ===

('''Mandatory''')

With "transitions" you specify which game state(s) you can jump to from a given game state.

Example:
<pre>
25 => array(
"name" => "myGameState",
"transitions" => array( "nextPlayer" => 27, "endRound" => 39 ),
....
}
</pre>

In the example above, if "myGameState" is the current active game state, I can jump to the game state with ID 27 or the game state with ID 39.

Example to jump to ID 27:
<pre>
In mygame.game.php:
$this->gamestate->nextState( "nextPlayer" );
</pre>

Important: "nextPlayer" is the name of the transition, and NOT the name of the target game state. Multiple transitions can lead to the same game state.

Note: If there is only 1 transition, you may give it an empty name.

Example:
<pre>
In states.inc.php:
"transitions" => array( "" => 27 ),

In mygame.game.php:
$this->gamestate->nextState( ); // We don't need to specify a transition as there is only one here
</pre>

=== possibleactions ===

('''Mandatory''' when the game state is "activeplayer" or "multipleactiveplayer")

"possibleactions" defines the actions possible by the players in this game state, and ensures they cannot perform actions that are not allowed in this state.

Example:

<pre>
In states.game.php:
"possibleactions" => array( "playCard", "pass" ),

In mygame.game.php:
function playCard( ...)
{
self::checkAction( "playCard" ); // Will fail if "playCard" is not specified in "possibleactions" in the current game state.

....

In mygame.js:
playCard: function( ... )
{
if( this.checkAction( "playCard" ) ) // Will fail if "playCard" is not specified in "possibleactions" in the current game state.
{ return ; }

....

</pre>

=== args ===

(optional)

Sometimes it happens that you need some information on the client side (i.e., for your game interface) only for a specific game state.

Example 1: in ''Reversi'', the list of possible moves during the playerTurn state.

Example 2: in ''Caylus'', the number of remaining king's favors to choose in the state where the player is choosing a favor.

Example 3: in ''Can't Stop'', the list of possible die combinations to be displayed to the active player so that he can choose from among them.

In such a situation, you can specify a method name as the « args » argument for your game state. This method must retrieve some piece of information about the game (example: for ''Reversi'', the list of possible moves) and return it.

Thus, this data can be transmitted to the clients and used by the clients to display it. It should always be an associative array.

Let's see a complete example using args with ''Reversi'' game:

In states.inc.php, we specify an '''args''' argument for gamestate '''playerTurn''':
<pre>
10 => array(
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must play a disc'),
"descriptionmyturn" => clienttranslate('${you} must play a disc'),
"type" => "activeplayer",
"args" => "argPlayerTurn", // <==== HERE
"possibleactions" => array( 'playDisc' ),
"transitions" => array( "playDisc" => 11, "zombiePass" => 11 )
),
</pre>

It corresponds to a '''argPlayerTurn''' method in our PHP code (reversi.game.php):
<pre>
function argPlayerTurn() {
return array(
'possibleMoves' => self::getPossibleMoves()
);
}
</pre>

Then, when we enter into the '''playerTurn''' game state on the client side, we can highlight the possible moves on the board using information returned by '''argPlayerTurn''':

<pre>
onEnteringState: function( stateName, args ) {
console.log( 'Entering state: '+stateName );

switch( stateName ) {
case 'playerTurn':
this.updatePossibleMoves( args.args.possibleMoves );
break;
}
},
</pre>

==== Naming and API conventions ====

As a BGA convention, PHP methods called with "args" are prefixed by "arg" followed by state name (example: '''argPlayerTurn''').

All "arg*" methods are put into corresponding section of .game.php file commented as
//////////// Game state arguments

Arg method MUST return array. Return integer or string will result in some undebuggable exceptions.

Arg method MUST be defined in php if it is declared in state description, if you don't need it comment it out from the states.inc.php file (the '''args''' parameter). If you not sure if you need it or not you can keep it returning empty array until you figure it out.

function argPlayerTurn() {
return array(); // must be an array
}

'''Warning''': the "args" method can be called before the "action" method so don't expect data modifications by the "action" method to be available in the "args" method!
Also don't modify database in this method!

You should NOT be calling getCurrentPlayer() in the context of this function, since state transitions are broadcasted to all player independent of who initiated it. Instead you should send information on per player basis (Note: if this is private info see section below).

If you using this function in multi-player state, you should not call getActivePlayer() either, you should send per player info:

function arg_playerTurn() {
$res = array ();
$players = $this->loadPlayersBasicInfos();
foreach ( $players as $player_id => $player_info ) {
$color = $player_info ['player_color'];
$res [$player_id] = array("color"=>$color);
}
return $res;
}

Note: you never need to send player color like this, this is just an example.

Note 2: you CAN call methods that return all active players if multi-player states if its relevant.

==== Other usages ====

You can use values returned by your "args" method to have some custom values in your "description"/"descriptionmyturn", i.e. in states.inc.php:

"descriptionmyturn" => clienttranslate('${you} must play ${color} disc'),

So arg function will be something like:

function argPlayerTurn() {
return array('color'=>this->getActivePlayerColor());
}

You can use args also in '''onUpdateActionButtons''' function on js side, however two important notes:
* it is just '''args''' (not args.args like in '''onEnteringState''')
* it is args of the current state, which may not be state you think it will be! This method is called during change of active player, which happens in some weird place especially during "multipleactiveplayer" states. If you pulling your hair thinking why its "undefined" on js side - check the current state.

==== Private info in args ====

By default, all data provided through this method are PUBLIC TO ALL PLAYERS. Please do not send any private data with this method, as a cheater could see it even it is not used explicitly by the game interface logic.

However, it is possible to specify that some data should be sent to specific players only.

Example 1: send information to active player(s) only:

<pre>
function argPlayerTurn() {
return array(
'_private' => array( // Using "_private" keyword, all data inside this array will be made private
'active' => array( // Using "active" keyword inside "_private", you select active player(s)
'somePrivateData' => self::getSomePrivateData() // will be send only to active player(s)
)
),
'possibleMoves' => self::getPossibleMoves() // will be sent to all players
);
}
</pre>

Inside the js file, these variables will be available through `args.args._private`. (e.g. `args.args._private.somePrivateData` -- it is not `args._private.active.somePrivateData` nor is it `args.somePrivateData`)

Example 2: send information to a specific player (<specific_player_id>) only:

<pre>
function argPlayerTurn() {
$specific_player_id = ...; // calculate some-how
return array(
'_private' => array( // all data inside this array will be private
$specific_player_id => array( // will be sent only to that player
'somePrivateData' => self::getSomePrivateData()
)
),

'possibleMoves' => self::getPossibleMoves() // will be sent to all players
);
}
</pre>

IMPORTANT: in certain situations (i.e. "multipleactiveplayer" game state) these "private data" features can have a significant impact on performance. Please do not use if not needed.

It is also possible to use these private args in the "description" messages, like "${you} have to play ${_private.count} cards".

==== Translations in args ====
You can do the same as in notification by adding i18n parameter, i.e
<pre>
function argPlayerTurn() {
return [
'i18n' => ['terrainName' ],
'terrainName' => ($this->token_types[$terrain]['name']), // this should be defined in material.inc.php and with clienttranslate
'terrain' => $terrain,
];
}
</pre>

Than you can do something like this in state:
"descriptionmyturn" => clienttranslate('${you} must place a house on ${terrainName}'),

See more in [[Translations]]

=== updateGameProgression ===

(optional)

If you specify "updateGameProgression => true" in a game state, your "getGameProgression" PHP method will be called at the beginning of this game state - and thus the game progression of the game will be updated.

''At least one'' of your game states (any one) must specify "updateGameProgression=>true".

=== initialprivate ===

(optional)

This parameter will enable private parallel states in a multiplayer state. Parameter should be set to first private parallel state a player will be transitioned to.
See more details about Private parallel states [[#Private_parallel_states|here]].

== Implementation Notes ==

=== Private parallel states ===

Private parallel states are useful when multiple players are active and their turn is very complex. In that case it is possible with parallel states for each player to be in a independent state.

Lets say that players need to do three complex action one after another in multiactive state. With parallel states each player can independently be in a different state (i.e. one player still need to decide about first action while some players are deciding their second action and the fastest player is already on their third action. Normally this can be handled with two simple, but limited, approaches:

* Moving all players to different states together - this is limiting for faster players as they need to wait other players for each separate action. The more problematic thing is that it would be hard to implement an undo feature when one player wants to change their previous action. In that case all players should be moved back to previous state which will interrupt their flow.
* Using client states, by changing the state in which the player is in javascript - the problem with this approach is that players will lose their progress on browser refresh (F5). Furthermore the validation logic of specific actions shuld be implemented on both server side and client side and we cannot have specific args for each different action, but they should be calculated only at the beginning of the first action and possibly calculated on client side after each action, which again duplicates logic on client and server.

With private parallel states, each specific action can be implemented as a parallel state. Parallel states are defined with the type 'private' and players are moved to those private states during one master multiactive state. Lets look at the example:

<pre>
10 => [
"name" => "playerTurn",
"description" => clienttranslate('Waiting for other players to end their turn.'),
"descriptionmyturn" => clienttranslate('${you} must do your turn'), // Won't be displayed anyway since each private state has its own description
"type" => "multipleactiveplayer",
"initialprivate" => 50, // This makes this state a master multiactive state and enables private states, this is also a first private state
"action" => "stPlayerTurn",
"args" => "argPlayerTurn",
"possibleactions" => ["changeMind"], //this action is possible if player is not in any private state which usually happens when they are inactive
"transitions" => ["playersDecide" => 11] // this is normal next transition which will happen after all players finish their turns
],

50 => [
"name" => "chooseFirst",
"descriptionmyturn" => clienttranslate('${you} must make your first choice'), // just this parameter is needed. description is not needed as no player is inactive in this state
"type" => "private", // this state is reachable only as a private state
"args" => "argChooseFirst", //this method will be called with playerId as a parametar and is used to calculate arguments for this action for specific player
"action" => "stChooseFirst", // this method will be called with playerId as a parameter and can be used to make some changes when player enters this private state
"possibleactions" => ["toSecond"],
"transitions" => [
'chooseSecond' => 51, // transition to another private state
]
],

51 => [
"name" => "chooseSecond",
"descriptionmyturn" => clienttranslate('${you} must make your second choice'),
"type" => "private",
"args" => "argChooseSecond",
"possibleactions" => ["finish", "back"],
"transitions" => [
'back' => 50,
]
],
</pre>

When entering the master state it is usually useful to set some players as multiactive and initialize their private state:

<pre>
function stPlayerTurn() {
$this->gamestate->setAllPlayersMultiactive();

//this is needed when starting private parallel states; players will be transitioned to initialprivate state defined in master state
$this->gamestate->initializePrivateStateForAllActivePlayers();

// in some cases you can move immediately some or all players to different private states
if ($someCondition) {
//move all players to different state
$this->gamestate->nextPrivateStateForAllActivePlayers("choseSecond");
}

if ($other condition) {
//move single player to different state
$this->gamestate->nextPrivateState($specificPlayerId, "chooseSecond");
}
}
</pre>

When some action is done by a player, you can move them to the next private state:

<pre>
function toSecond() {
$this->checkAction("toSecond"); //the action must be defined in private state; actions defined in master state are not possible
$this->gamestate->nextPrivateState($this->getCurrentPlayerId(), "chooseSecond"); //moving current player to different state
}
</pre>

Please check the detailed API [[Main_game_logic:_yourgamename.game.php#Private_parallel_states|here]].

=== Using Named Constants for States ===

Using numeric constants is prone to errors. If you want you can declare state constants as PHP named constants. This way you can
use them in the states file and in game.php as well

EXAMPLE:

states.inc.php:

<pre>
// define contants for state ids
if (!defined('STATE_END_GAME')) { // ensure this block is only invoked once, since it is included multiple times
define("STATE_PLAYER_TURN", 2);
define("STATE_GAME_TURN", 3);
define("STATE_PLAYER_TURN_CUBES", 4);
define("STATE_END_GAME", 99);
}

$machinestates = array(

...

STATE_PLAYER_TURN => array(
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must select an Action Space or Pass'),
"descriptionmyturn" => clienttranslate('${you} must select an Action Space or Pass'),
"type" => "activeplayer",
"args" => 'arg_playerTurn',
"possibleactions" => array( "selectWorkerAction", "pass" ),
"transitions" => array(
"loopback" => STATE_PLAYER_TURN,
"playCubes" => STATE_PLAYER_TURN_CUBES,
"pass" => STATE_GAME_TURN )
),
</pre>

=== Example of multipleactiveplayer state ===

This is an example of a multipleactiveplayer state:

2 => array (
'name' => 'playerTurnSetup',
'type' => 'multipleactiveplayer',
'description' => clienttranslate('Other players must choose one Objective'),
'descriptionmyturn' => clienttranslate('${you} must choose one Objective card to keep'),
'possibleactions' => array ('playKeep' ),
'transitions' => array ( 'next' => 5, 'loopback' => 2, ),
'action' => 'st_MultiPlayerInit',
'args' => 'arg_playerTurnSetup',
),

In game.php:
// this will make all players multiactive just before entering the state
function st_MultiPlayerInit() {
$this->gamestate->setAllPlayersMultiactive();
}

Note: if you want exact this function its already defined in table class its called 'stMakeEveryoneActive'

When ending the player action, instead of a state transition, deactivate player.

function action_playKeep($cardId) {
$this->checkAction('playKeep');
$player_id = $this->getCurrentPlayerId(); // CURRENT!!! not active
... // some logic here
$this->gamestate->setPlayerNonMultiactive($player_id, 'next'); // deactivate player; if none left, transition to 'next' state
}

=== Difference between Single active and Multi active states ===
In a classic "activePlayer" state:

* You cannot change the active player DURING the state. This is to ensure that during 1 activePlayer state, only ONE player is active
* As a consequence, you must set the active player BEFORE entering the activePlayer state
* In such states on JS side onUpdateActionButtons is called before onEnteringState during game play (but after during reload, i.e. F5)
* Finally, during onEnteringState, on JS side, the active player is signaled as active and the information is reliable and usable.

In a "multiplePlayer" state:

* You can (and must) change the active players DURING the state
* During such a state, players can be activated/desactivated anytime during the state, giving you the maximum of possibilities.
* You shouldn't set active player before entering the state. But you can set it in "state initializer" php function (see example above st_MultiPlayerInit)
* Finally, during onEnteringState, on JS side, the active players are NOT active yet so you must use onUpdateActionButtons to perform the client side operation which depends on a player active/inactive status.

=== Designing states ===

As a general rule you state machine should resemble "round/turn overview" from the game rule-book. Normally if book say its player turn and player can do multiple things during their turn it is still only
one player state (plus a game to switch player), not muliple states.

In a classic game (i.e. chess), there is only active player at any time, so it is simple playerTurn/gameTurn sequence and you only need 2 states.

[[File:Simplestates.png]]

In complex euro game there can be multiple rounds, and each round have phases which can be distinctly unique, i.e. in first phase everybody draws card and discard (multi-player), then player have one turn each (single-active), then another is resolution of actions from players and some of them may become active again, then there is round upkeep/reset. This would require one multi-player state for phase 1, pair of states for phase2 (singel-active + game), pair of states for phase3 and finally round-end/unkeep game state.

For pair of active player/game states you can make player state first, which transitions to game state, or the other way around, you start with game state which transition to active player state, its loop in any case but depends on how you want to do "phase" initiazations.

[[File:Eurogamestates.png]]

=== Complete examples ===

Example of simple game where player take turns

<pre>
if ( !defined('STATE_END_GAME')) { // guard since this included multiple times
define("STATE_PLAYER_TURN", 2);
define("STATE_GAME_TURN_NEXT_PLAYER", 3);
define("STATE_PLAYER_GAME_END", 4);
define("STATE_END_GAME", 99);
}

$machinestates = [
1 => [ // The initial state. Please do not modify.
"name" => "gameSetup",
"description" => "",
"type" => "manager",
"action" => "stGameSetup",
"transitions" => [ "" => STATE_PLAYER_TURN ] ],
// Game states
STATE_PLAYER_TURN => [ // main active player state
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must do something or pass'),
"descriptionmyturn" => clienttranslate('${you} must do something or pass'),
"type" => "activeplayer",
"args" => "arg_playerTurn",
"possibleactions" => [ "dosomething","pass" ],
"transitions" => [ "next" => STATE_GAME_TURN_NEXT_PLAYER,"last" => STATE_PLAYER_GAME_END ] //
],
STATE_GAME_TURN_NEXT_PLAYER => [ // next player state
"name" => "gameTurnNextPlayer",
"description" => clienttranslate('Upkeep...'),
"type" => "game", //
"action" => "st_gameTurnNextPlayer", //
"updateGameProgression" => true,
"transitions" => [ "next" => STATE_PLAYER_TURN,"loopback" => STATE_GAME_TURN_NEXT_PLAYER,
"last" => STATE_PLAYER_GAME_END ], // TODO replace with STATE_END_GAME, its there to use undo/restore during dev
],

STATE_PLAYER_GAME_END => [ // active player state for debugging end of game
"name" => "playerGameEnd",
"description" => clienttranslate('${actplayer} Game Over'),
"descriptionmyturn" => clienttranslate('${you} Game Over'),
"type" => "activeplayer",
"args" => "arg_playerTurn",
"possibleactions" => ["endGame"],
"transitions" => ["next" => STATE_END_GAME,"loopback" => STATE_PLAYER_GAME_END ] //
],
// End of Game states
// Final state.
// Please do not modify (and do not overload action/args methods).
STATE_END_GAME => [
"name" => "gameEnd",
"description" => clienttranslate("End of game"),"type" => "manager",
"action" => "stGameEnd",
"args" => "argGameEnd" ]

];

</pre>

Your game state machine: states.inc.php

2022-01-05T19:28:57Z

Kayvon: /* Private parallel states */ "lose" has only one 'o'

{{Studio_Framework_Navigation}}

This file describes the state machine of your game (all the game states properties, and the transitions to get from one state to another).

Important: to understand the game state machine, it's recommended that you read this presentation first:

[http://www.slideshare.net/boardgamearena/bga-studio-focus-on-bga-game-state-machine Focus on BGA game state machine]

== Overall structure ==

The machine states are described by a PHP associative array.

Example:

<pre>
$machinestates = array(

// The initial state. Please do not modify.
1 => array(
"name" => "gameSetup",
"description" => clienttranslate("Game setup"),
"type" => "manager",
"action" => "stGameSetup",
"transitions" => array( "" => 2 )
),

// Note: ID=2 => your first state

2 => array(
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must play a card or pass'),
"descriptionmyturn" => clienttranslate('${you} must play a card or pass'),
"type" => "activeplayer",
"possibleactions" => array( "playCard", "pass" ),
"transitions" => array( "playCard" => 2, "pass" => 2 )
),
</pre>

== Syntax ==

=== id ===

The keys determine game state IDs (in the example above: 1 and 2).

IDs must be positive integers.

ID=1 is reserved for the first game state and should not be used (and you must not modify it).

ID=99 is reserved for the last game state (end of the game) (and you must not modify it).

Note: you may use any ID, even an ID greater than 100. But you cannot use 1 or 99.

Note²: You must not use the same ID twice.

Note³: When a game is in prod and you change the ID of a state, all active games (including many turn based) will behave unpredictably.

=== name ===

('''Mandatory''')

The name of a game state is used to identify it in your game logic.

Several game states can share the same name; however, this is not recommended.

Warning! Do not put spaces in the name. This could cause unexpected problems in some cases.

PHP example:
<pre>

// Get current game state
$state = $this->gamestate->state();
if( $state['name'] == 'myGameState' )
{
...
}

</pre>

JS example:
<pre>
onEnteringState: function( stateName, args )
{
console.log( 'Entering state: '+stateName );

switch( stateName )
case 'myGameState':

// Do some stuff at the beginning at this game state
....

break;
</pre>

=== type ===

('''Mandatory''')

You can use 3 types of game states:
* activeplayer (1 player is active and must play.)
* multipleactiveplayer (1..N players can be active and must play.)
* private (during multiactive states players can independently move to different private parallel states. See more details [[#Private_parallel_states|here]].
* game (No player is active. This is a transitional state to do something automatic specified by the game rules.)

'''Note:''' Make sure you don't mistype the value of this attribute. If you do (e.g. 'multiactiveplayer' instead of 'multipleactiveplayer'), things won't work, and you might have a hard time figuring out why.

=== description ===

('''Mandatory''')

The description is the string that is displayed in the main action bar (top of the screen) when the state is active.

When a string is specified as a description, you must use "clienttranslate" in order for the string to be translated on the client side:

<pre>
"description" => clienttranslate('${actplayer} must play a card or pass'),
</pre>

In the description string, you can use ${actplayer} to refer to the active player.

You can also use custom arguments in your description. These custom arguments correspond to values returned by your "args" PHP method (see below "args" field).

Example of custom field:
<pre>

In states.inc.php:
"description" => clienttranslate('${actplayer} must choose ${nbr} identical energies'),
"args" => "argMyArgumentMethod"

In mygame.game.php:
function argMyArgumentMethod()
{
return array(
'nbr' => 2 // In this case ${nbr} in the description will be replaced by "2"
);
}
</pre>

Note: You may specify an empty string ("") here if it never happens that the game remains in this state (i.e., if this state immediately jumps to another state when activated).

Note²: Usually, you specify a string for "activeplayer" and "multipleactiveplayer" game states, and you specify an empty string for "game" game states. BUT, if you are using synchronous notifications, the client can remain on a "game" type game state for a few seconds, and in this case it may be useful to display a description in the status bar while in this state.

=== descriptionmyturn ===

('''Mandatory''' when the state type is "activeplayer" or "multipleactiveplayer")

"descriptionmyturn" has exactly the same role and properties as "description", except that this value is displayed to the current active player - or to all active players in case of a multipleactiveplayer game state.

In general, we have this situation:

<pre>
"description" => clienttranslate('${actplayer} can take some actions'),
"descriptionmyturn" => clienttranslate('${you} can take some actions'),
</pre>

Note: you can use ${you} in descriptionmyturn so the description will display "You" instead of the name of the player.

Note 2: you can use ${otherplayer} to refer to some other player if you want this to be shown in player's color, but you must provide otherplayer_id as argument (along with otherplayer) to specify this player's id in this case or game won't load.

I.e.

"descriptionmyturn" => clienttranslate('${you} can follow action of ${otherplayer}'),

And this will have to be state arguments for this
<pre>
function arg_playerTurnFollow(){
return ['otherplayer'=> $this->getLeaderPlayerName(),
'otherplayer_id'=> $this->getLeaderPlayerId()
];
}
</pre>

=== action ===

('''Mandatory''' when the state type is "game.")

"action" specifies a PHP method to call when entering this game state.

Example:
In states.inc.php:
<pre>
28 => array(
"name" => "gameTurnNextPlayer",
"description" => clienttranslate('Updating some stuff...'),
"type" => "game",
"action" => "st_gameTurnNextPlayer",
</pre>
In mygame.game.php:
<pre>
function st_gameTurnNextPlayer() {
$player_id = $this->getActivePlayerId();
$next_player_id = $this->getPlayerAfter($player_id);
$this->giveExtraTime($next_player_id);
$this->incStat(1, 'turns_number', $next_player_id);
$this->incStat(1, 'turns_number');
$this->gamestate->changeActivePlayer($next_player_id);
$this->gamestate->nextState('next');
}
</pre>

Usually, for a "game" state type, the action method is used to perform automatic functions specified by the rules (for example: check victory conditions, deal cards for a new round, go to the next player, etc.) and then jump to another game state.

Note: a BGA convention specifies that PHP methods called with "action" are prefixed by "st".

Note: this field CAN be used for player states to set something up; e.g., for multiplayer states, it can make all players active.

Example for action in player state:
in states.inc.php:
<pre>
2 => array(
"name" => "playerTurnPlace",
"description" => clienttranslate('Other player must place ships'),
"descriptionmyturn" => clienttranslate('${you} must place ships (click on YOUR SHIPS board to place)'),
"type" => "multipleactiveplayer",
'action' => 'st_MultiPlayerInit',
'args' => 'arg_playerTurnPlace',
"possibleactions" => array( "playPlace" ),
"transitions" => array( "next" => 4, "last" => 99)
),
</pre>
in mygame.game.php:
<pre>
function st_MultiPlayerInit() {
$this->gamestate->setAllPlayersMultiactive();
}
</pre>

=== transitions ===

('''Mandatory''')

With "transitions" you specify which game state(s) you can jump to from a given game state.

Example:
<pre>
25 => array(
"name" => "myGameState",
"transitions" => array( "nextPlayer" => 27, "endRound" => 39 ),
....
}
</pre>

In the example above, if "myGameState" is the current active game state, I can jump to the game state with ID 27 or the game state with ID 39.

Example to jump to ID 27:
<pre>
In mygame.game.php:
$this->gamestate->nextState( "nextPlayer" );
</pre>

Important: "nextPlayer" is the name of the transition, and NOT the name of the target game state. Multiple transitions can lead to the same game state.

Note: If there is only 1 transition, you may give it an empty name.

Example:
<pre>
In states.inc.php:
"transitions" => array( "" => 27 ),

In mygame.game.php:
$this->gamestate->nextState( ); // We don't need to specify a transition as there is only one here
</pre>

=== possibleactions ===

('''Mandatory''' when the game state is "activeplayer" or "multipleactiveplayer")

"possibleactions" defines the actions possible by the players in this game state, and ensures they cannot perform actions that are not allowed in this state.

Example:

<pre>
In states.game.php:
"possibleactions" => array( "playCard", "pass" ),

In mygame.game.php:
function playCard( ...)
{
self::checkAction( "playCard" ); // Will fail if "playCard" is not specified in "possibleactions" in the current game state.

....

In mygame.js:
playCard: function( ... )
{
if( this.checkAction( "playCard" ) ) // Will fail if "playCard" is not specified in "possibleactions" in the current game state.
{ return ; }

....

</pre>

=== args ===

(optional)

Sometimes it happens that you need some information on the client side (i.e., for your game interface) only for a specific game state.

Example 1: in ''Reversi'', the list of possible moves during the playerTurn state.

Example 2: in ''Caylus'', the number of remaining king's favors to choose in the state where the player is choosing a favor.

Example 3: in ''Can't Stop'', the list of possible die combinations to be displayed to the active player so that he can choose from among them.

In such a situation, you can specify a method name as the « args » argument for your game state. This method must retrieve some piece of information about the game (example: for ''Reversi'', the list of possible moves) and return it.

Thus, this data can be transmitted to the clients and used by the clients to display it. It should always be an associative array.

Let's see a complete example using args with ''Reversi'' game:

In states.inc.php, we specify an '''args''' argument for gamestate '''playerTurn''':
<pre>
10 => array(
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must play a disc'),
"descriptionmyturn" => clienttranslate('${you} must play a disc'),
"type" => "activeplayer",
"args" => "argPlayerTurn", // <==== HERE
"possibleactions" => array( 'playDisc' ),
"transitions" => array( "playDisc" => 11, "zombiePass" => 11 )
),
</pre>

It corresponds to a '''argPlayerTurn''' method in our PHP code (reversi.game.php):
<pre>
function argPlayerTurn() {
return array(
'possibleMoves' => self::getPossibleMoves()
);
}
</pre>

Then, when we enter into the '''playerTurn''' game state on the client side, we can highlight the possible moves on the board using information returned by '''argPlayerTurn''':

<pre>
onEnteringState: function( stateName, args ) {
console.log( 'Entering state: '+stateName );

switch( stateName ) {
case 'playerTurn':
this.updatePossibleMoves( args.args.possibleMoves );
break;
}
},
</pre>

==== Naming and API conventions ====

As a BGA convention, PHP methods called with "args" are prefixed by "arg" followed by state name (example: '''argPlayerTurn''').

All "arg*" methods are put into corresponding section of .game.php file commented as
//////////// Game state arguments

Arg method MUST return array. Return integer or string will result in some undebuggable exceptions.

Arg method MUST be defined in php if it is declared in state description, if you don't need it comment it out from the states.inc.php file (the '''args''' parameter). If you not sure if you need it or not you can keep it returning empty array until you figure it out.

function argPlayerTurn() {
return array(); // must be an array
}

'''Warning''': the "args" method can be called before the "action" method so don't expect data modifications by the "action" method to be available in the "args" method!
Also don't modify database in this method!

You should NOT be calling getCurrentPlayer() in the context of this function, since state transitions are broadcasted to all player independent of who initiated it. Instead you should send information on per player basis (Note: if this is private info see section below).

If you using this function in multi-player state, you should not call getActivePlayer() either, you should send per player info:

function arg_playerTurn() {
$res = array ();
$players = $this->loadPlayersBasicInfos();
foreach ( $players as $player_id => $player_info ) {
$color = $player_info ['player_color'];
$res [$player_id] = array("color"=>$color);
}
return $res;
}

Note: you never need to send player color like this, this is just an example.

Note 2: you CAN call methods that return all active players if multi-player states if its relevant.

==== Other usages ====

You can use values returned by your "args" method to have some custom values in your "description"/"descriptionmyturn", i.e. in states.inc.php:

"descriptionmyturn" => clienttranslate('${you} must play ${color} disc'),

So arg function will be something like:

function argPlayerTurn() {
return array('color'=>this->getActivePlayerColor());
}

You can use args also in '''onUpdateActionButtons''' function on js side, however two important notes:
* it is just '''args''' (not args.args like in '''onEnteringState''')
* it is args of the current state, which may not be state you think it will be! This method is called during change of active player, which happens in some weird place especially during "multipleactiveplayer" states. If you pulling your hair thinking why its "undefined" on js side - check the current state.

==== Private info in args ====

By default, all data provided through this method are PUBLIC TO ALL PLAYERS. Please do not send any private data with this method, as a cheater could see it even it is not used explicitly by the game interface logic.

However, it is possible to specify that some data should be sent to specific players only.

Example 1: send information to active player(s) only:

<pre>
function argPlayerTurn() {
return array(
'_private' => array( // Using "_private" keyword, all data inside this array will be made private
'active' => array( // Using "active" keyword inside "_private", you select active player(s)
'somePrivateData' => self::getSomePrivateData() // will be send only to active player(s)
)
),
'possibleMoves' => self::getPossibleMoves() // will be sent to all players
);
}
</pre>

Inside the js file, these variables will be available through `args.args._private`. (e.g. `args.args._private.somePrivateData` -- it is not `args._private.active.somePrivateData` nor is it `args.somePrivateData`)

Example 2: send information to a specific player (<specific_player_id>) only:

<pre>
function argPlayerTurn() {
$specific_player_id = ...; // calculate some-how
return array(
'_private' => array( // all data inside this array will be private
$specific_player_id => array( // will be sent only to that player
'somePrivateData' => self::getSomePrivateData()
)
),

'possibleMoves' => self::getPossibleMoves() // will be sent to all players
);
}
</pre>

IMPORTANT: in certain situations (i.e. "multipleactiveplayer" game state) these "private data" features can have a significant impact on performance. Please do not use if not needed.

It is also possible to use these private args in the "description" messages, like "${you} have to play ${_private.count} cards".

==== Translations in args ====
You can do the same as in notification by adding i18n parameter, i.e
<pre>
function argPlayerTurn() {
return [
'i18n' => ['terrainName' ],
'terrainName' => ($this->token_types[$terrain]['name']), // this should be defined in material.inc.php and with clienttranslate
'terrain' => $terrain,
];
}
</pre>

Than you can do something like this in state:
"descriptionmyturn" => clienttranslate('${you} must place a house on ${terrainName}'),

See more in [[Translations]]

=== updateGameProgression ===

(optional)

If you specify "updateGameProgression => true" in a game state, your "getGameProgression" PHP method will be called at the beginning of this game state - and thus the game progression of the game will be updated.

''At least one'' of your game states (any one) must specify "updateGameProgression=>true".

=== initialprivate ===

(optional)

This parameter will enable private parallel states in a multiplayer state. Parameter should be set to first private parallel state a player will be transitioned to.
See more details about Private parallel states [[#Private_parallel_states|here]].

== Implementation Notes ==

=== Private parallel states ===

Private parallel states are useful when multiple players are active and their turn is very complex. In that case it is possible with parallel states for each player to be in a independent state.

Lets say that players need to do three complex action one after another in multiactive state. With parallel states each player can independently be in a different state (i.e. one player still need to decide about first action while some players are deciding their second action and the fastest player is already on their third action. Normally this can be handled with two simple, but limited, approaches:

* Moving all players to different states together - this is limiting for faster players as they need to wait other players for each separate action. The more problematic thing is that it would be hard to implement an undo feature when one player wants to change their previous action. In that case all players should be moved back to previous state which will interrupt their flow.
* Using client states, by changing the state in which the player is in javascript - the problem with this approach is that players will lose their progress on browser refresh (F5). Furthermore the validation logic of specific actions shuld be implemented on both server side and client side and we cannot have specific args for each different action, but they should be calculated only at the beginning of the first action and possibly calculated on client side after each action, which again duplicates logic on client and server.

With private parallel states, each specific action can be implemented as a parallel state. Parallel states are defined with the type 'private' and players are moved to those private states during one master multiactive state. Lets look at the example:

<pre>
10 => [
"name" => "playerTurn",
"description" => clienttranslate('Waiting for other players to end their turn.'),
"descriptionmyturn" => clienttranslate('${you} must do your turn'), // Won't be displayed anyway since each private state has its own description
"type" => "multipleactiveplayer",
"initialprivate" => 50, // This makes this state a master multiactive state and enables private states, this is also a first private state
"action" => "stPlayerTurn",
"args" => "argPlayerTurn",
"possibleactions" => ["changeMind"], //this action is possible if player is not in any private state which usually happens when they are inactive
"transitions" => ["playersDecide" => 11] // this is normal next transition which will happen after all players finish their turns
],

50 => [
"name" => "chooseFirst",
"descriptionmyturn" => clienttranslate('${you} must make your first choice'), // just this parameter is needed. description is not needed as no player is inactive in this state
"type" => "private", // this state is reachable only as a private state
"args" => "argChooseFirst", //this method will be called with playerId as a parametar and is used to calculate arguments for this action for specific player
"action" => "stChooseFirst", // this method will be called with playerId as a parameter and can be used to make some changes when player enters this private state
"possibleactions" => ["toSecond"],
"transitions" => [
'chooseSecond' => 51, // transition to another private state
]
],

51 => [
"name" => "chooseSecond",
"descriptionmyturn" => clienttranslate('${you} must make your second choice'),
"type" => "private",
"args" => "argChooseSecond",
"possibleactions" => ["finish", "back"],
"transitions" => [
'back' => 50,
]
],
</pre>

When entering the master state it is usually usefull to set some players as multiactive and initialize their private state:

<pre>
function stPlayerTurn() {
$this->gamestate->setAllPlayersMultiactive();

//this is needed when starting private parallel states; players will be transitioned to initialprivate state defined in master state
$this->gamestate->initializePrivateStateForAllActivePlayers();

// in some cases you can move immediately some or all players to different private states
if ($someCondition) {
//move all players to different state
$this->gamestate->nextPrivateStateForAllActivePlayers("choseSecond");
}

if ($other condition) {
//move single player to different state
$this->gamestate->nextPrivateState($specificPlayerId, "chooseSecond");
}
}
</pre>

When some action is done by a player, you can move them to the next private state:

<pre>
function toSecond() {
$this->checkAction("toSecond"); //the action must be defined in private state; actions defined in master state are not possible
$this->gamestate->nextPrivateState($this->getCurrentPlayerId(), "chooseSecond"); //moving current player to different state
}
</pre>

Please check the detailed API [[Main_game_logic:_yourgamename.game.php#Private_parallel_states|here]].

=== Using Named Constants for States ===

Using numeric constants is prone to errors. If you want you can declare state constants as PHP named constants. This way you can
use them in the states file and in game.php as well

EXAMPLE:

states.inc.php:

<pre>
// define contants for state ids
if (!defined('STATE_END_GAME')) { // ensure this block is only invoked once, since it is included multiple times
define("STATE_PLAYER_TURN", 2);
define("STATE_GAME_TURN", 3);
define("STATE_PLAYER_TURN_CUBES", 4);
define("STATE_END_GAME", 99);
}

$machinestates = array(

...

STATE_PLAYER_TURN => array(
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must select an Action Space or Pass'),
"descriptionmyturn" => clienttranslate('${you} must select an Action Space or Pass'),
"type" => "activeplayer",
"args" => 'arg_playerTurn',
"possibleactions" => array( "selectWorkerAction", "pass" ),
"transitions" => array(
"loopback" => STATE_PLAYER_TURN,
"playCubes" => STATE_PLAYER_TURN_CUBES,
"pass" => STATE_GAME_TURN )
),
</pre>

=== Example of multipleactiveplayer state ===

This is an example of a multipleactiveplayer state:

2 => array (
'name' => 'playerTurnSetup',
'type' => 'multipleactiveplayer',
'description' => clienttranslate('Other players must choose one Objective'),
'descriptionmyturn' => clienttranslate('${you} must choose one Objective card to keep'),
'possibleactions' => array ('playKeep' ),
'transitions' => array ( 'next' => 5, 'loopback' => 2, ),
'action' => 'st_MultiPlayerInit',
'args' => 'arg_playerTurnSetup',
),

In game.php:
// this will make all players multiactive just before entering the state
function st_MultiPlayerInit() {
$this->gamestate->setAllPlayersMultiactive();
}

Note: if you want exact this function its already defined in table class its called 'stMakeEveryoneActive'

When ending the player action, instead of a state transition, deactivate player.

function action_playKeep($cardId) {
$this->checkAction('playKeep');
$player_id = $this->getCurrentPlayerId(); // CURRENT!!! not active
... // some logic here
$this->gamestate->setPlayerNonMultiactive($player_id, 'next'); // deactivate player; if none left, transition to 'next' state
}

=== Difference between Single active and Multi active states ===
In a classic "activePlayer" state:

* You cannot change the active player DURING the state. This is to ensure that during 1 activePlayer state, only ONE player is active
* As a consequence, you must set the active player BEFORE entering the activePlayer state
* In such states on JS side onUpdateActionButtons is called before onEnteringState during game play (but after during reload, i.e. F5)
* Finally, during onEnteringState, on JS side, the active player is signaled as active and the information is reliable and usable.

In a "multiplePlayer" state:

* You can (and must) change the active players DURING the state
* During such a state, players can be activated/desactivated anytime during the state, giving you the maximum of possibilities.
* You shouldn't set active player before entering the state. But you can set it in "state initializer" php function (see example above st_MultiPlayerInit)
* Finally, during onEnteringState, on JS side, the active players are NOT active yet so you must use onUpdateActionButtons to perform the client side operation which depends on a player active/inactive status.

=== Designing states ===

As a general rule you state machine should resemble "round/turn overview" from the game rule-book. Normally if book say its player turn and player can do multiple things during their turn it is still only
one player state (plus a game to switch player), not muliple states.

In a classic game (i.e. chess), there is only active player at any time, so it is simple playerTurn/gameTurn sequence and you only need 2 states.

[[File:Simplestates.png]]

In complex euro game there can be multiple rounds, and each round have phases which can be distinctly unique, i.e. in first phase everybody draws card and discard (multi-player), then player have one turn each (single-active), then another is resolution of actions from players and some of them may become active again, then there is round upkeep/reset. This would require one multi-player state for phase 1, pair of states for phase2 (singel-active + game), pair of states for phase3 and finally round-end/unkeep game state.

For pair of active player/game states you can make player state first, which transitions to game state, or the other way around, you start with game state which transition to active player state, its loop in any case but depends on how you want to do "phase" initiazations.

[[File:Eurogamestates.png]]

=== Complete examples ===

Example of simple game where player take turns

<pre>
if ( !defined('STATE_END_GAME')) { // guard since this included multiple times
define("STATE_PLAYER_TURN", 2);
define("STATE_GAME_TURN_NEXT_PLAYER", 3);
define("STATE_PLAYER_GAME_END", 4);
define("STATE_END_GAME", 99);
}

$machinestates = [
1 => [ // The initial state. Please do not modify.
"name" => "gameSetup",
"description" => "",
"type" => "manager",
"action" => "stGameSetup",
"transitions" => [ "" => STATE_PLAYER_TURN ] ],
// Game states
STATE_PLAYER_TURN => [ // main active player state
"name" => "playerTurn",
"description" => clienttranslate('${actplayer} must do something or pass'),
"descriptionmyturn" => clienttranslate('${you} must do something or pass'),
"type" => "activeplayer",
"args" => "arg_playerTurn",
"possibleactions" => [ "dosomething","pass" ],
"transitions" => [ "next" => STATE_GAME_TURN_NEXT_PLAYER,"last" => STATE_PLAYER_GAME_END ] //
],
STATE_GAME_TURN_NEXT_PLAYER => [ // next player state
"name" => "gameTurnNextPlayer",
"description" => clienttranslate('Upkeep...'),
"type" => "game", //
"action" => "st_gameTurnNextPlayer", //
"updateGameProgression" => true,
"transitions" => [ "next" => STATE_PLAYER_TURN,"loopback" => STATE_GAME_TURN_NEXT_PLAYER,
"last" => STATE_PLAYER_GAME_END ], // TODO replace with STATE_END_GAME, its there to use undo/restore during dev
],

STATE_PLAYER_GAME_END => [ // active player state for debugging end of game
"name" => "playerGameEnd",
"description" => clienttranslate('${actplayer} Game Over'),
"descriptionmyturn" => clienttranslate('${you} Game Over'),
"type" => "activeplayer",
"args" => "arg_playerTurn",
"possibleactions" => ["endGame"],
"transitions" => ["next" => STATE_END_GAME,"loopback" => STATE_PLAYER_GAME_END ] //
],
// End of Game states
// Final state.
// Please do not modify (and do not overload action/args methods).
STATE_END_GAME => [
"name" => "gameEnd",
"description" => clienttranslate("End of game"),"type" => "manager",
"action" => "stGameEnd",
"args" => "argGameEnd" ]

];

</pre>

Troubleshooting

2021-05-07T02:08:23Z

Kayvon: /* Unexpected error: Propagating error from GS 1 (method: createGame): BGA service error */

Describing common errors which is hard to understand and debug

__TOC__

== Game does not start at all ==

=== Undefined offset: 0 in table/table.game.php on line 830 ===

Check if you're calling self::getActivePlayerName () during setupNewGame()

Check if you're NOT calling self::activeNextPlayer() at the end of your game setup. You must always have at least one active player.

=== Unexpected error: Wrong formatted data from BGA gameserver 1 (method: createGame): ... ===

This is generic message usually followed by exact position in your source code, and usually its syntax error in one of yours php script

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Not logged ===

Calling self::getCurrentPlayerId () or using $g_user from 'args' state function, see also below

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Unknow player statistic: ===

Calling self::incStat() with second parameter which is an empty string

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: Error while processing SQL request: INSERT INTO stats ... ===

Fatal error during yourgame setup: Error while processing SQL request: INSERT INTO stats (stats_type, stats_player_id, stats_value) VALUES ('10','2300663','0'),('10','2300662','0')
Duplicate entry '10-2300663' for key 'stats_table_id'

Why? In the stats.inc.php you declared two keys with the same integer "id"

=== Unexpected error: Propagating error from GS 1 (method: createGame): Fatal error during yourgame setup: BGA main website do not respond ===

Check if other games work; if not, it's a problem with BGA Studio; if so, your game likely reaches an end state immediately. Check your states.inc.php and your transitions.

=== Unexpected error: Propagating error from GS 1 (method: createGame): BGA service error ===

You may have syntax error in your dbmodel.sql.

Or, you may be calling self::initStat() for a statistic that does not exist. Check the statistic name, and make sure you clicked "Reload statistics configuration" button in the admin console after making changes to stats.inc.php

Or you may not have your states.inc.php set up correctly.

=== Fatal error during creation of database ebd_quoridor_389 Not logged ===

Check that you didn't use $g_user or getCurrentPlayerId() in setupNewGame() function or in an 'args' function of your state.

As these functions are not consequences of a user action, there is no current player defined.

As a general rule, you should use getActivePlayerId() and not getCurrentPlayerId(). See the [http://www.slideshare.net/boardgamearena/bga-studio-focus-on-bga-game-state-machine presentation on the game state machine] for more information.

=== Warning: Invalid argument supplied for foreach() in table.game.php ===

Warning: Invalid argument supplied for foreach() in /var/tournoi/release/tournoi-151226-1240-gs/www/game/module/table/table.game.php on line 129
Fatal error: Cannot unset string offsets in /var/tournoi/release/tournoi-151226-1240-gs/www/game/module/table/table.game.php on line 143

That appears when your arg* function that suppose to return array of state arguments returns a scalar (a non-array) value

=== The server reported an error ===

During table creation: "The server reported an error" error shown and nothing else.

If you cannot even create a table - there is syntax error in gameinfos.php, check it, reload it from management panel.
If still no luck copy clean version from template https://github.com/elaskavaia/bga-sharedcode/blob/master/gameinfos.inc.php

== Game starts but I can't make a move ==

=== When I do a move, I got "Move recorded, waiting for update ..." forever ===

"Move recorded" means that your ajaxcall request has been sent to the server and returned normally.

"Waiting for update" means that your client interface is waiting for some notifications from the server that correspond to the move we just did.

If this message stays forever, it is probably that your PHP code does not send any notification when the move happens, which is abnormal. To fix this: add a notifyAllPlayers or a notifyPlayer call in your PHP code.

=== When I do a move, I get "Sending move to server..." then nothing and game resets to state before the move ===

Its possible that server code get into infinite loops or thinks too much, in which case it will timeout and will be aborted without any extra logs (and db transaction you saw in the log won't be committed). You will usually see "Unable to connect to server" message on console in this case. You have to put more logging into server
to trace where it hangs.

=== When I do a move, I get "Ajaxcall error: empty answer" ===

You either have missing self::ajaxResponse(); in your game.action.php method, or there is some problem with getting arguments (check that you are using btoa() on client when using AT_base64 arg type in action.php)

=== Some player action is triggered randomly when I click somewhere on the game area ===

You probably used "dojo.connect" on a null object. In this case, dojo.connect associate the event (ex: "onclick") to the whole game area.

Most of the time it happens in this situation, when my_object element does not exists:
<pre>
dojo.connect( $("my_object"), "onclick", this, (event)=>{})
</pre>

To determine if this is the case, place "alert( $("my_object") )" before the dojo.connect to check if the object exists or not.

=== "This is not your turn" error when I click on a possible move ===

You need to change to the active player by clicking the red arrow next to their name in the player panel (right side of the page).

[[File:Change_active_player.jpg]]

=== Please wait, an action is already in progress when I click on a possible move (Generated by checkAction / XXX) ===

This error is triggered in the JS by the checkAction holder for XXX.
This can happen when the player sent an Ajax request action earlier, but did not get an answer from the PHP side.
To avoid this, put an empty notifyPlayer in the PHP side of the Ajax handler to ensure the client receives a response.
This line of code should do it:
<pre>
$this->notifyPlayer($this->getCurrentPlayerId(), 'message', '', []); // sent to current player, who originated the action
</pre>

== Predefined server errors ==

=== Unexpected error: Unexpected final game state (XX) ===

The action function does not transition to any state, i.e.
function selectField($field) {
self::checkAction ( 'selectField' );
if ($field!=0) $this->gamestate->nextState ( 'next' );
}
Here if $field is 0 there is no transition

=== This game action is impossible right now ===

Check the game log. Usually your state does not define the action you trying to perform in 'possibleactions' array.

Also check your onActionName javascript function. Make sure you are calling the right "actionname.html".

=== Unexpected error: This transition (playerTurn) is impossible at this state (42) ===

This is pretty self explanatory. Function nextState() takes transition name not a state name, so you probably did not
define this transition that the given state

== Game interface hangs during reload or on start ==

Showing "Application Loading..."

=== Javascript error: During pageload undefined no_stack_avail Script: ===

This error usually has no useful data, but it means you called somes API that require a callback and did not define callback function, i.e
in dojo.connect, this.connectClass, dojo.subscribe, etc

this.connectClass('field', 'onclick', 'onField'); // <-- onField is not defined

=== Other errors with "Application loading..." ===

You probably have a syntax error in your Javascript code, and the interface refuses to load.

To find this error, check if there is an error message in the Javascript console (F12).

If there is really nothing on the log, it's probably that the system was unable to load your Javascript because of an syntax error that affect the structure of the Javascript file, typically a missing "}" or a missing "," after a method definition.

If you have "Uncaught ReferenceError: bgagame is not defined" you have major syntax error in your js file, you should see some other clues in the log where the errors is.

If you have "dojo.publish is not defined" or something similar, this could be caused by another error earlier. For example, a syntax error caused by a malformed generated file (such as using newlines in tiebreaker description). Also you might have left some images in the /img directory with special characters in the name which must be removed. If you edited images for the game box and website, ensure that you have not left any unnecessary files there.

=== Unexpected Syntax Error: ===

No further details in the log. When log is filling with some social connect errors.

Possible Reason: Syntax error in of the php script which is loaded before the start, such as gameoptions.inc.php, gameinfos.inc.php and such.

=== Game interface spins in a loop throwing error ===

Errors is something like "Cannot read property 'is_ai' of undefined". Cannot restart the game because cannot access UI to stop.
Likely you get in actplayer state with player id == 0. The only way to fix it is to edit database, globals index == 2 set player id to one of your test dudes
(can copy from row 5 for example).

=== Unable to find table database (1): ebd_yourgame_112222 ===

Its either temporarily server error especially on studio it timeouts sometimes, just try reloading again.
Or check if you have syntax errors in your php game file or sql.

== Type conversion / juggling errors ==

=== On php side I get a number instead of string I expect ===

$num = 3;
$meeple = "meeple_" + $num; // <-- suppose to be "meeple_3"!

When you switch between JS and PHP it easy to type this and not notice the +. Plus sign (+) in php does not mean string concatenation (in javascript does!),
in php + means integer arithmetic. So change + to . (dot)

=== On php side my string comparison does not work ===

if ($color == '4baae2' || $color == '000000') {
}

Apparently you should not be using '==' in php to compare strings! You should use '==='. The (==) operator will typecast the strings
to numbers then do comparison!
Its not very apparent because usually you can get away with it, but not when strings resemble numbers like hex 'colors'.

=== Integer columns in the database are returned as strings ===

This is normal PHP behavior. All fields are returned as string type, regardless of their actual type in the database. This also applies to global variables accessed via getGameStateValue(), since they are stored in a database table.

You can use type-casting to convert them to the correct type after they come out of the database.

$myValueInt = (int)self::getGameStateValue(GLOBAL_ROUND_NUMBER);

or

$myValueInt = self::getGameStateValue(GLOBAL_ROUND_NUMBER) + 0; // adding 0 casts to int

same with direct qdb ueries
$sql = "SELECT my_int_column FROM my_table WHERE my_condition";
$myResult = self::getUniqueValueFromDB($sql); <-- this is a string
$myResultAsInt = (int)$myResult;

https://stackoverflow.com/questions/5323146/mysql-integer-field-is-returned-as-string-in-php

== Zombie mode ==

=== Unexpected error: Propagating error from GS 1 (method: zombie): Not logged ===

You are probably calling getCurrentPlayerId() or getCurrentPlayerName() in your zombieTurn method or any of the methods it uses. Instead, use the $active_player_id provided as parameter to zombieTurn().

=== Unexpected error: Can't manage zombie player in this game state ===

Despite what the message suggests, this error has nothing to do with your state machine. It is caused by an exception in the zombie code. It could be an undefined value sent to a database query. Check the unexpected exceptions log. It could also be the same problem as above, so look for getCurrentPlayerId() or getCurrentPlayerName() in your zombieTurn method.

=== Unexpected error: Wrong formatted data from BGA gameserver 1 (method: zombie): ===

This is almost certainly an undefined value in PHP code. Look for a warning or error message in the game replay log on the right side of the table UI.

=== Unexpected error: BGA gameserver 1 do not respond (method: zombie) (timeout: cluster) ===

You are trying to end the game from a zombie method. This is not allowed. The zombie logic must continue the game as best it can. See [[Main_game_logic:_yourgamename.game.php#Zombie_mode|Zombie mode]] for more info.

=== Game unexpectedly ends when one player becomes zombie ===

There is an error in handling zombie mode, check error log. Example: if the zombie turn is called again, framework detects a infinite loop and cancels the game. On the studio there is a notification called ZombieTurnFailed

== Other errors ==

=== Javascript does not know how to sum two numbers ===

Be careful when you manipulate integers returned by notifications: most of the time, Javascript considers they are Strings and not Integers.

As a result:
<pre>
var i=1;
i += notif.args.increment; // With notif.args.increment='1'
alert( i ); // i=11 instead of 2 !! Javascript concatenate 2 strings !
</pre>

To solve this, you should use the "toint" function:
<pre>
var i=1;
i += toint( notif.args.increment ); // With notif.args.increment='1'
alert( i ); // i=2 :)
</pre>

=== Javascript: do not use substr with negative numbers ===

To get the last characters of a string, use "slice" instead of "substr" which has a bug on IE:
<pre>
var three_last_characters = string.substr( -3 ); // Wrong
var three_last_characters = string.slice( -3 ); // Correct
</pre>

=== Game "spontaneously" transition to a new state without user input ===

Make sure on php side you have no code after $this->gamestate->nextState(...) code.
Because if you do accidentally have code that goes to another state it will cause another state transition without user interaction.

function selectField($field) {
self::checkAction ( 'selectField' );
if ($field!=0) $this->gamestate->nextState ( 'next' );
$this->gamestate->nextState ( 'last' ); // <-- here is missing else, so it will cause double state transition
}