MCPcopy
hub / github.com/boardgameio/boardgame.io

github.com/boardgameio/boardgame.io @v0.50.2 sqlite

repository ↗ · DeepWiki ↗ · release v0.50.2 ↗
6,755 symbols 21,823 edges 209 files 102 documented · 2%
README

SWUbanner

boardgame.io

npm version Build Status Coverage Status Gitter

Support us: Open Collective GitHub Sponsors

Read the Documentation

boardgame.io is an engine for creating turn-based games using JavaScript.

Write simple functions that describe how the game state changes when a particular move is made. This is automatically converted into a playable game complete with online multiplayer features, all without requiring you to write a single line of networking or storage code.

Features

  • State Management: Game state is managed seamlessly across clients, server and storage automatically.
  • Multiplayer: Game state is kept in sync in realtime and across platforms.
  • AI: Automatically generated bots that can play your game.
  • Game Phases: with different game rules and turn orders per phase.
  • Lobby: Player matchmaking and game creation.
  • Prototyping: Interface to simulate moves even before you render the game.
  • Extendable: Plugin system that allows creating new abstractions.
  • View-layer Agnostic: Use the vanilla JS client or the bindings for React / React Native.
  • Logs: Game logs with the ability to time travel (viewing the board at an earlier state).

Usage

Installation

npm install boardgame.io

Documentation

Read our Full Documentation to learn how to use boardgame.io, and join the community on gitter to ask your questions!

Running examples in this repository

npm install
npm start

The examples can be found in the examples folder.

Using VS Code?

This repository is ready to run in a dev container in VS Code. See the contributing guidelines for details.

Changelog

See changelog.

Get involved

We welcome contributions of all kinds! Please take a moment to review our Code of Conduct.

🐛 Found a bug?
Let us know by creating an issue.

Have a question?
Our Gitter channel and GitHub Discussions are good places to start.

⚙️ Interested in fixing a bug or adding a feature?
Check out the contributing guidelines and the project roadmap.

📖 Can we improve our documentation?
Pull requests even for small changes can be helpful. Each page in the docs can be edited by clicking the “Edit on GitHub” link at the top right.

💸 Want to support the project financially?
We accept donations via GitHub Sponsors and on Open Collective.

License

MIT

Extension points exported contracts — how you extend this code

LogAPI (Interface)
(no doc) [8 implementers]
src/plugins/plugin-log.ts
GenericPubSub (Interface)
(no doc) [1 implementers]
src/server/transport/pubsub/generic-pub-sub.ts
State (Interface)
(no doc)
src/types.ts
DebugOpt (Interface)
(no doc)
src/client/client.ts
Matchers (Interface)
(no doc)
src/core/turn-order.test.ts
GameComponent (Interface)
(no doc)
src/lobby/connection.ts
Node (Interface)
(no doc)
src/ai/mcts-bot.ts
TransportAPI (Interface)
(no doc)
src/master/master.ts

Core symbols most depended-on inside this repo

m
called by 450
docs/documentation/snippets/phases-1.0d4500d6.js
set
called by 319
src/plugins/plugin-player.ts
d
called by 273
docs/documentation/snippets/phases-1.0d4500d6.js
get
called by 261
src/plugins/plugin-player.ts
n
called by 240
docs/documentation/snippets/multiplayer.54b541fd.js
n
called by 239
docs/documentation/snippets/example-3.1fa4f5db.js
n
called by 239
docs/documentation/snippets/example-2.e4675089.js
n
called by 238
docs/documentation/snippets/example-1.c952ec6d.js

Shape

Function 3,096
Method 2,632
Class 956
Interface 65
Enum 6

Languages

TypeScript99%
Python1%

Modules by API surface

docs/documentation/snippets/multiplayer.54b541fd.js898 symbols
docs/documentation/snippets/example-3.1fa4f5db.js898 symbols
docs/documentation/snippets/example-2.e4675089.js898 symbols
docs/documentation/snippets/example-1.c952ec6d.js898 symbols
docs/documentation/snippets/stages-1.1524ef02.js769 symbols
docs/documentation/snippets/phases-2.a59f38ac.js768 symbols
docs/documentation/snippets/phases-1.0d4500d6.js768 symbols
src/core/flow.ts32 symbols
src/server/transport/socketio-simultaneous.test.ts29 symbols
src/types.ts27 symbols
src/client/client.ts25 symbols
src/server/transport/socketio.test.ts21 symbols

Dependencies from manifests, versioned

@babel/cli7.16.0 · 1×
@babel/core7.16.0 · 1×
@babel/node7.16.0 · 1×
@babel/plugin-proposal-class-properties7.16.0 · 1×
@babel/plugin-proposal-object-rest-spread7.16.0 · 1×
@babel/plugin-transform-modules-commonjs7.16.0 · 1×
@babel/preset-env7.16.0 · 1×
@babel/preset-react7.16.0 · 1×
@babel/preset-typescript7.16.0 · 1×
@koa/cors3.1.0 · 1×
@koa/router10.1.1 · 1×

Datastores touched

(mongodb)Database · 1 repos

For agents

$ claude mcp add boardgame.io \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact