This is a documentation for Board Game Arena: play board games online !
Studio FAQ
Game File Reference
Overview
- dbmodel.sql - database model
- gameinfos.inc.php - meta-information
- gameoptions.inc.php - game options & user preferences
- img/ - game art
- material.inc.php - static data
- misc/ - studio-only storage
- modules/ - additional game code
- states.inc.php - state machine
- stats.inc.php - statistics
- X.action.php - player actions
- X.css - interface stylesheet
- X.game.php - main logic
- X.js - interface logic
- X.view.php - dynamic game layout
- X_X.tpl - static game layout
Useful Components
Official
- Deck: a PHP component to manage cards (deck, hands, picking cards, moving cards, shuffle deck, ...).
- Draggable: a JS component to manage drag'n'drop actions.
- Counter: a JS component to manage a counter that can increase/decrease (ex: player's score).
- ExpandableSection: a JS component to manage a rectangular block of HTML than can be displayed/hidden.
- Scrollmap: a JS component to manage a scrollable game area (useful when the game area can be infinite. Examples: Saboteur or Takenoko games).
- Stock: a JS component to manage and display a set of game elements displayed at a position.
- Zone: a JS component to manage a zone of the board where several game elements can come and leave, but should be well displayed together (See for example: token's places at Can't Stop).
Undocumented component (if somebody knows please help with docs)
- Wrapper: a JS component to wrap a <div> element around its child, even if these elements are absolute positioned.
Unofficial
- BGA Code Sharing - Shared resources, projects on git hub, common code, other links
- BGA Studio Cookbook - Tips and instructions on using API's, libraries and frameworks
- Some usual board game elements image ressources
Game Development Process
- First steps with BGA Studio
- Create a game in BGA Studio: Complete Walkthrough
- Tutorial reversi
- Tutorial gomoku
- Tutorial hearts
- BGA Studio Guidelines
- BGA game Lifecycle
- Pre-release checklist
- Post-release phase
- Player Resources - add player help/rules to your game page
Guides for Common Topics
- Translations - make your game translatable
- Game Replay
- Mobile Users
- 3D
Miscellaneous Resources
- Studio FAQ
- Tools and tips of BGA Studio - Tips and instructions on setting up development environment
- Studio logs - Instructions for log access
- Practical debugging - Tips focused on debugging
- Troubleshooting - Most common "I am really stuck" situations
- Studio Bugs - Reports against Studio itself (not BGA!)
This is a place where we will collect and answer frequently asked questions.
What should I use to access the files through SFTP?
There is a lot of tools to do that. Use the one you are the most comfortable with.
On Linux Gnome, you can for example use the 'Connect to server' function of the Nautilus file management system, or use sshfs.
On Windows, there is for example the WinSCP client.
See Tools_and_tips_of_BGA_Studio#File_Sync for more details.
I can't edit the files in my game directory, it looks like they are readonly. What's happening?
You can lose access sometimes if you add another developer as read/write or admin.
Maybe there is a maintenance operation underway.
If you don't get access back after some time (say one or two hours), please post on dev forum.
If you are still an admin for your game, re-add yourself as admin - it restores your permissions.
What is the working language on BGA studio?
Working language is English.
Variables and functions must be named with English words.
Comments must be written in English.
Game interface strings and game logs must be written in English.
How can I provide translation in my language?
The community will translate the game in all language after the game release with the collaborative translation interface can be used to translate into other languages.
Check Translations to see how to make your game translatable.
I updated the images in the 'img' folder of my game, but they don't show?
Concerning game_box.png, game_icon.png and publisher.png: You must use "Reload game box image" function from "Control Panel / Manage Games / Your game" to make your change visible.
Concerning other images: Other images used during the game are immediately available without any action. If the images still don't show after that, please try emptying your browser cache and reloading the page (i.e. press reload holding Ctrl button).
I added some game options / some game statistics / some game infos but they don't show?
When you modify one of these 3 files, you need to use the corresponding update action from "Control Panel / Manage Games / Your Game" in order we can take this information into account.
Should I use images free from copyright?
If you are developing a game in the public domain, yes (or you can make your own if you feel it's better).
If you are developing a game for which we have a licence, we will usually provide art files from the publisher.
You can also used shared images provided by boardgame arena - logos, some action buttons, card, meeples, decks.
I registered on Studio but did not receive email
If you using standard email address (such as gmail, yahoo, outlook) its in junk folder, search for "bga".
If you use some proprietary email address, it possible that your mail server denies emails from bga, in this case post message on the forum and specify login name your have chosen. Don't attempt to register again with same email, it likely will fail again. But if you have alternative standard email account use it instead.