Board Game Arena - Contribucións do/a usuario/a [gl]

Gamehelpbuttons

2018-08-16T11:21:58Z

Apollo1001:

The object of the game is to be the player who can connect a line of 5 stars horizontally or vertically (not diagonally). The game end is also triggered when a player reaches 12 stars.

'''Each turn''':
Each player begins with one designated bonus colour (or 2 colours for 2 player games) and an individual player board (all different). The player with the red colour button rolls first. There is one white die with gold pips, and 5 black dice, one with a gold pip. The player who rolled chooses a combination of the white die and one of the black die. Where those intersect on their board, they can place a button from the supply. The other players have the OPTION to use the combination of the white die and the black die with the gold pip.

*Strategy Tip: Each button you place on the board 'blocks' horizontally and vertically adjacent locations from being available for buttons on future turns during the round. Thus, the more buttons you have, the more locations are blocked for placement.

Once every player has made their placement decisions, the dice are handed to the next player to roll. The player can choose to either roll OR, if they have placed at least one button on their board, they can choose to opt out.

(1) If a player rolls the dice, they MUST place a button on an eligible intersection. If they are unable to do so, they bust out, and all the buttons they have placed so far are returned to the supply. The player also takes one of the black dice (without the gold pips) until the end of the round. Any remaining players will have 1 less black die available to roll.

(2) When a player opts out, they will get 1 star at the end of the round. The player who opts out also takes one of the black dice (without the gold pips) until the end of the round. Any remaining players will have 1 less black die available to roll.

'''End of each round''':
When all of the players have either busted out or opted out, stars are awarded from the supply.

(1) A star is awarded for successfully opting out

(2) A star is awarded for each colour that you covered with at least 3 buttons during your turn ''(N.B. Further buttons are NOT available for covering any more than three)''

(3) A bonus star is awarded for each of your bonus colours that you covered with at least 3 buttons during your turn

Stars can be placed to replace any of the buttons placed during this round. After stars are placed, any remaining buttons are returned to the supply. Each player transfers their designated bonus colour tokens to the next player. The player that now has the red bonus token starts the subsequent round.

Players will roll as they did during the first round, with the same button placement restrictions. You will be able to place new buttons adjacent to stars. However, you can not place buttons on top of stars.

*Strategy Tip: Since there is only a single white die, aiming to make a horizontal line can set you up for more frequent bust outs compared to vertical lines.

'''Ending and Winning the Game''':
The game ends when a player connects a line of 5 stars horizontally or vertically (not diagonally). If 2 or more players connect a line of 5 stars at the end of the same round, the player with the most stars wins the tie.breaker. There is no further tie-break.

If no one connects a line of 5 stars, a player who places 12 stars triggers the end of the game. The player with the most stars wins the game. There is no further tie-break.

'''In the BGA implementation: 100 points are awarded for connecting 5 stars in a row, so the game simply ends when someone has 12 or more points.'''

Gamehelpbuttons

2018-08-11T12:27:53Z

Apollo1001:

The object of the game is to be the player who can connect a line of 5 stars horizontally or vertically (not diagonally). The game end is also triggered when a player reaches 12 stars.

'''Each turn''':
Each player begins with one designated bonus colour (or 2 colours for 2 player games) and an individual player board (all different). The player with the red colour button rolls first. There is one white die with gold pips, and 5 black dice, one with a gold pip. The player who rolled chooses a combination of the white die and one of the black die. Where those intersect on their board, they can place a button from the supply. The other players have the OPTION to use the combination of the white die and the black die with the gold pip.

*Strategy Tip: Each button you place on the board 'blocks' horizontally and vertically adjacent locations from being available for buttons on future turns during the round. Thus, the more buttons you have, the more locations are blocked for placement.

Once every player has made their placement decisions, the dice are handed to the next player to roll. The player can choose to either roll OR, if they have placed at least one button on their board, they can choose to opt out.

(1) If a player rolls the dice, they MUST place a button on an eligible intersection. If they are unable to do so, they bust out, and all the buttons they have placed so far are returned to the supply. The player also takes one of the black dice (without the gold pips) until the end of the round. Any remaining players will have 1 less black die available to roll.

(2) When a player opts out, they will get 1 star at the end of the round. The player who opts out also takes one of the black dice (without the gold pips) until the end of the round. Any remaining players will have 1 less black die available to roll.

'''End of each round''':
When all of the players have either busted out or opted out, stars are awarded from the supply.

(1) A star is awarded for successfully opting out

(2) A star is awarded for each set of 3 of a single colour that you covered with buttons during your turn

(3) A bonus star is awarded for each set of 3 of your bonus colour that you covered with buttons during your turn

Stars can be placed to replace any of the buttons placed during this round. After stars are placed, any remaining buttons are returned to the supply. Each player transfers their designated bonus colour tokens to the next player. The player that now has the red bonus token starts the subsequent round.

Players will roll as they did during the first round, with the same button placement restrictions. You will be able to place new buttons adjacent to stars. However, you can not place buttons on top of stars.

*Strategy Tip: Since there is only a single white die, aiming to make a horizontal line can set you up for more frequent bust outs compared to vertical lines.

'''Ending and Winning the Game''':
The game ends when a player connects a line of 5 stars horizontally or vertically (not diagonally). If 2 or more players connect a line of 5 stars at the end of the same round, the player with the most stars wins the tie.breaker. There is no further tie-break.

If no one connects a line of 5 stars, a player who places 12 stars triggers the end of the game. The player with the most stars wins the game. There is no further tie-break.

'''In the BGA implementation: 100 points are awarded for connecting 5 stars in a row, so the game simply ends when someone has 12 or more points.'''

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

2016-06-25T20:04:25Z

Apollo1001: /* Variables */

These 2 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 <yourgame.tpl>, 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>

== WARNING ==

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, ...).

Example of things that shouldn't be generate by your view:
* Game elements that come and go from the game area.
* Game elements that are moving from one place to another.

== phplib 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:
http://www.phpbuilder.com/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 value.

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

To give a value to this variable in your 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.

== Blocks ==

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

You should use "blocks" everytime you have a block of HTML that you have to repeat a big number of time. 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. 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:

<pre>

(In template file)


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

<div class="card_places">

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

</div>

</div>


(In view file)

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

== Javascript templates ==

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

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>

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

== Tips: displaying a nice button ==

From time to time, you need to display a standard button in your interface. BGA framework provides you a standard button that you can use directly in your interface:

<pre>
<a href="#" id="my_button_id" class="button"><span>My button label</span></a>
</pre>

Note: To see it in action, check for example a Coloretto game