SandboxScripts

2016-12-12T14:13:16Z

Sourisdudesert: /* Sandbox Scripts Hello World */

2016-04-24T19:15:01Z

Sourisdudesert: /* Do you recruit? */

[[Category:Help]]

== General questions ==

===What is Board Game Arena?===

Board Game Arena (BGA) is an online board game platform. With BGA, you can play online and in real time against players from around the world. A selection of various board games and card games are available. In order to play, the only thing you need is your browser!

===What do you mean by "real time play"?===

On Board Game Arena your opponents are connected to the game platform during the entire game. They can see your moves and react to them immediately - as is the case in the real world.

===What is "turn based play"?===

This is often referred to as "asynchronous play" on other sites, and is used here to differentiate from "real time play". Instead of all players being around the table at the same time, players leave and come back. After your opponent takes a move you are notified that it is your turn (via email or on your next visit to the site). You then go to your game, take your turn, and the process repeats for the next player.

For details please read [[Turn based FAQ]].

===What do I need to play?===

Your browser ... and that's it!

Board Game Arena does not require anything else on your computer. Thus, you can play from any computer, anywhere, anytime!

In order to make this possible, we are using the latest technologies available for the web. This is the reason you should play with the most up to date web browsers to enjoy an optimal BGA experience (read more about our [[Browser_support|browser policy]]).

===How much does it cost to play on BGA?===

Playing on BGA is free.

You can also choose to help us by making a donation and becoming a [http://en.boardgamearena.com/#!club Board Game Arena club] member.

===What games are available on BGA?===

Board Game Arena offers a selection of board and card games, but specializes in modern ("European style") adult games.

[http://en.boardgamearena.com/#!gamelist See available games].

== Meeting players and starting games ==

===I launched a new table but nobody is joining?===

For the most popular games, you can find players at any time of day. For other games, we advise you to come back at peak hour (around 22:00 CEST) if you can't find opponents at the moment.

Tip: check the number of online/available players for a game before launching the table.

Tip: if nobody is available for a realtime game, you can turn your table into a turn-based table, so another player can join even hours/days after you created it.

===I joined a game. When does the game start?===

'''For realtime games''':

Each table has an administrator, who is the table creator. It is the responsibility of the table administrator to start the game when he or she is satisfied with the number of players who have joined the table.

If you are the table administrator and can't launch the game, most of the time it's because there are not yet enough players who have joined the table.

'''For turnbased games''':

The game starts as soon as the maximum number of players has been reached. The table administrator can also start the game manually any time after the minimum number of required players have joined.

===What does the small colored circle next to a player's name mean?===

* http://fr.boardgamearena.com/theme/img/status/online_.png : this player is active. He or she completed an action very recently.
* http://fr.boardgamearena.com/theme/img/status/inactive_.png : this player is inactive. He or she is connected to the website but has not performed any action recently.
* http://fr.boardgamearena.com/theme/img/status/offline_.png : this player is offline.

===What does the '% hits' statistic mean?===
% hits = number of victory points / number of games played

Players earn more victory points for winning a game that has more players (half a point per player). So:
* When you win a 2 players game: 1 point.
* When you win a 3 players game: 1.5 points.
* When you win a 4 players game: 2 points.
* etc.

For example, a player who plays a three player game and wins a third of the time will have: "50% hits", while a player who plays a four person game and wins a third of the time, will have: "67% hits"

== During the game ==

===What do the icons next to players' names mean?===

* http://fr.boardgamearena.com/theme/img/layout/active_player.gif : this player must make a move now.
* http://fr.boardgamearena.com/theme/img/layout/active_player_clockalert.gif : this player must make a move now, and has used up their reflection time. Can someone wake them up? ;)
* http://fr.boardgamearena.com/theme/img/layout/active_player_nonack.gif : this player must make a move now, but is probably not aware of this fact. If the situation doesn't change, it might suggest that this player has a connection issue.
* http://fr.boardgamearena.com/theme/img/common/zombie.png : this player is a "zombie" (has left the game or been fired from the game). The game is going on without this player.

When the "normal" avatar of a player is displayed, it means that this player is waiting for their turn to play.

===A player has to make a move but he/she doesn't. What can I do?===

* First, please remember that this player has the right to think as long as they need to about the next move... well as long as there is still some time left on the game clock, that is.
* Then you can ask this player to confirm that he or she is still thinking about how to play.
* If this player seems to be away, we advise you to wait a few minutes: this player may be experiencing some network problems or have left the computer temporarily.
* If the player is not coming back, you can skip their turn as soon as the clock is negative. This player will get a "leave" penalty and you will win "by forfeit".

For more details, please read [[Game clock]].

===What is the current progression of the game I'm playing?===

A percentage of progression is displayed on the top of the web page.
There is also a progress bar at the bottom of the web page shows you the current progression of the game.

===What is forbidden on Board Game Arena?===

* Leaving a game in progress on purpose.
* Taking an unnecessary and unreasonable amount of time at the end of game in an obvious losing situation.
* Kingmaking: enabling another player to win on purpose while there is a better move to make for yourself.
* Running out of time on the game clock.
* Giving some piece of information about the current game situation that corrupts the normal game flow.
* Communicating with another player about the game privately (ex: with MSN).
* Provocation / triumphalism / defeatism ... anything which is not fair play.
* Having a shocking avatar (no advertisement, no politics, ...)

Going against these rules will affect your reputation.

===What is absolutely forbidden in Board Game Arena?===

* Creating multiple accounts and playing against oneself.
* Insulting other players in any manner.

Going against these rules can lead to the removal of your account and/or to the blacklisting of your IP.

===What if some player does something wrong?===

The Board Game Arena platform has been designed to encourage players to maintain good behavior. The reputation system allows you to distinguish between good and bad players. Then, it is up to you to decide whether to start a game with them or not.

If you think a player has behaved badly during a game, you can give them a "red thumb" at the end of the game.

If you think a player has committed a serious wrongdoing during a game (ex: insult), please report this player to us, using the "report this player" link from their profile or game result page, so that we can take appropriate measures.

== Tournaments ==

Tournaments is a BETA feature of BGA (for a long time).

Tournament management is very complex. We'd like to open tournament creation to everyone at some time in the future but it need a lot of work and until then we always had something more urgent to do.

When tournaments will be improved, this FAQ section will be improved too.

== About board games we proposed on BGA ==

===What is the legal status of this website?===

All the games currently available on this site have been licensed or otherwise authorized by copyright holders. Please be aware that games available on BGA can be removed at the copyright holders demand (for example: if they publish their own adaptation of the game).

Board Game Arena would like to thank all game publishers and game designers who allow us to have their games here, thus making it possible for this website to exist.

=== How do we select games that are on BGA? Why the game XXX is not on BGA? ===

To have a game published on BGA we need 2 things:
* The authorization of the rights owner (most of the time: original publisher of the game).
* A software developer who develops the adaptation (ie: has some time available to develop it).

We (= BGA team) are trying a lot of board games ourselves. Sometimes we are lucky enough to play prototypes too. And of course we receive a lot of game suggestions through the BGA forum, the BoardGameGeek "most wanted games" list, or by any other means. Based on this we are asking game publishers for authorizations, and sometimes we also receive requests directly from game publishers - there is no rule.

As it is today, BGA has a very good reputation and very productive relationships with almost all major board game publishers, but this is not enough: each situation is specific, and there can be various reasons why a game publisher can refuse to see a game adaptation on BGA (for example: board games with a third party licence, like "Star Wars", is practically impossible to negotiate).

On the other hand, we got some authorizations for some very good games but no developers volunteering to develop them, or sometimes some of them don't manage to finish the job. Developers of adaptations are volunteers, and we don't blame them for this.

Finally, some games are authorized and being developed, but the time frame is not good. For example, it happened that we had too many games to release and we decided to delay some of them. It also frequently happens that we must synchronize the release of a game with a publisher event, so the game adaptation can stay "on hold" for some months.

So if you are asking yourself: why game XXX is not on BGA, it could be for various reasons:
* Maybe we never asked authorization for this game. Note that usually we ask authorizations for every popular games (ex: "Most wanted games"). So if the game is popular, the reason is probably not this one.
* The publisher refused.
* The publisher accepted, but we didn't find a developer until now for this game.
* The game adaptation is ready, but we are waiting for a specific event to release it.

To conclude: yes we are taking into account your suggestions, but as you can see there are many factors than can influence the fact that a game is (or is not) on BGA. In addition, as a rule of thumb, we don't communicate about "why" this game is not on BGA. If we already got the authorization, we want to keep the "surprise", and if we didn't get the authorization, the game publisher may not want to explain the reasons.

=== Are you taking into account the "Most wanted games" list? When will these games be on BGA? ===

You should read first the previous section ("how do we select games that are on BGA?").

So the answer is:
* Yes, we are taking this list into account.
* For most of these games we already asked for authorizations.
* Some of these games won't be on BGA (authorization refused), some may be, some are in an "intermediate" step.
* We don't communicate about future game releases anyway.

=== Why do some games have expansions on BGA and some don't? ===

You should read first the previous section ("how do we select games that are on BGA?").

Game expansions follow the same steps than games. There can be various reasons why a game publisher doesn't want the expansion online, and sometimes we don't find a developer that has the time to develop it.

===I'm a game publisher: why would I like to have my game on Board Game Arena?===

The main goal of Board Game Arena is to make it easy for people to discover and love new games. We think that there are only two kinds of players on Board Game Arena: those who already bought the games they are playing online, and those who plan to buy them soon!

As the activity of this website contributes to increasing a game's popularity and thus generates hard copy sales in the "real world", we think it is beneficial to the board game community: people from all over the world can play online, we can have fun developing this game platform to the best of our ability, and game publishers get money from the box sales and build a special relationship with their player's community.

=== I'm a game publisher: how to get my game on Board Game Arena ===

At first, you just have to write us an email (contact (at) boardgamearena.com) with a description of your game(s).

Then, we add this game to the list of "available licences" on our website dedicated to game developers ([http://studio.boardgamearena.com BGA Studio]).

The most difficult part is to find a developer among our community. Our only requirement is that the developer must love the game. Of course, the most popular the game is, the easiest it is to find a volunteer developer. Sometimes it is very fast, sometimes it takes months, sometimes it never happens. We can't say in advance.

It is also possible to find your own developer: of course it accelerates the process a lot!

== Turn-based mode ==

Please read [[Turn based FAQ]].

== Issues with BGA ==

===What can I do if I have an issue with the website?===

Most of the issues on this website should be solved with a simple web page refresh (or "F5").

If you experience persistent issues, you can browse the [http://boardgamearena.com/#!bugs bug tool], see if someone already reported the issue, and add a new bug report if that's not the case. Please take some time to describe the bug you are reporting in detail so that we can quickly reproduce and fix it.

=== Why is my bug still not fixed? ===

We fix bugs every weeks. Of course we have priorities:
* We give the highest priority to recent features and recent games, because the most important bugs are reported fast.
* We give the highest priority to the bugs with the biggest number of "green thumb" on the [http://boardgamearena.com/#!bugs bug tool].
* Usually we fix bugs by group. So if we decide to fix an important bug on a game, there is a chance that we will fix 3 or 4 minor bugs at the same time.

BGA is known for the quality of its adaptations, and if you look at the bug tool, you can see that -considering the number of games and the size of the community- there are not so many critical bugs with a lot of "green thumbs".

Please also note that BGA adaptations are realized by volunteers (even if most of them are also professional developers). It is not always easy for them to fix bugs, especially when some players are complaining violently and/or do not give precise information in bug reports.

=== I played on smartphone / tablet / touch device and I have some difficulties: what can I do? ===

As a rule of thumb, BGA does not support tablets/smartphones. There are tons of board game adaptations for tablets/smartphones, and some BGA adaptations are not well designed for small screens. Thus, we don't have plans to do a mobile / tablet version at the moment.

So if you want to use BGA from a smartphone / tablet you can, but we don't promise to fix all bugs so it's at your own risk :)

=== Why is BGA slow? Why do I have bad connections performances on BGA? ===

We are constantly monitoring server responsiveness. Some incidents occurs, but most of the time BGA is responsive.

We designed our game servers (ie: servers used when you are inside a game) to be very responsive. Usually, less than 2% of the game moves take more than 200 milliseconds to process, and less than 0.2% take more than 1 second.

BGA servers are located in Europe (France), but we bought servers all across the world (19 locations) so that the big files (ex: images) are loaded fast even if you are far from us.

Most of bad performances came from your internet connection or your system. Try to connect with a different browser / computer / internet connection to troubleshoot the issue.

As a rule of thumb, is BGA is not responsive enough, you shouldn't engage yourself into a game because there is a risk for you to get clock penalties.

=== I got issue with a specific player: how does the moderation works? ===

You should read [[Moderation and grades]] page.

== Contribute to BGA ==

=== How can I contribute to BGA? ===

Please visit page [http://boardgamearena.com/#!contribute Contribute to BGA].

=== I'm a software developer. What can I do? ===

We created a website specifically dedicated to board games adaptation development: [http://studio.boardgamearena.com BGA Studio].

== About the BGA team ==

=== Who are you? How to contact you? ===

Please read page [[About us]].

=== How you guys make money? Do you make a living of it? ===

Since the beginning of 2016, one BGA Founder (Sourisdudesert) is working full-time on BGA. It was really required by the growing audience playing on this website, and this has been made possible thanks to all paying members (thank you again!).

But to be honest, there is so much work to do on BGA that a single person is not enough. This is not really an issue because we think the "community based" approach is the best for BGA and we'd like to continue to give you the possibility to contribute to make this service running.

2015-12-26T12:17:39Z

Sourisdudesert: /* Declare your interface minimum width */

Board Game Arena is now adaptated for Mobiles and Tablets too.

This is very easy to have a mobile version of the game you developed with BGA Studio. In fact, your game is probably already 100% playable on mobile.

However, to provide your players the best experience, you should follow the 2 advices below.

== Declare your interface minimum width ==

By default, your game can run in an window up to 740 pixels width. Considering the informations of the right column (player's panel), it fits on a 1024px wide screen.

However, you can choose to declare that your game is able to run with a smaller width. This way, the game will appear much better on mobile and tablets.

For example, Reversi board is only 540px wide. If we stay with the default width (740px), the game interface displayed on mobile will be too large and some space will be lost on the left and on the right. Consequently the Reversi board is going to appear very small on the mobile screen, and players will have to "pinch & zoom" to display it correctly.

To avoid that, we can specify that the game can be played with an interface with a minimum width of 540 pixels, by adding the following to gameinfos.inc.php :

// Game interface width range (pixels)
// Note: game interface = space on the left side, without the column on the right
'game_interface_width' => array(

// Minimum width
// default: 760
// maximum possible value: 760 (ie: your game interface should fit with a 760px width (correspond to a 1024px screen)
// minimum possible value: 320 (the lowest value you specify, the better the display is on mobile)
'min' => 540,

// Maximum width
// default: null (ie: no limit, the game interface is as big as the player's screen allows it).
// maximum possible value: unlimited
// minimum possible value: 760
'max' => null
),

And that's it! Now, BGA can choose the better display for your game interface, whatever the device.

'''Important'''

If you declare that your interface can run with a 540 pixels width, it must effectively run on an interface with 540 pixels width.

Note that it doesn't mean that your interface must ALWAYS be 540 pixels width : you just have to make your interface fluid and/or to use CSS media query to fit in any width.

Examples :

* On Can't Stop, when the screen is too wide, we move the dices on another position (below the main board) to fit in the width :

@media only screen and (max-width: 990px) {

#dicechoices {
left: 180px;
top: 530px;
}
#cantstop_wrap {
height: 900px;
width: 550px;
}
}

* On Seasons, we have some panels on the right of the boards. On small screen, we display these panels below :

@media only screen and (max-width: 970px) {

#board {
float: none;
margin: auto;
}
.seasons_rightpanel {
margin-left: 0px;
}

}

== Touchscreen compatibility ==

Most of your game should work with touchscreen device.

Note : When your game is running on a touchscreen device, the global CSS class "touch-device" is added to the root HTML element (and "notouch-device" is added in the contrary).

What may not work :
* ":hover" CSS switch. Because there is no mouse, ":hover" won't be triggered. This is not an issue unless it is needed to play the game. In addition, some touch device considers that a short touch must trigger a ":hover" (and should apply corresponding CSS), which can block an interaction in your game. We advise you to explicitely disable ":hover" effects when your game is running on a touchscreen device.
* Mouseover events : like the previous one : if you associated Javascript events to "onmouseover" event, it won't work on tablets.
* Drag'n'drop : it won't work. To make it work, you should listen to "ontouchstart", "ontouchmove" and "ontouchend" event and trigger the same logic you already have for "onmousedown", "onmousemove" and "onmouseup". You should also make sure to stop the Javascript "ontouchmove" event (ex: dojo.stopEvent( evt ) ) during the drag n drop, otherwise the interface is going to scroll while drag'n'droping.