Board Game Arena - Кориснички доприноси [sr]

Game options and preferences: gameoptions.inc.php

2018-05-21T19:07:41Z

Tchebychev:

In this file, you can define your game options (= game variants) and user preferences.

Note: If your game has no variants or preferences, you don't have to modify this file.

== Game Options ==

Game options is something selected by table creator and usually correspond to game variant, for example if game includes expansion or certain special rule.

These variants defined in gameoptions.inc.php as variable
$game_options = array(...); // exactly named that

Each option is pair number => 'option description array'.

All options defined in this file should have a corresponding "game state label" with the same ID (see "initGameStateLabels" in yourgame.game.php)

self::initGameStateLabels ( array (
...
"my_first_game_variant" => 100,
) );
That is how you access them during runtime.

The following are the parameters of option description array:
* '''name''' - '''mandartory'''. The name of the option visible for table creator. Value must be wrapped in totranslate function.
* '''values''' - '''mandartory'''. The array (map) of values with additional parameters per value.
** '''name''' - '''mandartory'''. String representation of the numeric value visible to table creator. Value must be wrapped in totranslate function.
** '''tmdisplay''' - String representation of the option visible in the table description, usually if variant "names" are On and Off, but the description would be same as option name when On, and nothing when Off.
** '''nobeginner''' - Set to true if not recommended for begginers
** '''beta''' - Option in beta stage on development
** '''premium''' - Option can be only used by premium members
* '''displaycondition''' - checks the conditions before displaying the option for selection. All conditions must be true for the option to display. Supported condition types:
** ''otheroption'' condition ensures another option is set to this given value. Framework options - 201 - ELO OFF.
* '''startcondition''' - checks the conditions before starting the game. All conditions must be true for the game to start, otherwise players will get a red error message when attempting to begin the game. Supported condition types:
** ''minplayers'' condition ensures at least this many players
** ''maxplayers'' conditions ensure at most this many players
** ''otheroption'' conditions ensure another option is set to this given value. That works the same as in '''displaycondition'''.
* '''notdisplayedmessage''' - if option is not suppose to be visible because of displaycondition but this is set, the text will be visible instead of combo drop down

<pre>
$game_options = array(
100 => array(
'name' => totranslate('my game option'),
'values' => array(
// A simple value for this option:
1 => array(
'name' => totranslate('option 1')
),

// A simple value for this option.
// If this value is chosen, the value of "tmdisplay" is displayed in the game lobby
2 => array(
'name' => totranslate('option 2'),
'tmdisplay' => totranslate('option 2')
),

// Another value, with other options:
// beta=true => this option is in beta version right now.
// nobeginner=true => this option is not recommended for beginners
3 => array(
'name' => totranslate('option 3'),
'beta' => true,
'nobeginner' => true
),
)
),

101 => array(
'name' => totranslate('Draft variant'),
'values' => array(
1 => array(
'name' => totranslate('No draft')
),
2 => array(
'name' => totranslate('Draft'),
'tmdisplay' => totranslate('Draft'),
'premium' => true,
'nobeginner' => true
),
),
'displaycondition' => array(
// Note: do not display this option unless these conditions are met
array(
'type' => 'otheroption',
'id' => 100, // Game specific option defined in the same array above
'value' => array(2, 3, 4)
),
// Note: do not display this option unless these conditions are met
array( 'type' => 'otheroption',
'id' => 201, // ELO OFF hardcoded framework option
'value' => 1 // 1 if OFF
)
),

'startcondition' => array(
1 => array(),
2 => array(
array(
'type' => 'maxplayers',
'value' => 3,
'message' => totranslate('Draft option is available for 3 players maximum.')
)
),
),
'disable' => true
),

102 => array(
'name' => totranslate('Takeovers'),
'values' => array(
2 => array(
'name' => totranslate('No takeover')
),
1 => array(
'name' => totranslate('Allow takeovers'),
'tmdisplay' => totranslate('Takeovers'),
'premium' => true,
'nobeginner' => true
),
),
'displaycondition' => array( // Note: do not display this option unless these conditions are met
array(
'type' => 'otheroption',
'id' => 100,
'value' => array(3, 4)
)
),
'startcondition' => array(
2 => array(),
1 => array(
array(
'type' => 'maxplayers',
'value' => 2,
'message' => totranslate('Rebel vs Imperium Takeover Scenario is available for 2 players only.')
)
),
),
'disable' => true
)
);
</pre>

Example of option that condition on ELO off

<pre>
$game_options = array(

100 => array(
'name' => totranslate('Learning Game (No Research)'),
'values' => array(

1 => array( 'name' => totranslate('Off'), 'tmdisplay' => totranslate('') ),
2 => array( 'name' => totranslate('On'), 'tmdisplay' => totranslate('Learning Game') ),

),
'displaycondition' => array(
// Note: do not display this option unless these conditions are met
array( 'type' => 'otheroption',
'id' => 201, // ELO OFF hardcoded framework option
'value' => 1, // 1 if OFF

)
),
'notdisplayedmessage' => totranslate('Learning variant available only with ELO off')
),

);
</pre>

IMPORTANT: After you edited and deployed this file you have to go to control panel and press "Reload game options configuration"

== User Preferences ==

User preferences is something cosmetic about the game interface which however can create user wars, so you can satisfy all user
by giving them individual preferences. Do not use this unless absolutely necessary and usually only after game has been in production
for a while. If you add these currently only admins can apply these settings, so you would have to contact them after editing this file.

<pre>
$game_preferences = array(
100 => array(
'name' => totranslate('Notation style'),
'needReload' => true, // after user changes this preference game interface would auto-reload
'values' => array(
1 => array( 'name' => totranslate( 'Classic' ), 'cssPref' => 'notation_classic' ),
2 => array( 'name' => totranslate( 'Tournament' ), 'cssPref' => 'notation_tournament' )
)
)
);
</pre>

There is two ways to check/apply this. In java Script

if (this.prefs[100].value == 2) ...

This checks if preferences 100 has selected value 2.

Second, if cssPref specified it will be applied to the body tag. So you can use different css styling for the preference.

As user you have to select them from the Gear menu when game is started. On studio only user0 will have it actually working (bug?).

Game options and preferences: gameoptions.inc.php

2018-05-21T19:07:07Z

Tchebychev:

In this file, you can define your game options (= game variants) and user preferences.

Note: If your game has no variants or preferences, you don't have to modify this file.

== Game Options ==

Game options is something selected by table creator and usually correspond to game variant, for example if game includes expansion or certain special rule.

These variants defined in gameoptions.inc.php as variable
$game_options = array(...); // exactly named that

Each option is pair number => 'option description array'.

All options defined in this file should have a corresponding "game state label" with the same ID (see "initGameStateLabels" in yourgame.game.php)

self::initGameStateLabels ( array (
...
"my_first_game_variant" => 100,
) );
That is how you access them during runtime.

The following are the parameters of option description array:
* '''name''' - '''mandartory'''. The name of the option visible for table creator. Value must be wrapped in totranslate function.
* '''values''' - '''mandartory'''. The array (map) of values with additional parameters per value.
** '''name''' - '''mandartory'''. String representation of the numeric value visible to table creator. Value must be wrapped in totranslate function.
** '''tmdisplay''' - String representation of the option visible in the table description, usually if variant "names" are On and Off, but the description would be same as option name when On, and nothing when Off.
** '''nobeginner''' - Set to true if not recommended for begginers
** '''beta''' - Option in beta stage on development
** '''premium''' - Option can be only used by premium members
* '''displaycondition''' - checks the conditions before displaying the option for selection. All conditions must be true for the option to display. Supported condition types:
** ''otheroption'' condition ensures another option is set to this given value. Framework options - 201 - ELO OFF.
* '''startcondition''' - checks the conditions before starting the game. All conditions must be true for the game to start, otherwise players will get a red error message when attempting to begin the game.
Supported condition types:
** ''minplayers'' condition ensures at least this many players
** ''maxplayers'' conditions ensure at most this many players
** ''otheroption'' conditions ensure another option is set to this given value. That works the same as in '''displaycondition'''.
* '''notdisplayedmessage''' - if option is not suppose to be visible because of displaycondition but this is set, the text will be visible instead of combo drop down

<pre>
$game_options = array(
100 => array(
'name' => totranslate('my game option'),
'values' => array(
// A simple value for this option:
1 => array(
'name' => totranslate('option 1')
),

// A simple value for this option.
// If this value is chosen, the value of "tmdisplay" is displayed in the game lobby
2 => array(
'name' => totranslate('option 2'),
'tmdisplay' => totranslate('option 2')
),

// Another value, with other options:
// beta=true => this option is in beta version right now.
// nobeginner=true => this option is not recommended for beginners
3 => array(
'name' => totranslate('option 3'),
'beta' => true,
'nobeginner' => true
),
)
),

101 => array(
'name' => totranslate('Draft variant'),
'values' => array(
1 => array(
'name' => totranslate('No draft')
),
2 => array(
'name' => totranslate('Draft'),
'tmdisplay' => totranslate('Draft'),
'premium' => true,
'nobeginner' => true
),
),
'displaycondition' => array(
// Note: do not display this option unless these conditions are met
array(
'type' => 'otheroption',
'id' => 100, // Game specific option defined in the same array above
'value' => array(2, 3, 4)
),
// Note: do not display this option unless these conditions are met
array( 'type' => 'otheroption',
'id' => 201, // ELO OFF hardcoded framework option
'value' => 1 // 1 if OFF
)
),

'startcondition' => array(
1 => array(),
2 => array(
array(
'type' => 'maxplayers',
'value' => 3,
'message' => totranslate('Draft option is available for 3 players maximum.')
)
),
),
'disable' => true
),

102 => array(
'name' => totranslate('Takeovers'),
'values' => array(
2 => array(
'name' => totranslate('No takeover')
),
1 => array(
'name' => totranslate('Allow takeovers'),
'tmdisplay' => totranslate('Takeovers'),
'premium' => true,
'nobeginner' => true
),
),
'displaycondition' => array( // Note: do not display this option unless these conditions are met
array(
'type' => 'otheroption',
'id' => 100,
'value' => array(3, 4)
)
),
'startcondition' => array(
2 => array(),
1 => array(
array(
'type' => 'maxplayers',
'value' => 2,
'message' => totranslate('Rebel vs Imperium Takeover Scenario is available for 2 players only.')
)
),
),
'disable' => true
)
);
</pre>

Example of option that condition on ELO off

<pre>
$game_options = array(

100 => array(
'name' => totranslate('Learning Game (No Research)'),
'values' => array(

1 => array( 'name' => totranslate('Off'), 'tmdisplay' => totranslate('') ),
2 => array( 'name' => totranslate('On'), 'tmdisplay' => totranslate('Learning Game') ),

),
'displaycondition' => array(
// Note: do not display this option unless these conditions are met
array( 'type' => 'otheroption',
'id' => 201, // ELO OFF hardcoded framework option
'value' => 1, // 1 if OFF

)
),
'notdisplayedmessage' => totranslate('Learning variant available only with ELO off')
),

);
</pre>

IMPORTANT: After you edited and deployed this file you have to go to control panel and press "Reload game options configuration"

== User Preferences ==

User preferences is something cosmetic about the game interface which however can create user wars, so you can satisfy all user
by giving them individual preferences. Do not use this unless absolutely necessary and usually only after game has been in production
for a while. If you add these currently only admins can apply these settings, so you would have to contact them after editing this file.

<pre>
$game_preferences = array(
100 => array(
'name' => totranslate('Notation style'),
'needReload' => true, // after user changes this preference game interface would auto-reload
'values' => array(
1 => array( 'name' => totranslate( 'Classic' ), 'cssPref' => 'notation_classic' ),
2 => array( 'name' => totranslate( 'Tournament' ), 'cssPref' => 'notation_tournament' )
)
)
);
</pre>

There is two ways to check/apply this. In java Script

if (this.prefs[100].value == 2) ...

This checks if preferences 100 has selected value 2.

Second, if cssPref specified it will be applied to the body tag. So you can use different css styling for the preference.

As user you have to select them from the Gear menu when game is started. On studio only user0 will have it actually working (bug?).

Gamehelpinnovation

2017-12-19T17:30:53Z

Tchebychev:

You can hover on the memo to have a reminder of the actions and keywords.

==Game editions and differences==
The game was first published by Asmadi Games in 2010.

Then Iello published another edition of the game in 2011 with the same mechanics and card effects, but using a different terminology.

More recently, Asmadi Games gather the original game and all its expansions in a new box "Innovation Deluxe" with new graphics, and also made some slight modifications on nine cards for balancing purposes.

The online adaptation is based on the first edition of Asmadi games for the artwork. For the rules, you can choose between:

-'''Last edition''' (this is the default): these are the rules of the '''Asmadi "Innovation Deluxe"''' pack.

-'''First edition''': these are the rules of the '''original Asmadi game'''. These rules are consistant with the '''Iello edition too'''.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Gamehelpinnovation

2017-12-19T17:30:03Z

Tchebychev:

You can hover on the memo to have a reminder of the actions and keywords.

==Game editions and differences==
The game was first published by Asmadi Games in 2010.

Then Iello published another edition of the game in 2011 with the same mechanics and card effects, but using a different terminology.

More recently, Asmadi Games gather the original game and all its expansions in a new box "Innovation Deluxe" with new graphics, and also made some slight modifications on nine cards for balancing purposes.

The online adaptation artwork is based on the first edition of Asmadi games. For the rules, you can choose between:

-'''Last edition''' (this is the default): these are the rules of the '''Asmadi "Innovation Deluxe"''' pack.

-'''First edition''': these are the rules of the '''original Asmadi game'''. These rules are consistant with the '''Iello edition too'''.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Gamehelpinnovation

2017-12-19T17:29:31Z

Tchebychev:

You can hover on the memo to have a reminder of the actions and keywords.

==Game editions and differences==
The game was first published by Asmadi Games in 2010.

Then Iello published another edition of the game in 2011 with the same mechanics and card effects, but using a different terminology.

More recently, Asmadi Games gather the original game and all its expansions in a new box "Innovation Deluxe" with new graphics, and also made some slight modifications on nine cards for balancing purposes.

The online adaptation artwork is based on the first edition of Asmadi games. For the rules, you can choose between:

-'''Last edition''' (this is the default): these are the rules of the '''Asmadi "Innovation Deluxe"''' pack.

-'''First edition''': these are the rules of the '''original Asmadi game'''. Rules are consistant with the '''Iello edition too'''.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Gamehelpinnovation

2017-12-19T17:28:20Z

Tchebychev:

You can hover on the memo to have a reminder of the actions and keywords.

==Game editions and differences==
The game was first published by Asmadi Games in 2010.

Then Iello published another edition of the game in 2011 with the same mechanics and card effects, but using a different terminology.

More recently, Asmadi Games gather the original game and all its expansions in a new box "Innovation Deluxe" with new graphics, and also made some slight modifications on nine cards for balancing purposes.

The online adaptation artwork is based on the first edition of Asmadi games. For the rules, you can choose between:

-'''Last edition''' (default): these are the rules of the Asmadi "Innovation Deluxe" pack.

-'''First edition''': these are the rules of the original Asmadi game. Rules are consistant with the Iello edition too.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Gamehelpinnovation

2017-12-19T17:27:16Z

Tchebychev:

You can hover on the memo to have a reminder of the actions and keywords.

==Game editions and differences==
The game was first published by Asmadi Games in 2010.

Then Iello published another edition of the game in 2011 with the same mechanics and card effects, but using a different terminology.

More recently, Asmadi Games gather the original game and all its expansions in a new box "Innovation Deluxe" with new graphics, and also made some slight modifications on nine cards for balancing purposes.

The online adaptation artwork is based on the first edition of Asmadi games. For the rules, you can choose:

-'''Last edition''' (default): these are the rules of the Asmadi "Innovation Deluxe" pack.

-'''First edition''': these are the rules of the original Asmadi game. Rules are consistant with the Iello edition too.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Gamehelpinnovation

2017-12-19T17:25:56Z

Tchebychev:

You can hover on the memo to have a reminder of the actions and keywords.

==Game editions and differences==
The game was first published by Asmadi Games in 2010.
Then Iello published another edition of the game in 2011 with the same mechanics and card effects, but using a different terminology.
More recently, Asmadi Games gather the original game and all its expansions in a new box "Innovation Deluxe" with new graphics, and also made some minor modifications on some cards for balancing purposes.

The online adaptation artwork is based on the first edition of Asmadi games. For the rules, you can choose:
-'''Last edition''' (default): these are the rules of the Asmadi "Innovation Deluxe" pack.
-'''First edition''': these are the rules of the original Asmadi game. Rules are consistant with the Iello edition too.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Gamehelpinnovation

2017-12-17T19:13:09Z

Tchebychev: Created page with "You can hover on the memo to have a reminder of the actions and keywords. ==Beginning of the game== At the beginning of the game you have two cards of age 1 in your hand. You..."

You can hover on the memo to have a reminder of the actions and keywords.

==Beginning of the game==
At the beginning of the game you have two cards of age 1 in your hand. You choose one to meld immediately and keep the other in your hand. The player who melded the first card in English alphabetical order plays first.
The first player gets only one action to start with, so does the second player in a four player game. After that, everybody gets two action on their turn.

==Actions==
Except in the beginning, you must take two actions at your turn.
There are 4 possible actions. It is possible to select the same action twice:

'''DRAW:''' take a card of value equal to the highest top card on your board from the supply deck. If this deck is empty draw from the next available higher deck. This rule for drawing is also applicable for any effect with the "draw" keyword.

'''MELD:''' play a card from your hand to your board. It is played on the existing stack on the same color if it exists, otherwise this card starts a new one. Continue any splay if present.

'''DOGMA:''' each opponent with fewer of the feature icon (visible on their board) than you must execute the I demand effects. Each opponent with at least as many of the feature shares the non-demand effects. Effects are executed clockwise, finishing with you. If sharing an effect with one or several opponents has had ANY consequence on the game situation, take a single free Draw action at the end of your dogma action.

'''ACHIEVE:''' You can take an action to claim any available age achievement if you have at least 5 times the value of that age in your score pile AND a top card on your board of equal or higher value. For example to achieve age 1 you need 5 points and any card on your board. To achieve age 2, 10 points and at least a 2 as a top card and so on... Points are kept, not spent. Special achievements does not require any action to claim them and are won AS SOON AS the conditions are met.

==End of the game==
The game can end in three ways.

'''END OF GAME BY ACHIEVEMENTS:''' The game ends IMMEDIATELY (even inside a dogma effect) when a player got a required number of achievements:

-''2 players:'' 6 achievements

-''3 players:'' 5 achievements

-''4 players:'' 4 achievements

-''4 players '''(team game variant)''':'' 6 achievements combined by the teammates

'''END OF GAME BY SCORE:''' This happens if someone tries to draw an 11 or higher. The game end IMMEDIATELY (even inside a dogma effect). The winner is the player who has the greater score in his score pile. The number of achievements is only a tie-breaker. If still tied, the concerned players both win. In a team game, the teammates combine their score. If tied, they combine their achievements.

'''END OF GAME BY DOGMA:''' Some dogma effects of a few cards awards a win if some conditions are met. If more than one player are eligible (except teammates in a team game), the game continues.

==The golden rule==
'''Do as many as you can and ignore the rest.'''

This rule will help you to leverage ambiguities.

This has many consequences:

-Exchanges do not need to be symmetrical. According to the situation, 2 cards can be exchanged with 2, 1 card with 4, or even 0 card with 10...

-If you don't have enough card to fulfill the effect requirement, you process all what you have.

-However, if a "you may effect" proposes you return three cards and you don't have them, you CAN'T spend what you have to do what follows. You have to pass.

Zone

2017-11-24T08:42:50Z

Tchebychev:

The Zone component is meant to organise items of the same type inside a predefined space.

== Zone in action ==

If you want to see how Zone works, please try "Can't Stop" or "Niagara" on BGA, or watch a game in progress or game replay.

In Can't Stop, zone is used to display the bhikkus ascending the mountain when there is more than one on the same space (diagonal mode).

In Niagara, it is used to display the canoes over the circles going down the river (custom mode).

== How to use Zone ==

At first, don't forget to add "ebg/zone" as a dependency:
<pre>
define([
"dojo","dojo/_base/declare",
"ebg/core/gamegui",
"ebg/counter",
"ebg/zone" /// <==== HERE
],
</pre>

Then, declare a new variable in your class for the Zone object:

<pre>
constructor: function(){
console.log('yourgame constructor');

// Zone control
this.myZone = new ebg.zone();
</pre>

Now, in your template file, you must add a div that will host this zone:

<pre>
<div id="my_zone"></div>
</pre>

And set its width (and optionnaly, height and position) in CSS:

<pre>

#my_zone {
width: 100px;
}

</pre>

Then in your Javascript setup, attach your Zone component to the div and define its properties :

<pre>
zone.create( this, 'my_zone', <item_width>, <item_height> );
zone.setPattern( <mode> );
</pre>

* <item_width> is an integer for the width of the objects you want to organise in the zone
* <item_height> is an integer for the height of the objects you want to organise in the zone
* <mode> is one of 'grid' (objects will be put on lines from top left to bottom right, wrapping when there is not enough space left on the line, relatively to the width you have defined) 'diagonal' (objects will be organised on a top left to bottom right diagonal, overlapping each other) or 'custom' (objects will be organised depending upon their number and the coordinates that you provide - see below)

Since the width of the Zone is defined statically, beware of not letting items overflow on small screens. If you need a design-responsive component, consider using the Stock component instead.

Now your zone is ready to be used!

After creating an object that you want to add to the zone as a classic HTML template (dojo.place / this.format_block), you can simply use:

<pre>
zone.placeInZone( <object_id>, <weight> );
</pre>

* <object_id> is the string identifier for your object 'my_object_id'
* <weight> is an optional parameter used to sort items

To remove an item, use:

<pre>
zone.removeFromZone( <object_id>, <destroy?>, <to> );
</pre>

* <object_id> is the string identifier for your object 'my_object_id'
* <destroy?> is a boolean indicating if the object should be destroyed after being removed
* <to> is the destination the object must be slided to when being removed (before being eventually destroyed)

You can also:
* remove all items from the zone (and destroy them) using zone.removeAll();
* get the number of items in your zone using zone.getItemNumber();
* get an array of the ids of all the items using zone.getAllItems();

== Custom mode ==

If you want complete control on how your objects are laid out inside the Zone, you can determine their coordinates after their number when being added to the zone. Here is how to do it, when defining your Zone properties in the javascript setup:

<pre>
this.zone.setPattern( 'custom' );

this.zone.itemIdToCoords = function( i, control_width ) {
if( i%8==0 )
{ return { x:1,y:19, w:60, h:30 }; }
else if( i%8==1 )
{ return { x:30,y:38, w:60, h:30 }; }
else if( i%8==2 )
{ return { x:42,y:8, w:60, h:30 }; }
else if( i%8==3 )
{ return { x:5,y:58, w:60, h:30 }; }
else if( i%8==4 )
{ return { x:5,y:24, w:60, h:30 }; }
else if( i%8==5 )
{ return { x:35,y:43, w:60, h:30 }; }
else if( i%8==6 )
{ return { x:47,y:13, w:60, h:30 }; }
else if( i%8==7 )
{ return { x:10,y:63, w:60, h:30 }; }
};
</pre>

Zone

2017-11-24T08:40:29Z

Tchebychev:

The Zone component is meant to organise items of the same type inside a predefined space.

== Zone in action ==

If you want to see how Zone works, please try "Can't Stop" or "Niagara" on BGA, or watch a game in progress or game replay.

In Can't Stop, zone is used to display the bhikkus ascending the mountain when there is more than one on the same space (diagonal mode).

In Niagara, it is used to display the canoes over the circles going down the river (custom mode).

== How to use Zone ==

At first, don't forget to add "ebg/zone" as a dependency:
<pre>
define([
"dojo","dojo/_base/declare",
"ebg/core/gamegui",
"ebg/counter",
"ebg/zone" /// <==== HERE
],
</pre>

Then, declare a new variable in your class for the Zone object:

<pre>
constructor: function(){
console.log('yourgame constructor');

// Zone control
this.myZone = new ebg.zone();
</pre>

Now, in your template file, you must add a div that will host this zone:

<pre>
<div id="my_zone"></div>
</pre>

And set its width (and optionnaly, height and position) in CSS:

<pre>

#my_zone {
width: 100px;
}

</pre>

Then in your Javascript setup, attach your Zone component to the div and define its properties :

<pre>
zone.create( this, 'my_zone', <item_width>, <item_height> );
zone.setPattern( <mode> );
</pre>

* <item_width> is an integer for the width of the objects you want to organise in the zone
* <item_height> is an integer for the height of the objects you want to organise in the zone
* <mode> is one of 'grid' (objects will be put on lines from top left to bottom right, wrapping when there is not enough space left on the line, relatively to the width defined) 'diagonal' (objects will be organised on a top left to bottom right diagonal, overlapping each other) or 'custom' (objects will be organised depending upon their number and the coordinates that you provide - see below)

Since the width of the Zone is defined statically, beware of not letting items overflow on small screens. If you need a design-responsive component, consider using the Stock component instead.

Now your zone is ready to be used!

After creating an object that you want to add to the zone as a classic HTML template (dojo.place / this.format_block), you can simply use:

<pre>
zone.placeInZone( <object_id>, <weight> );
</pre>

* <object_id> is the string identifier for your object 'my_object_id'
* <weight> is an optional parameter used to sort items

To remove an item, use:

<pre>
zone.removeFromZone( <object_id>, <destroy?>, <to> );
</pre>

* <object_id> is the string identifier for your object 'my_object_id'
* <destroy?> is a boolean indicating if the object should be destroyed after being removed
* <to> is the destination the object must be slided to when being removed (before being eventually destroyed)

You can also:
* remove all items from the zone (and destroy them) using zone.removeAll();
* get the number of items in your zone using zone.getItemNumber();
* get an array of the ids of all the items using zone.getAllItems();

== Custom mode ==

If you want complete control on how your objects are laid out inside the Zone, you can determine their coordinates after their number when being added to the zone. Here is how to do it, when defining your Zone properties in the javascript setup:

<pre>
this.zone.setPattern( 'custom' );

this.zone.itemIdToCoords = function( i, control_width ) {
if( i%8==0 )
{ return { x:1,y:19, w:60, h:30 }; }
else if( i%8==1 )
{ return { x:30,y:38, w:60, h:30 }; }
else if( i%8==2 )
{ return { x:42,y:8, w:60, h:30 }; }
else if( i%8==3 )
{ return { x:5,y:58, w:60, h:30 }; }
else if( i%8==4 )
{ return { x:5,y:24, w:60, h:30 }; }
else if( i%8==5 )
{ return { x:35,y:43, w:60, h:30 }; }
else if( i%8==6 )
{ return { x:47,y:13, w:60, h:30 }; }
else if( i%8==7 )
{ return { x:10,y:63, w:60, h:30 }; }
};
</pre>