This is a documentation for Board Game Arena: play board games online !
BGA Code Sharing
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 page is for listing of externally hosted bga projects, tools and resources, as well as internal project intended for sharing
Projects hosted not in studio
See the table a link and nickname of the developer on bga (same as used for dev forum), and short description. See Tools_and_tips_of_BGA_Studio#Version_Control for some suggestions on how and where to publish your code externally. Also see the boardgamearena tag on github.
Important notice about artwork on BGA Open Source projects: original hi-resolution images from publishers must not be published on the repositories. In addition, it is better to specify that the images derivated from publishers artwork are copyrighted and cannot be licensed under a free license like Creative Commons.
Projects on studio
Any developer can add themselves to a project as read-only from http://en.studio.boardgamearena.com/#!projects page (almost any project). The list below are no-games which do not have bgg id and not showing up there.
NAME | CODE LINK | DEVELOPER |
---|---|---|
Shared Code | http://en.studio.boardgamearena.com/#!studiogame?game=sharedcode | Victoria_La |
Original BGA template | http://en.studio.boardgamearena.com/#!studiogame?game=template | Victoria_La |
Other useful resources
Moved to Tools_and_tips_of_BGA_Studio