Board Game Arena - User contributions [en]

Gamehelpringyo

2026-06-26T06:39:06Z

C12h22o11:

== Ringyō ==
In Ringyō, players act as Daimyos to manage the forest in the province of feudal Japan. They manage their Province (their personal player board) to grow and harvest trees, build structures, and fulfill demands. The game is played over 5 rounds, and the player with the most Honor Points (HP) at the end of the game wins.

Each round consists of 4 phases:
* '''Edo Phase:''' Secret card selection to determine turn order and draft round bonuses (Shogun's Gifts).
* '''Province Phase:''' Simultaneous worker placement to plant, grow, cut trees, harvest rice, and construct buildings.
* '''Weather Phase:''' Weather effects are resolved, triggering tree growth, rice harvesting, and flooding throughout the province.
* '''Demands Phase:''' Spending resources to claim scoring spots on shared demand tiles. (There is no Demands phase in solo mode.)

== Sequence of a Round ==

=== Phase 1: Edo Council Phase (Turn Order & Drafting) ===
Players bid to establish turn order and draft Shogun's Gifts:
* '''Play Diplomat:''' Players secretly choose one of their 6 Diplomat cards (valued #1 to #6). Playing the #6 card requires paying 2 Rice.
* '''Draft Gifts:'''
** At the beginning of each round, gift cards are dealt to the shared Edo board.
** In solo mode, the 1-2 cards provide access to the rightmost gift card. 3-4 provide access to the middle and right gift card. 5-6 provide access to all 3 gift cards.
* Used diplomat cards remain face up on the table and cannot be played again for the rest of the game.

=== Province Phase ===
Players simultaneously place workers on open intersections (junctions where 3 land areas meet) to activate adjacent land areas. Workers may then take 1, 2, or 3 actions in adjacent area. Each worker may only take 1 action in each adjacent area (e.g. you cannot cut and then plant in the same space)

==== Worker Types ====
* '''Yellow Samurai:''' Permanent worker (returned to you at round end). Can take an action in 2 adjacent areas.
* '''Green Samurai:''' Upgraded permanent worker. Can take an action in 3 adjacent areas.
* '''Artisans:''' Temporary worker (returned to the supply at round end). Can take an action in 2 adjacent areas.
* '''Villagers:''' Temporary worker (returned to the supply at round end). Can take an action in 1 adjacent area and is limited to basic actions only.

==== Actions (Max 1 action per worker per adjacent area) ====
* '''Plant (Basic - All Workers):''' Add a height-1 tree of the matching area type to an empty or flooded land area.
* '''Grow (Basic - All Workers):''' Add 1 segment to a tree in that land area (max height 5).
* '''Cut (Basic - All Workers):''' Harvest all segments of a tree in that land area, placing the wood in your storage.
* '''Harvest (Basic - All Workers):''' Gain 1 Rice from a Rice Paddy land area (or 2 Rice if a Farm is built on it).
* '''Create Rice Paddy (Artisans/Samurai only):''' Flip a flood token in that land space to its Rice Paddy side.
* '''Build (Artisans/Samurai only):''' Construct a structure by paying wood segments of the matching tree type from your storage.
* '''Muster (Samurai only):''' Gain 2 military tokens (must be performed at a Fortress).
* '''Study (Samurai only):''' Examine an adjacent tree of matching type and height to meet your next Forestry Track requirement, advancing your marker and gaining the indicated rewards.

==== Special Actions (No worker required, can be done at any time) ====
* '''Split:''' Divide a stored tree segment into smaller segments.
* '''Join:''' Pay 1 Rice to combine stored segments of the same tree type.
* '''Hire:''' Pay 2 Rice to gain a temporary Villager worker.
* '''Expand:''' Spend 3 military tokens to draw a bonus land tile and add it to your board, creating new intersections.
* '''Foresee:''' Spend 1 research token to peek at one of the unrevealed Weather cards for the round.
* '''Shogun's Favor:''' In solo mode, Shogun's Favor cards are used to discard the current solo goal and move to the next one.

==== Building Rules ====
In order to build, you must have the exact indicated trees types and sized in your personal storage (shown on your building board). The bottom row of structures are available at the start of the game. Building structures unlocks building adjacent structures above or next to previously built structures. When building, place a token from your Structure board into the activated land area. Completing a row, column, or certain adjacent structure tiles from the building board provides a bonus indicated.
* '''Fortress:''' Must be built in an empty land area. Generates 1 military token at the start of each Weather Phase and unlocks the Muster action.
* '''Farm:''' Must be built on top of a Rice Paddy. Doubles rice production during Harvest or the Weather Phase.
* '''Row costs:''' Building on the top 3 rows of your province have an additional rice cost indicated on the board.

=== Phase 3: Weather Phase (Growth & Floods) ===
* '''Fortresses:''' Gain 1 military token for each built Fortress.
* '''Resolve Weather Cards:''' Reveal Weather cards one at a time. Each card matches a tree type (as indicated or as forecast on the forecast card) and triggers one of two events:
** '''Rain:'''
*** All trees of that type grow by 1 segment (max 5).
*** Rice Paddies produce 1 rice
*** Farms produce 2 rice.
** '''Flood:''' Empty or flooded areas of that type gain a flood token.
* '''Cascades:''' If a land area would gain a second flood token, it cascades down-slope. One flood token slides diagonally downwards to an adjacent lower land area based on the Forecast card.
** A flood cannot cascade into an already flooded land area.
** If a flood cascades onto a tree, rice paddy, or structure, that tile is removed from the province.

== Endgame Scoring ==
At the end of Round 5, players calculate their total Honor Points:
* '''Structures Built:''' HP printed under each built structure on your Structure Board (including those destroyed by floods).
* '''Trees in Province:''' Cumulative HP based on levels unlocked on your Forestry Track (e.g., +1 HP per tree of height 4+ / 3+ / 2+).
* '''Demands:''' HP from your completed Shogun's Demands
* '''Favor Cards:''' HP from up to 3 completed personal goal cards.

The highest score wins. Ties are broken by the player who completed the most demands.

== Solo Mode Rules ==

=== Solo Phases ===
* '''Council Phase Drafting:''' Your diplomat card limits which of the 3 face-up Gifts you can draft:
** #1 or #2 Diplomat: Draft the right-most gift.
** #3 or #4 Diplomat: Draft the middle or right-most gift.
** #5 or #6 Diplomat: Draft any of the three gifts.
* '''Fulfilling Demands:''' The Shogun's demands are placed around the solo board, with 4 Shogun's demands face up (and 4 to be revealed later). Fulfill demands at any time during your turn by paying resources. You can only fulfill a demand tile that is adjacent/linked to the Samurai's current position. Fulfilling a demand moves the Samurai to that tile, places your token, and flips adjacent linked demands face-up.
* '''Scoring Goals:''' In the center of the solo board, there are 10 solo goals. At the start of the game, one is active, one is revealed as the next solo goal, and the remaining 8 are face down under the "next" solo goal. The active solo goal can only be scored when the Samurai is standing on an outer demand tile. If your Province meets the goal requirement, score it (4 HP), move the Samurai back to the center of the Solo Board (re-opening all face-up demands), and reveal the next goal.
* '''Winning Condition:''' Beat the Target Score at the end of the game:
** Target Score = (10 HP × Fulfilled Demands) + (20 HP × Unfulfilled Demands) + (2 × Value of your unused diplomat card).
* '''Hard Mode:''' Uses the B-side Solo Board with fewer connections between demands and quadruples the unused diplomat card penalty.

Gamehelpringyo

2026-06-26T00:17:43Z

C12h22o11: more clear solo goal rules

== Ringyō ==
In Ringyō, players act as Daimyos to manage the forest in the province of feudal Japan. They manage their Province (their personal player board) to grow and harvest trees, build structures, and fulfill demands. The game is played over 5 rounds, and the player with the most Honor Points (HP) at the end of the game wins.

Each round consists of 4 phases:
* '''Edo Phase:''' Secret card selection to determine turn order and draft round bonuses (Shogun's Gifts).
* '''Province Phase:''' Simultaneous worker placement to plant, grow, cut trees, harvest rice, and construct buildings.
* '''Weather Phase:''' Weather effects are resolved, triggering tree growth, rice harvesting, and flooding throughout the province.
* '''Demands Phase:''' Spending resources to claim scoring spots on shared demand tiles. (There is no Demands phase in solo mode.)

== Sequence of a Round ==

=== Phase 1: Edo Council Phase (Turn Order & Drafting) ===
Players bid to establish turn order and draft Shogun's Gifts:
* '''Play Diplomat:''' Players secretly choose one of their 6 Diplomat cards (valued #1 to #6). Playing the #6 card requires paying 2 Rice.
* '''Draft Gifts:'''
** At the beginning of each round, gift cards are dealt to the shared Edo board.
** In solo mode, the 1-2 cards provide access to the rightmost gift card. 3-4 provide access to the middle and right gift card. 5-6 provide access to all 3 gift cards.
* '''Diplomat Lock:''' Used diplomat cards remain face up on the table and cannot be played again for the rest of the game.

=== Province Phase ===
Players simultaneously place workers on open intersections (junctions where 3 land spaces) to activate adjacent land areas. Workers must be placed at an intersection with 3 adjacent land tiles.

==== Worker Types ====
* '''Yellow Samurai:''' Permanent worker (returned to you at round end). Can take an action in 2 adjacent areas.
* '''Green Samurai:''' Upgraded permanent worker. Can take an action in 3 adjacent areas.
* '''Artisans:''' Temporary worker (returned to the supply at round end). Can take an action in 2 adjacent areas.
* '''Villagers:''' Temporary worker (returned to the supply at round end). Can take an action in 1 adjacent area and is limited to basic actions only.

==== Actions (Max 1 action per worker per adjacent area) ====
* '''Plant (Basic - All Workers):''' Add a height-1 tree of the matching area type to an empty or flooded land area.
* '''Grow (Basic - All Workers):''' Add 1 segment to a tree in that land area (max height 5).
* '''Cut (Basic - All Workers):''' Harvest all segments of a tree in that land area, placing the wood in your storage.
* '''Harvest (Basic - All Workers):''' Gain 1 Rice from a Rice Paddy land area (or 2 Rice if a Farm is built on it).
* '''Create Rice Paddy (Artisans/Samurai only):''' Flip a flood token in that land space to its Rice Paddy side.
* '''Build (Artisans/Samurai only):''' Construct a structure by paying wood segments of the matching tree type from your storage.
* '''Muster (Samurai only):''' Gain 2 military tokens (must be performed at a Fortress).
* '''Study (Samurai only):''' Examine an adjacent tree of matching type and height to meet your next Forestry Track requirement, advancing your marker and gaining the indicated rewards.

==== Special Actions (No worker required, can be done at any time) ====
* '''Split:''' Divide a stored tree segment into smaller segments.
* '''Join:''' Pay 1 Rice to combine stored segments of the same tree type.
* '''Hire:''' Pay 2 Rice to gain a temporary Villager worker.
* '''Expand:''' Spend 3 military tokens to draw a bonus land tile and add it to your board, creating new intersections.
* '''Foresee:''' Spend 1 research token to peek at one of the unrevealed Weather cards for the round.
* '''Shogun's Favor:''' In solo mode, Shogun's Favor cards are used to discard the current solo goal and move to the next one.

==== Building Rules ====
In order to build, you must have the exact indicated trees types and sized in your personal storage (shown on your building board). The bottom row of structures are available at the start of the game. Building structures unlocks building adjacent structures above or next to previously built structures. When building, place a token from your Structure board into the activated land area. Completing a row, column, or certain adjacent structure tiles from the building board provides a bonus indicated.
* '''Fortress:''' Must be built in an empty land area. Generates 1 military token at the start of each Weather Phase and unlocks the Muster action.
* '''Farm:''' Must be built on top of a Rice Paddy. Doubles rice production during Harvest or the Weather Phase.
* '''Row costs:''' Building on the top 3 rows of your province have an additional rice cost indicated on the board.

=== Phase 3: Weather Phase (Growth & Floods) ===
* '''Fortresses:''' Gain 1 military token for each built Fortress.
* '''Resolve Weather Cards:''' Reveal Weather cards one at a time. Each card matches a tree type (as indicated or as forecast on the forecast card) and triggers one of two events:
** '''Rain:'''
*** All trees of that type grow by 1 segment (max 5).
*** Rice Paddies produce 1 rice
*** Farms produce 2 rice.
** '''Flood:''' Empty or flooded areas of that type gain a flood token.
* '''Cascades:''' If a land area would gain a second flood token, it cascades down-slope. One flood token slides diagonally downwards to an adjacent lower land area based on the Forecast card.
** A flood cannot cascade into an already flooded land area.
** If a flood cascades onto a tree, rice paddy, or structure, that tile is removed from the province.

== Endgame Scoring ==
At the end of Round 5, players calculate their total Honor Points:
* '''Structures Built:''' HP printed under each built structure on your Structure Board (including those destroyed by floods).
* '''Trees in Province:''' Cumulative HP based on levels unlocked on your Forestry Track (e.g., +1 HP per tree of height 4+ / 3+ / 2+).
* '''Demands:''' HP from your completed Shogun's Demands
* '''Favor Cards:''' HP from up to 3 completed personal goal cards.

The highest score wins. Ties are broken by the player who completed the most demands.

== Solo Mode Rules ==

=== Solo Phases ===
* '''Council Phase Drafting:''' Your diplomat card limits which of the 3 face-up Gifts you can draft:
** #1 or #2 Diplomat: Draft the right-most gift.
** #3 or #4 Diplomat: Draft the middle or right-most gift.
** #5 or #6 Diplomat: Draft any of the three gifts.
* '''Fulfilling Demands:''' The Shogun's demands are placed around the solo board, with 4 Shogun's demands face up (and 4 to be revealed later). Fulfill demands at any time during your turn by paying resources. You can only fulfill a demand tile that is adjacent/linked to the Samurai's current position. Fulfilling a demand moves the Samurai to that tile, places your token, and flips adjacent linked demands face-up.
* '''Scoring Goals:''' In the center of the solo board, there are 10 solo goals. At the start of the game, one is active, one is revealed as the next solo goal, and the remaining 8 are face down under the "next" solo goal. The active solo goal can only be scored when the Samurai is standing on an outer demand tile. If your Province meets the goal requirement, score it (4 HP), move the Samurai back to the center of the Solo Board (re-opening all face-up demands), and reveal the next goal.
* '''Winning Condition:''' Beat the Target Score at the end of the game:
** Target Score = (10 HP × Fulfilled Demands) + (20 HP × Unfulfilled Demands) + (2 × Value of your unused diplomat card).
* '''Hard/Expert Modes:''' Uses the B-side Solo Board with fewer connections between demands and quadruples the unused diplomat card penalty.

Gamehelpringyo

2026-06-25T18:22:57Z

C12h22o11: Created page with " In Ringyō, players act as Daimyos to manage the forest in the province of feudal Japan. They manage their Province (their personal player board) to grow and harvest trees, build structures, and fulfill demands. The game is played over 5 rounds, and the player with the most Honor Points (HP) at the end of the game wins. -------------------------------- Each round consists of 4 phases: Edo Phase: Secret card selection to determine turn order and draft round bonuse..."

In Ringyō, players act as Daimyos to manage the forest in the province of feudal Japan. They manage their Province (their personal player board) to grow and harvest trees, build structures, and fulfill demands. The game is played over 5 rounds, and the player with the most Honor Points (HP) at the end of the game wins.

--------------------------------
Each round consists of 4 phases:

Edo Phase: Secret card selection to determine turn order and draft round bonuses (Shogun's Gifts).
Province Phase: Simultaneous worker placement to plant, grow, cut trees, harvest rice, and construct buildings.
Weather Phase: Weather effects are resolved, triggering tree growth, rice harvesting, and flooding throughout the province.
Demands Phase: Spending resources to claim scoring spots on shared demand tiles. (There is no Demands phase in solo mode.)

-------------------
Sequence of a Round
Phase 1: Edo Council Phase (Turn Order & Drafting)

Players bid to establish turn order and draft Shogun's Gifts:

Play Diplomat: Players secretly choose one of their 6 Diplomat cards (valued #1 to #6). Playing the #6 card requires paying 2 Rice.
Draft Gifts:
At the beginning of each round, gift cards are dealt to the shared Edo board.
In solo mode, the 1-2 cards provide access to the rightmost gift card. 3-4 provide access to the middle and right gift card. 5-6 provide access to all 3 gift cards.
Diplomat Lock: Used diplomat cards remain face up on the table and cannot be played again for the rest of the game.

--------------
Province Phase

Players simultaneously place workers on open intersections (junctions where 3 land spaces) to activate adjacent land areas. Workers must be placed at an intersection with 3 adjacent land tiles.

Worker Types

Yellow Samurai: Permanent worker (returned to you at round end). Can take an action in 2 adjacent areas.
Green Samurai: Upgraded permanent worker. Can take an action in 3 adjacent areas.
Artisans: Temporary worker (returned to the supply at round end). Can take an action in 2 adjacent areas.
Villagers: Temporary worker (returned to the supply at round end). Can take an action in 1 adjacent area and is limited to basic actions only.

Actions (Max 1 action per worker per adjacent area)

Plant (Basic - All Workers): Add a height-1 tree of the matching area type to an empty or flooded land area.
Grow (Basic - All Workers): Add 1 segment to a tree in that land area (max height 5).
Cut (Basic - All Workers): Harvest all segments of a tree in that land area, placing the wood in your storage.
Harvest (Basic - All Workers): Gain 1 Rice from a Rice Paddy land area (or 2 Rice if a Farm is built on it).
Create Rice Paddy (Artisans/Samurai only): Flip a flood token in that land space to its Rice Paddy side.
Build (Artisans/Samurai only): Construct a structure by paying wood segments of the matching tree type from your storage.
Muster (Samurai only): Gain 2 military tokens (must be performed at a Fortress).
Study (Samurai only): Examine an adjacent tree of matching type and height to meet your next Forestry Track requirement, advancing your marker and gaining the indicated rewards.

Special Actions (No worker required, can be done at any time)

Split: Divide a stored tree segment into smaller segments.
Join: Pay 1 Rice to combine stored segments of the same tree type.
Hire: Pay 2 Rice to gain a temporary Villager worker.
Expand: Spend 3 military tokens to draw a bonus land tile and add it to your board, creating new intersections.
Foresee: Spend 1 research token to peek at one of the unrevealed Weather cards for the round.

Building Rules

In order to build, you must have the exact indicated trees types and sized in your personal storage (shown on your building board). The bottom row of structures are available at the start of the game. Building structures unlocks building adjacent structures above or next to previously built structures. When building, place a token from your Structure board into the activated land area. Completing a row, column, or certain adjacent structure tiles from the building board provides a bonus indicated.

Fortress: Must be built in an empty land area. Generates 1 military token at the start of each Weather Phase and unlocks the Muster action.
Farm: Must be built on top of a Rice Paddy. Doubles rice production during Harvest or the Weather Phase.
Row costs: Building on the top 3 rows of your province have an additional rice cost indicated on the board.

Phase 3: Weather Phase (Growth & Floods)

Income: Gain 1 military token for each built Fortress.
Resolve Weather Cards: Reveal Weather cards one at a time. Each card matches a tree type (as indicated or as forecast on the forecast card) and triggers one of two events:
Rain:
All trees of that type grow by 1 segment (max 5).
Rice Paddies produce 1 rice
Farms produce 2 rice.
Flood: Empty or flooded areas of that type gain a flood token.
Cascades: If a land area would gain a second flood token, it cascades down-slope. One flood token slides diagonally downwards to an adjacent lower land area based on the Forecast card.
A flood cannot cascade into an already flooded land area.
If a flood cascades onto a tree, rice paddy, or structure, that tile is removed from the province.

---------------
Endgame Scoring

At the end of Round 5, players calculate their total Honor Poiints:

Structures Built: HP printed under each built structure on your Structure Board (including those destroyed by floods).
Trees in Province: Cumulative HP based on levels unlocked on your Forestry Track (e.g., +1 HP per tree of height 4+ / 3+ / 2+).
Demands: HP from your completed Shogun's Demands
Favor Cards: HP from up to 3 completed personal goal cards.

The highest score wins. Ties are broken by the player who completed the most demands.

------------------
Solo Mode Rules

Solo Phases

Council Phase Drafting: Your diplomat card limits which of the 3 face-up Gifts you can draft:
#1 or #2 Diplomat: Draft the right-most gift.
#3 or #4 Diplomat: Draft the middle or right-most gift.
#5 or #6 Diplomat: Draft any of the three gifts.

Fulfilling Demands: Fulfill demands at any time during your turn by paying resources. You can only fulfill a demand tile that is adjacent/linked to the Samurai's current position. Fulfilling a demand moves the Samurai to that tile, places your token, and flips adjacent linked demands face-up.

Scoring Goals: The active solo goal can only be scored when the Samurai is standing on a outer demand tile. If your Province meets the goal requirement, score it (4 HP), move the Samurai back to the center of the Solo Board (re-opening all face-up demands), and reveal the next goal.

Winning Condition: Beat the Target Score at the end of the game:
Target Score = (10 HP × Fulfilled Demands) + (20 HP × Unfulfilled Demands) + (2 × Value of your unused diplomat card).

Hard/Expert Modes: Uses the B-side Solo Board with fewer connections between demands and quadruples the unused diplomat card penalty.

Troubleshooting

2024-06-27T19:42:26Z

C12h22o11: /* Unexpected Syntax Error: */

Describing common errors which are hard to understand and debug. This may be useful for troubleshooting.

__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

Server syntax error:
Warning: Invalid argument supplied for foreach() in /var/tournoi/release/tournoi-240320-1000-gs/www/game/module/table/table.game.php on line 3249

Check that notfication you sending have args method supplied, i.e

$this->notifyAllPlayers('message', "", []); // 3rd argument MUST be array and MANDATORY

=== 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";
}

=== "Ooooops, this page does not exists :/" ===
If your table is created, but you are redirected to <code><nowiki>https://studio.boardgamearena.com/1/index.php</nowiki></code> when you try to launch your table, then you are most likely missing the [[Players actions: yourgamename.action.php|action PHP file]].

No other error is displayed or logged, meaning this can be tough to debug.

Make sure the file is correctly named, as any typo means the studio won't be able to find the file.

=== HTTP Error 500 (when the BGA server is stable) ===

The table has been created, but the setup hasn't been finished properly for some reason.

== 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 (bgaPerformAction) 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.

You may also see this error in the log in this case: "Error (2006) while processing SQL request: MySQL server has gone away"

=== 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)

=== When I do a move, I get "Gameserver is locked by configuration". ===

You may have an error in your AJAX path, such as /reversi/reversi when your game's name is different.

=== 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

=== 502 Bad Gateway ===
This error is similar to the infinite loop just above this section, but the loop occurred in view.php or somewhere unusual (e.g. module).

== 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

=== Javascript error: During pageload n is null ===

When calling dojo.place(), the name of the container (second parameter) to place the new block into is not defined in the page template.

=== 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. This can also occur if the gamedatas returned from getAllDatas() in *.game.php contains objects that cannot be properly serialized. For example, a class that defines functions as well as scalars.

=== 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

== Dead locks ==

=== Database dead lock in multiplayer state ===
You normally won't see this error until game is released because to reproduce game it have to be hit with 2 players doing an action simultaneosly.
You only can reprodoce this on studio if you either very fast or you use a script (with direct REST calls).

There is few types of deadlocks
I) Try-lock - this one you don't need to worry about even it does appear in the log, this is 2 player doing the action and second cannot lock db, it will re-try up to 3 times and hopefully it be ok
II) Real dead lock - when 2 tables are locked in reversed by 2 actions, its unclar if this really happen but workaround number 2 theorically should solved it (but it will increase number of deadlocks of type I)

There are two known workarounds:

1) Use $this->bIndependantMultiactiveTable=true in constructor which will force usage of playermultiactive table, but this does not eliminate dead lock completely.

2) Before every action explictly lock tables in specific order (add this code in your game.php file)
<pre>
// Due to deadlock issues involving the playersmultiactive and player tables,
// standard tables are queried FOR UPDATE when any operation occurs -- AJAX or refreshing a game table.
//
// Otherwise at least two situations have been observed to cause deadlocks:
// * Multiple players in a live game with tabs open, two players trading multiactive state back and forth.
// * Two players trading multiactive state back and forth, another player refreshes their game page.
private function queryStandardTables() {
// Query the standard global table.
$this->DbQuery("SELECT global_id, global_value FROM global WHERE 1 ORDER BY global_id FOR UPDATE");
// Query the standard player table.
$this->DbQuery("SELECT player_id id, player_score score FROM player WHERE 1 ORDER BY player_id FOR UPDATE");
// Query the playermultiactive table. DO NOT USE THIS is you don't use $this->bIndependantMultiactiveTable=true
$this->DbQuery("SELECT ma_player_id player_id, ma_is_multiactive player_is_multiactive FROM playermultiactive ORDER BY player_id FOR UPDATE");

// TODO should the stats table be queried as well?
}

/** This is action function that canbe called from multiplayer state */
protected function actionXXX() {
$this->queryStandardTables();
... // your arg function code
}
/** This is arg function of multiplayer state, XXX is replaced by actual name of state.
You need to do it for EVERY arg function in multiplayer states which accesses the database.
You don't need to do it for arg function for single player states
*/
protected function argXXX() {
$this->queryStandardTables();
... // your arg function code
}
</pre>

== 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>
let i = 1;
i += notif.args.increment; // With notif.args.increment='1'
console.log( i ); // i=11 instead of 2 !! Javascript concatenate 2 strings !
</pre>

To solve this, you should use the "parseInt" function:
<pre>
let i = 1;
i += parseInt(notif.args.increment, 10); // With notif.args.increment='1'
console.log( 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), ...

=== Red banner "Uncaught EvalError: Possible side-effect in debug-evaluate" ===

This is a known issue that can be ignored (for most of case). Generally happening when working on devtool.
A workaround is to disable the "error" event listener. To do so, you can temporarily disable the event listener in DevTools, like this:

- At the top of DevTools, open the "Elements" tab
- Press "»", on the right of "Styles", "Computed", "Layout"
- Choose "Event listeners"
- Find and expand "error"
- Click "Remove"

This will remove the event listener, but the issue will return after you refresh the page.

[[Category:Studio]]

Bugsclarification distilled

2024-06-14T05:50:21Z

C12h22o11: Created page with " Before filing a bug report of being blocked from making a certain spirit, please ensure the spirit should have been distillable. These are in order of most commonly missed. 1) You have *ONLY* the correct type of sugars. Most recipes other than vodka and aquavit require just one type of sugar in the spirit. For example, If you try to make pisco (which requires 3 fruit sugars) and you have 4 fruit sugars, 4 alcohol, 1 yeast, and 1 mixed grains, you have made Vodka, not P..."

Before filing a bug report of being blocked from making a certain spirit, please ensure the spirit should have been distillable. These are in order of most commonly missed.

1) You have *ONLY* the correct type of sugars. Most recipes other than vodka and aquavit require just one type of sugar in the spirit. For example, If you try to make pisco (which requires 3 fruit sugars) and you have 4 fruit sugars, 4 alcohol, 1 yeast, and 1 mixed grains, you have made Vodka, not Pisco because of the mixed grains.
2) You have the correct barrel type in your store room
3) You have the correct number of sugars and the correct type of sugars.
4) You have purchased the recipe cube
5) If you are distilling a signature spirit, it must include a particular type of sugar, for example, Grapes or Potatoes. This can be your signature ingredient or an ingredient from the premium market.

Gamehelpdistilled

2024-06-13T20:41:03Z

C12h22o11: /* Differences Between Physical and BGA */

=== Differences Between Physical and BGA ===
Please be aware that there are a few meaningful differences between a physical copy of Distilled and the BGA implementation:

* On BGA, the distill phase is taken in player order. This is to facilitate the flow of the game, especially in asynchronous play. Each player distills their spirit and claims their label in player order starting with the first player token.
* On BGA, the Drone Camera is not part of the Distillery Upgrade deck.
* On BGA, the choice of flavor cards for Doig Ventilator is automated to pick the most valuable flavor.

===Overview===

Create, age, and sell Spirits in order to be the best distiller over 7 rounds

===Phases===

The rounds are broken up into 4 Phases

Market

Distill

Sell

Age

===Market===

In clockwise order, each player either makes a purchase or passes

Passing takes you out of the Market phase until all other players have passed, which ends the phase

You can purchase as much as you wish over this phase, but can only purchase a maximum of 2 basic items in each Market Phase. Purchases you can make are distillery upgrades, premium ingredients, premium items like bottles or barrels and recipes.

Your Recipe List shows you what grade a recipe is and thus how much it costs to purchase

===Distill===

In clockwise order, starting with the first player, select ingredients to put into your washback.

You may exchange an ingredient or premium item for a basic ingredient of equal or lower value once

All ingredients not being used are put in your Pantry

Make sure to play at least one Yeast, one Water, and one Sugar card otherwise you cannot distill

Add one Alcohol card for each Sugar card played

Shuffle all the cards together, the uppermost and lowest card are returned to the Pantry

The remaining cards are revealed and see if they match a Known Recipe

Vodka requires any sugar and Moonshine requires no sugar, so these are always available, but you are trying to aim for the better recipes if you can

Select the spirit you would like to make and claim a label for it if it is available.

===Sell===

If a Recipe you just distilled has the egg timer symbol, it cannot be sold in the same round

Alternatively, if a Recipe you just distilled has the red blocked egg timer symbol, it MUST be sold this round

Similar to the Market phase, this is done in turn order with each player making one sale per turn until everyone has passed

Check the cards relating to the Spirit you wish to sell and the total value is the money you will receive for the sale

If there are any SP icons on this, these are victory points you will also gain

Place the label on your bonus board and gain the bonus immediately

If you used the starting Metal Barrel or Glass Bottle, return this to your storeroom for later use

Place Premium Bottles in your display for end game points

Basic cards, Alcohol cards, Premium Ingredients, Flavor Cards, Signature Ingredients, and Premium barrels are all discarded

Selling an greater Aged Spirit will gain more points than a lesser aged spirit, but will still gain the same money

===Age===

Age all Spirits in your warehouse one step

If this is the last round, warehouse Spirits will still age, but cannot be sold, however there are still points for retained Spirits in warehouse

===Round End===

After Aging, check the Awards, if you achieve one gain the points and make it inactive

If multiple players gain the same Award, split the points evenly and make it inactive

If you made no sales this round, you can exchange up to 4 points into the same amount of money, but cannot transfer points you don't have

If this is round 3, discard one of your personal goals

Then change the starting player clockwise

===Game End===

The game ends at the end of the 7th round

Gain points for Spirits in your warehouse with a few changes, no flavor bonus, no label bonus, no bottle, no money

Gain points for displayed bottles of the same region and/or if you have 3 or more regions represented

Gain points from distillery upgrades if applicable

Gain points from personal goals you have achieved

Gain 1 point per 5 money remaining

The player with the most points, wins!

If tied, the player with the most money, wins!

Gamehelpdistilled

2024-05-26T15:10:52Z

C12h22o11: /* Game End */

=== Differences Between Physical and BGA ===
Please be aware that there are a few meaningful differences between a physical copy of Distilled and the BGA implementation:

* On BGA, the distill phase is taken in player order. This is to facilitate the flow of the game, especially in asynchronous play. Each player distills their spirit and claims their label in player order starting with the first player token.
* On BGA, the Drone Camera is not part of the Distillery Upgrade deck.

===Overview===

Create, age, and sell Spirits in order to be the best distiller over 7 rounds

===Phases===

The rounds are broken up into 4 Phases

Market

Distill

Sell

Age

===Market===

In clockwise order, each player either makes a purchase or passes

Passing takes you out of the Market phase until all other players have passed, which ends the phase

You can purchase as much as you wish over this phase, but can only purchase a maximum of 2 basic items in each Market Phase. Purchases you can make are distillery upgrades, premium ingredients, premium items like bottles or barrels and recipes.

Your Recipe List shows you what grade a recipe is and thus how much it costs to purchase

===Distill===

In clockwise order, starting with the first player, select ingredients to put into your washback.

You may exchange an ingredient or premium item for a basic ingredient of equal or lower value once

All ingredients not being used are put in your Pantry

Make sure to play at least one Yeast, one Water, and one Sugar card otherwise you cannot distill

Add one Alcohol card for each Sugar card played

Shuffle all the cards together, the uppermost and lowest card are returned to the Pantry

The remaining cards are revealed and see if they match a Known Recipe

Vodka requires any sugar and Moonshine requires no sugar, so these are always available, but you are trying to aim for the better recipes if you can

Select the spirit you would like to make and claim a label for it if it is available.

===Sell===

If a Recipe you just distilled has the egg timer symbol, it cannot be sold in the same round

Alternatively, if a Recipe you just distilled has the red blocked egg timer symbol, it MUST be sold this round

Similar to the Market phase, this is done in turn order with each player making one sale per turn until everyone has passed

Check the cards relating to the Spirit you wish to sell and the total value is the money you will receive for the sale

If there are any SP icons on this, these are victory points you will also gain

Place the label on your bonus board and gain the bonus immediately

If you used the starting Metal Barrel or Glass Bottle, return this to your storeroom for later use

Place Premium Bottles in your display for end game points

Basic cards, Alcohol cards, Premium Ingredients, Flavor Cards, Signature Ingredients, and Premium barrels are all discarded

Selling an greater Aged Spirit will gain more points than a lesser aged spirit, but will still gain the same money

===Age===

Age all Spirits in your warehouse one step

If this is the last round, warehouse Spirits will still age, but cannot be sold, however there are still points for retained Spirits in warehouse

===Round End===

After Aging, check the Awards, if you achieve one gain the points and make it inactive

If multiple players gain the same Award, split the points evenly and make it inactive

If you made no sales this round, you can exchange up to 4 points into the same amount of money, but cannot transfer points you don't have

If this is round 3, discard one of your personal goals

Then change the starting player clockwise

===Game End===

The game ends at the end of the 7th round

Gain points for Spirits in your warehouse with a few changes, no flavor bonus, no label bonus, no bottle, no money

Gain points for displayed bottles of the same region and/or if you have 3 or more regions represented

Gain points from distillery upgrades if applicable

Gain points from personal goals you have achieved

Gain 1 point per 5 money remaining

The player with the most points, wins!

If tied, the player with the most money, wins!

Summarised by https://boardgamearena.com/player?id=90078516

Gamehelpdistilled

2024-05-26T15:10:06Z

C12h22o11: /* Distill */

=== Differences Between Physical and BGA ===
Please be aware that there are a few meaningful differences between a physical copy of Distilled and the BGA implementation:

* On BGA, the distill phase is taken in player order. This is to facilitate the flow of the game, especially in asynchronous play. Each player distills their spirit and claims their label in player order starting with the first player token.
* On BGA, the Drone Camera is not part of the Distillery Upgrade deck.

===Overview===

Create, age, and sell Spirits in order to be the best distiller over 7 rounds

===Phases===

The rounds are broken up into 4 Phases

Market

Distill

Sell

Age

===Market===

In clockwise order, each player either makes a purchase or passes

Passing takes you out of the Market phase until all other players have passed, which ends the phase

You can purchase as much as you wish over this phase, but can only purchase a maximum of 2 basic items in each Market Phase. Purchases you can make are distillery upgrades, premium ingredients, premium items like bottles or barrels and recipes.

Your Recipe List shows you what grade a recipe is and thus how much it costs to purchase

===Distill===

In clockwise order, starting with the first player, select ingredients to put into your washback.

You may exchange an ingredient or premium item for a basic ingredient of equal or lower value once

All ingredients not being used are put in your Pantry

Make sure to play at least one Yeast, one Water, and one Sugar card otherwise you cannot distill

Add one Alcohol card for each Sugar card played

Shuffle all the cards together, the uppermost and lowest card are returned to the Pantry

The remaining cards are revealed and see if they match a Known Recipe

Vodka requires any sugar and Moonshine requires no sugar, so these are always available, but you are trying to aim for the better recipes if you can

Select the spirit you would like to make and claim a label for it if it is available.

===Sell===

If a Recipe you just distilled has the egg timer symbol, it cannot be sold in the same round

Alternatively, if a Recipe you just distilled has the red blocked egg timer symbol, it MUST be sold this round

Similar to the Market phase, this is done in turn order with each player making one sale per turn until everyone has passed

Check the cards relating to the Spirit you wish to sell and the total value is the money you will receive for the sale

If there are any SP icons on this, these are victory points you will also gain

Place the label on your bonus board and gain the bonus immediately

If you used the starting Metal Barrel or Glass Bottle, return this to your storeroom for later use

Place Premium Bottles in your display for end game points

Basic cards, Alcohol cards, Premium Ingredients, Flavor Cards, Signature Ingredients, and Premium barrels are all discarded

Selling an greater Aged Spirit will gain more points than a lesser aged spirit, but will still gain the same money

===Age===

Age all Spirits in your warehouse one step

If this is the last round, warehouse Spirits will still age, but cannot be sold, however there are still points for retained Spirits in warehouse

===Round End===

After Aging, check the Awards, if you achieve one gain the points and make it inactive

If multiple players gain the same Award, split the points evenly and make it inactive

If you made no sales this round, you can exchange up to 4 points into the same amount of money, but cannot transfer points you don't have

If this is round 3, discard one of your personal goals

Then change the starting player clockwise

===Game End===

The game ends at the end of the 7th round

Gain points for Spirits in your warehouse with a few changes, no flavor bonus, no label bonus, no bottle, no money

Gain points for displayed bottles of the same region

Gain points from distillery upgrades if applicable

Gain points from personal goals you have achieved

Gain 1 point per 5 money remaining

The player with the most points, wins!

If tied, the player with the most money, wins!

Summarised by https://boardgamearena.com/player?id=90078516

Gamehelpdistilled

2024-05-26T15:08:09Z

C12h22o11: Added differences with physical

=== Differences Between Physical and BGA ===
Please be aware that there are a few meaningful differences between a physical copy of Distilled and the BGA implementation:

* On BGA, the distill phase is taken in player order. This is to facilitate the flow of the game, especially in asynchronous play. Each player distills their spirit and claims their label in player order starting with the first player token.
* On BGA, the Drone Camera is not part of the Distillery Upgrade deck.

===Overview===

Create, age, and sell Spirits in order to be the best distiller over 7 rounds

===Phases===

The rounds are broken up into 4 Phases

Market

Distill

Sell

Age

===Market===

In clockwise order, each player either makes a purchase or passes

Passing takes you out of the Market phase until all other players have passed, which ends the phase

You can purchase as much as you wish over this phase, but can only purchase a maximum of 2 basic items in each Market Phase. Purchases you can make are distillery upgrades, premium ingredients, premium items like bottles or barrels and recipes.

Your Recipe List shows you what grade a recipe is and thus how much it costs to purchase

===Distill===

Simultaneously pick ingredients you wish to use this phase and put them in your Washback

You may exchange an ingredient or item for a basic ingredient of equal or lower value once

All ingredients not being used are put in your Pantry

Make sure to play at least one Yeast, one Water, and one Sugar card otherwise you cannot distill

Add one Alcohol card for each Sugar card played

Shuffle all the cards together, the uppermost and lowest card are returned to the Pantry

The remaining cards are revealed and see if they match a Known Recipe

Vodka requires any sugar and Moonshine requires no sugar, so these are always available, but you are trying to aim for the better recipes if you can

===Sell===

If a Recipe you just distilled has the egg timer symbol, it cannot be sold in the same round

Alternatively, if a Recipe you just distilled has the red blocked egg timer symbol, it MUST be sold this round

Similar to the Market phase, this is done in turn order with each player making one sale per turn until everyone has passed

Check the cards relating to the Spirit you wish to sell and the total value is the money you will receive for the sale

If there are any SP icons on this, these are victory points you will also gain

Place the label on your bonus board and gain the bonus immediately

If you used the starting Metal Barrel or Glass Bottle, return this to your storeroom for later use

Place Premium Bottles in your display for end game points

Basic cards, Alcohol cards, Premium Ingredients, Flavor Cards, Signature Ingredients, and Premium barrels are all discarded

Selling an greater Aged Spirit will gain more points than a lesser aged spirit, but will still gain the same money

===Age===

Age all Spirits in your warehouse one step

If this is the last round, warehouse Spirits will still age, but cannot be sold, however there are still points for retained Spirits in warehouse

===Round End===

After Aging, check the Awards, if you achieve one gain the points and make it inactive

If multiple players gain the same Award, split the points evenly and make it inactive

If you made no sales this round, you can exchange up to 4 points into the same amount of money, but cannot transfer points you don't have

If this is round 3, discard one of your personal goals

Then change the starting player clockwise

===Game End===

The game ends at the end of the 7th round

Gain points for Spirits in your warehouse with a few changes, no flavor bonus, no label bonus, no bottle, no money

Gain points for displayed bottles of the same region

Gain points from distillery upgrades if applicable

Gain points from personal goals you have achieved

Gain 1 point per 5 money remaining

The player with the most points, wins!

If tied, the player with the most money, wins!

Summarised by https://boardgamearena.com/player?id=90078516

Game layout: view and template: yourgamename.view.php and yourgamename yourgamename.tpl

2024-05-24T17:52:07Z

C12h22o11: addded new warning not to use ID

{{Studio_Framework_Navigation}}

== Overview ==
[[File:bga-pages-from-templates.PNG|700px]]

There are two files involved in overall game layout: yourgamename.view.php and yourgamename_yourgamename.tpl.

These files work together to provide the HTML layout of your game.

Using these 2 files, you specify what HTML is rendered in your game client interface.

In .tpl file you can directly write raw HTML that will be displayed by the browser.

Example: extract of "hearts_hearts.tpl":

<pre>
<div id="myhand_wrap" class="whiteblock">
<h3>{MY_HAND}</h3>
<div id="myhand">
</div>
</div>
</pre>

Things in curly braces are template variables. You cannot put any english text directly there.

Your view and your template are supposed to generate only the BASE layout of the game.

You shouldn't try to setup the current game situation in the view: this is the role of your Javascript code. Why? Because you'll have to write Javascript code to put game elements in place anyway, and you don't want to write it twice :)

Example of things to generate in your view:
* The overall layout of your game interface (what is displayed where).
* The board and fixed elements on the board (ex: places for cards, squares, ...).
* The tokens which are always on the board (but JS code may move them around during setup)

Example of things that shouldn't be generate by your view:
* Game elements that come and go from the game area.
* Game elements that normally hidden from players (other players cards, cards in the deck).

== Template system ==

BGA is using the phplib template system, used for example in PHPbb forums.

More details about how to use phplib template system here:
https://web.archive.org/web/20170506065401/http://www.phpbuilder.com:80/columns/david20000512.php3

== Variables ==

In your template (.tpl) file, you can use variables. Then in your view (.view.php) file, you fill these variables with values.

In the example above, "{MY_HAND}" is a variable. As you can see, a variable is uppercase characters surrounded by "{" and "}".

This is example of how to assign values to these variables in .view.php:

Examples:
<pre>

// Display a translated version of "My hand" at the place of the variable in the template
$this->tpl['MY_HAND'] = self::_("My hand");

// Display some raw HTML material at the place of the variable
$this->tpl['MY_HAND'] = self::raw( "<div class='myhand_icon'></div>" );

</pre>

WARNING: do not use a variable called {id} as it will interfere with action buttons.

WARNING: do not use a variable called {LB_[whatever]} as any variable starting with LB_ will interfere with the translation system.

WARNING: do not use a variable called {ID} as it could receive unexpected values.

== Template Blocks ==

Using "blocks", you can repeat a piece of HTML from your template several time.

You should use "blocks" whenever you have a block of HTML that must be repeated many times. For example, for ''Reversi'', we have to generate 64 (8x8) squares:

<pre>

(in reversi_reversi.tpl)

<div id="board">

<div id="square_{X}_{Y}" class="square" style="left: {LEFT}px; top: {TOP}px;"></div>


<div id="discs">
</div>
</div>

(in reversi.view.php)

$this->page->begin_block( "reversi_reversi", "square" );

$hor_scale = 64.8;
$ver_scale = 64.4;
for( $x=1; $x<=8; $x++ ) {
for( $y=1; $y<=8; $y++ ) {
$this->page->insert_block( "square", array(
'X' => $x,
'Y' => $y,
'LEFT' => round( ($x-1)*$hor_scale+10 ),
'TOP' => round( ($y-1)*$ver_scale+7 )
) );
}
}

</pre>

Explanations:
* You specify a block in your template file, using "BEGIN" and "END" keywords as xml comment. In the example above, we are creating a block named "square".
* In your view, you declare your block using "begin_block" method.
* Then, you can insert as many block as you want to, using "insert_block" method.

The insert_block method takes 2 parameters:
* the name of the block to insert.
* an associative array you can use to assign values to template variables of this block. In the example above, there are 4 parameters in the block (X, Y, LEFT and TOP).

== Nested blocks ==

You can use nested blocks. In the example below, we are going to add a mini-board for each player of the game, with 4 card places on each of it:

ggg_ggg.tpl file:

<pre>

<div class="miniboard" id="miniboard_{PLAYER_ID}">

<div class="card_places">

<div id="card_place_{PLAYER_ID}_{PLACE_ID}">
</div>

</div>

</div>

</pre>

ggg.view.php file:

<pre>
$this->page->begin_block( "mygame_mygame.tpl", "card_place" ); // Nested block must be declared first
$this->page->begin_block( "mygame_mygame.tpl", "player" );

foreach( $players as $player_id => $player ) {
// Important: nested block must be reset here, otherwise the second player miniboard will
// have 8 card_place, the third will have 12 card_place, and so one...
$this->page->reset_subblocks( 'card_place' );

for( $i=1; $i<=4; $i++ ) {
$this->page->insert_block( "card_place", array(
'PLAYER_ID' => $player_id,
'PLACE_ID' => $i
)
);
}

$this->page->insert_block( 'player', array( 'PLAYER_ID' => $player_id );
}

</pre>

== Conditional blocks ==
There is no if blocks but you can just have 2 blocks and make one to be "empty" i.e.
<pre>

<div id="something"></div>


<div id="something_else"></div>

</pre>
code in view.php
<pre>
if ($condition_a) {
// hide not_a
$this->page->begin_block("mygame_mygame.tpl", "not_a");
$this->page->insert_template( "not_a", '', []);
} else {
// hide a
$this->page->begin_block("mygame_mygame.tpl", "a");
$this->page->insert_template( "a", '', []);
}
</pre>
Note: if you need variable in these block do the insert_block on one that stays as usual

== Javascript templates ==

For game elements that come and go from the game area, we suggest you to define a Javascript template.

These will allow to separate all html from javascript and php files and keep it strictly in template file.

A Javascript template is defined in your template file like this:

(Reversi Token from Reversi example):
<pre>
<script type="text/javascript">

// Templates

var jstpl_disc='<div class="disc disccolor_${color}" id="disc_${xy}"></div>';

</script>
</pre>

Note: a section for javascript templates is already available at the end of your template skeleton file.

Then, you can use this javascript template to insert this piece of HTML in your game interface, like this:

<pre>
dojo.place( this.format_block( 'jstpl_disc', {
xy: x+''+y,
color: color
} ) , 'discs' );
</pre>

WARNING: always use lowercase for substitution variables in your Javascript templates, in order to avoid collision with phplib template variables (in particular, do not use ${ID}).

Note that '''you must translate''' any text arguments passed to ''this.format_block()'' that will be rendered on the screen, for example [[Translations#On_client_side_.28Javascript.29|using "_()"]].

== How to access game information from .view.php ==

From your .view.php, you can access the following:

=== Access current player id===

<pre>
global $g_user;
$current_player_id = $g_user->get_id();
</pre>

=== Access game object ===

In your view file, "$this->game" contains an instance of your main game class.

Example:
<pre>

// Access to some game elements description described in your "material.inc.php":
$my_cards_types = $this->game->card_types;

// Access to any (public) method defined in my .game.php file:
$result = $this->game->myMethod();
</pre>

=== Access spectator status ===

For spectators (players who are not part of the game but just spectating it) you must be careful of displaying all public information, but no private information.

In your view file, you can use $this->game->isSpectator() to know if the player is not part of the game, and adapt the interface to this case.

[[Category:Studio]]