This is a documentation for Board Game Arena: play board games online !

BGA Code Sharing

From Board Game Arena
Revision as of 01:39, 13 March 2023 by Yannsnow (talk | contribs) (change scrollmap with zoom)
Jump to navigation Jump to search


Game File Reference


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


Game Development Process


Guides for Common Topics


Miscellaneous Resources

This page is for listing of externally hosted bga projects, tools and resources, as well as internal project intended for sharing

Community shared components, pens, etc

NAME CODE LINK DESCRIPTION
Dice models and animation
Die: 4 sided https://codepen.io/mrkiffie/pen/doVZgW code pen
Die: 4 sided https://codepen.io/VictoriaLa/pen/JjZNezr code pen
Die: 6 sided https://github.com/elaskavaia/bga-sharedcode Code can be found in project
Die: 12 sided (dodecahedron) https://codepen.io/VictoriaLa/pen/xxLLxOP Code pen
Die: 20 sided https://codepen.io/vicentemundim/details/cenIh Code pen
Moving object using CSS animation (mostly)
Phantom object move on oversurface https://codepen.io/VictoriaLa/pen/gORvdJo This technique creates clone of the object it moves it on another surface. It works well when parents that css transform applies such as scale and rotate
Move object directly using positioning https://codepen.io/VictoriaLa/pen/dyzgKVX This technique is modification of BGA framework method to allow mobile object not to have absolute position before or after the move (and uses css animation not dojo). Methods slideToObjectRelative, attachToNewObjectNoDestroy
Responsive layout for game boards
Flex Layout https://codepen.io/VictoriaLa/pen/XWjJJgG Example on how to create flexible layout just by using css
Algorithms
Hex grid tapestry,Tumbleweed,gaia project,Gold West
Shortest path on hex grid memoir 44 Disjktra
Largest area on hex grid tapestry, ...
Largest area on square grid king domino, ...
Tetris pieces patchwork, ... Matrix manupations to rotate, flip and fit tetris pieces
Line of sights on hex grid memoir 44 Find intersecting hexes on a line between two cells
Alternative implementations of BGA modules
Scrollmap with zoom https://github.com/yansnow78/bga_scrollmap you can find it in cacao an implementation in cacao (currently only changed in studo)

# improvements compare to scrollmap

- add zoom capabilities

- add possibility to adjust pan delta to tile size when clicking on arrows

- allow zoom with scroll wheel

- allow pan/scrool and pinch zoom on smartphone

- make clickable area of buttons a bit bigger on smartphone

- zooming with buttons doesn't drift the board anymore

- improve animation between game board and player bards tanks to an animation_div

- add support to long click on buttons (continuous scroll or zoom or enlarge/reduce until button released)

- add possibility to select which key need to be pressed when zooming with wheel

- only allow 2 fingers scrolling by default, one finger is for page scrolling

- only allow scroll with wheel if alt or ctrl or shift are pressed by default.

Scrollmap Plus patchwork Implementation with some bugs fixed, improved drag support and ability to use only one direction (i.e. only horizontal like carousel). Found in modules/extscrollmap.js
Zoom Repo | Demo (visible on Azul, Abyss, ...) Allow the user to zoom on the game board. Include the controls to zoom, and handle the scale applied to the HTML element.
Cards Repo | Demo (visible on King of Tokyo, Abyss, ...) Alternative to BGA Stock component, using CSS transitions instead of dojo animations.
Dice The next project

Projects

Add the game name, a link to repository 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 topic 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.

NON-GAME PROJECTS CODE LINK DEVELOPER COMMENT
Shared Code (not a game) https://github.com/elaskavaia/bga-sharedcode Victoria_La Examples of various game components and PHP stubs of framework code to make IDE happy
Vanilla Typescipt template (not a game) https://github.com/elaskavaia/bga-dojoless Victoria_La Project template for typescript and using minimal dojo, good for vscode - type checking, auto-complete, navigation
BoardGameArena Workbench (not a game) https://github.com/danielholmes/bga-workbench Daniel Holmes (dhau)
GAME CODE LINK DEVELOPER COMMENT
99 (Trick-taking Card Game) https://github.com/ekelly/bga-ninetynine QuasarDukeDev
Abandon All Artichokes https://github.com/0-wiz-0/bga-abandonallartichokes __wiz__, rojomojo
Assyria https://github.com/sebastien-prudhomme/bga-assyria daikinee
Aura https://github.com/micahstairs/bga-aura Micah Stairs (micahstairs)
Bandido https://github.com/opheliehb/BandidoBGA ophelopede & Harkle
The Battle for Hill 218 https://github.com/danielholmes/battle-for-hill-218 Daniel Holmes (dhau)
Bonbons https://github.com/AntonioSoler/bga-bonbons Morgalad
Canosa https://github.com/HalibutGitWiz/Canosa junibegood
Coinche https://github.com/drasill/bga-coinche Draasill
Coup: City State https://github.com/quietmint/bga-coupcitystate quietmint
Dice Summoners https://github.com/eoincos/bga-dicesummoners eoincos
Dungeon Roll https://github.com/MartinGoulet/bga-dungeonroll MGoulet
Egyptian Ratscrew https://github.com/0BuRner/bga-egyptianratscrew 0BuRner
Eruption https://github.com/AndyKerrison/bga-eruption Andy_K
A Fistful Of Gold https://bitbucket.org/Joel_L/fistfulofgold Brainchild
Florenza: The Card Game https://github.com/alberto-bottarini/bga-florenza tarini
For-Ex https://github.com/Fnordistan/forex AmadanNaBriona
Get the MacGuffin https://github.com/mizutismask/bga-get-the-MacGuffin mizutismask
Hardback https://github.com/quietmint/bga-hardback quietmint
Hearts (Tutorial) https://github.com/elaskavaia/bga-heartsla Victoria_La
Homesteaders https://github.com/npatron/bga-homesteaders TheBoot
Incan Gold https://github.com/AntonioSoler/bga-incangold Morgalad
Innovation https://github.com/micahstairs/bga-innovation Micah Stairs (micahstairs)
In the Year of the Dragon (10th Anniversary Edition) https://github.com/Fnordistan/ityotd AmadanNaBriona
Just Desserts https://github.com/mizutismask/bga-just-desserts mizutismask
The King's Guild https://github.com/AdamNovotny/BGG-KingsGuild A-dam
The Lady and the Tiger (Doors) https://github.com/Fnordistan/ladyandthetiger AmadanNaBriona
Mapmaker: The Gerrymandering Game https://github.com/gzhang01/bga-mapmaker gkz
Marco Polo https://github.com/rcitaliano/MarcoPolo rcitaliano
Nile https://github.com/AndyKerrison/bga-nile Andy_K
Noir: Killer vs Inspector https://bitbucket.org/chhuang76/bga_noirkvi ch huang
Penny Press https://github.com/AdamNovotny/bga-blooms A-dam
Perikles https://github.com/Fnordistan/perikles AmadanNaBriona
P.I. https://gitlab.com/fa81/bga-pi, https://github.com/hellp/bga-pi (mirror) Fabian Neumann (fa81)
President https://github.com/quaresma95/president quaresma95
Santorini https://github.com/AntonioSoler/bga-santorini Morgalad, quietmint, Tisaac
Tablut https://github.com/Lucas-C/tablut Lucas-C & ntaffore
Takara Island https://github.com/AntonioSoler/bga-takaraisland Morgalad
Taluva https://github.com/quietmint/bga-taluva Morgalad & quietmint
Teotihuacan: City of Gods https://github.com/Trompetenhut/bga-teotihuacan Trompetenhut
Texas 42 (domino game, still under development) https://github.com/ishermandom/bga-42 Stardust Spikes, Jason Turner-Maier, Ilya Sherman
Tic Tac Match https://github.com/leocaseiro/bga-tictacmatch Leo Caseiro
Trick of the Rails https://github.com/Fnordistan/trickoftherails AmadanNaBriona
Uptown https://github.com/elliotkendall/bga-uptown SpottedShroom
Via Magica https://github.com/christopherburke/bga_viamagica CuriousTerran

Projects on studio

Any developer can add themselves to a project as read-only from https://studio.boardgamearena.com/#!projects page (almost any project).

If it is not visible: a) it has no bgg id b) it is already published (use radio button to switch) c) it is an old game not developed on studio.

Other useful resources

Moved to Tools_and_tips_of_BGA_Studio

Retrieved from "http:///index.php?title=BGA_Code_Sharing&oldid=16277"